Show where each item starts in the inspiration and sync lists

Items in the inspiration list and the sync result columns now each have
their own background box, alternating between two shades, with a small
gap between them. When a long name wraps over several lines it is
still clear which lines belong together. The sync columns keep their
alternating white and orange text.

MainWindow.gd

@@ -446,12 +446,8 @@ func get_suggestion_list() -> void:
 			soundtracks = []
 			Settings.delete_children(inspiration_list)
 			soundtracks.append_array(array)
-			for soundtrack: String in soundtracks:
-				var inspiration_label: Label = Label.new()
-				inspiration_label.add_theme_font_size_override("font_size", 20)
-				inspiration_label.text = soundtrack
-				inspiration_label.autowrap_mode = TextServer.AUTOWRAP_WORD
-				inspiration_list.add_child(inspiration_label)
+			for i: int in soundtracks.size():
+				inspiration_list.add_child(ListRow.create(soundtracks[i], i, 20))
 		else:
 			print("Unexpected data")
 	MusicServerClient.fetch_all_soundtracks(populate_list)
@@ -572,7 +568,5 @@ func dir_contents(path: String) -> void:
 	else:
 		print("An error occurred when trying to access the path.")
 
-	for soundtrack: String in soundtracks:
-		var local_inspiration_label: Label = Label.new()
-		local_inspiration_label.text = soundtrack
-		inspiration_list.add_child(local_inspiration_label)
+	for i: int in soundtracks.size():
+		inspiration_list.add_child(ListRow.create(soundtracks[i], i, 20))

list_row.gd

@@ -0,0 +1,57 @@
+class_name ListRow
+extends PanelContainer
+## One item in a list of names, such as the inspiration list or a sync result column.
+##
+## Every row has its own background, alternating between two shades, so it is clear
+## where an item starts even when its text wraps over several lines.
+
+const EVEN_BACKGROUND: Color = Color(1, 1, 1, 0.05)
+const ODD_BACKGROUND: Color = Color(1, 1, 1, 0.11)
+
+static var _even_style: StyleBoxFlat
+static var _odd_style: StyleBoxFlat
+
+## The label showing the item's text.
+var label: Label
+
+## The item's text.
+var text: String:
+    get:
+        return label.text
+
+
+## Creates the row for item number [param row] (counting from 0) in a list.
+static func create(
+        item_text: String,
+        row: int,
+        font_size: int,
+        alignment: HorizontalAlignment = HORIZONTAL_ALIGNMENT_LEFT,
+) -> ListRow:
+    var list_row: ListRow = ListRow.new()
+    list_row.add_theme_stylebox_override("panel", _style(row % 2 != 0))
+    list_row.label = Label.new()
+    list_row.label.add_theme_font_size_override("font_size", font_size)
+    list_row.label.text = item_text
+    list_row.label.horizontal_alignment = alignment
+    list_row.label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
+    list_row.add_child(list_row.label)
+    return list_row
+
+
+# Rows share two styles instead of each creating its own
+static func _style(odd: bool) -> StyleBoxFlat:
+    if _even_style == null:
+        _even_style = _make_style(EVEN_BACKGROUND)
+        _odd_style = _make_style(ODD_BACKGROUND)
+    return _odd_style if odd else _even_style
+
+
+static func _make_style(background: Color) -> StyleBoxFlat:
+    var style: StyleBoxFlat = StyleBoxFlat.new()
+    style.bg_color = background
+    style.set_corner_radius_all(4)
+    style.content_margin_left = 8
+    style.content_margin_right = 8
+    style.content_margin_top = 2
+    style.content_margin_bottom = 2
+    return style

list_row.gd.uid

@@ -0,0 +1 @@
+uid://c2o2qunso5n8l

sync_window.gd

@@ -126,10 +126,9 @@ func on_sync_finished(data_received: Dictionary) -> void:
 		make_header_label(soundtracks_changed_title_vbox, "Changed Title")
 		var row: int = 0
 		for old_soundtrack_title: String in data_received.soundtracks_changed_title:
-			var label: Label = make_soundtrack_label(old_soundtrack_title + "\nchanged title to\n" + data_received.soundtracks_changed_title[old_soundtrack_title])
-			if row % 2 != 0:
-				label.add_theme_color_override("font_color", Color(1, 0.5, 0))
-			soundtracks_changed_title_vbox.add_child(label)
+			var new_soundtrack_title: String = data_received.soundtracks_changed_title[old_soundtrack_title]
+			soundtracks_changed_title_vbox.add_child(make_soundtrack_row(
+					old_soundtrack_title + "\nchanged title to\n" + new_soundtrack_title, row))
 			row += 1
 		soundtracks_changed_title_vbox.visible = true
 	
@@ -194,13 +193,12 @@ func make_header_label(vbox: VBoxContainer, text: String) -> void:
 	label.text = text
 	vbox.add_child(label)
 
-func make_soundtrack_label(text: String) -> Label:
-	var label: Label = Label.new()
-	label.add_theme_font_size_override("font_size", 18)
-	label.text = text
-	label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
-	label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
-	return label
+# Items alternate between white and orange text as well as background shade
+func make_soundtrack_row(text: String, row: int) -> ListRow:
+	var list_row: ListRow = ListRow.create(text, row, 18, HORIZONTAL_ALIGNMENT_CENTER)
+	if row % 2 != 0:
+		list_row.label.add_theme_color_override("font_color", Color(1, 0.5, 0))
+	return list_row
 
 func reset_sync_result() -> void:
 	sync_progress_bar.value = 0
@@ -222,13 +220,8 @@ func reset_sync_result() -> void:
 func make_list(list: Array, vbox: VBoxContainer, text: String) -> void:
 	Settings.delete_children(vbox)
 	make_header_label(vbox, text)
-	var row: int = 0
-	for soundtrack: String in list:
-		var label: Label = make_soundtrack_label(soundtrack)
-		if row % 2 != 0:
-			label.add_theme_color_override("font_color", Color(1, 0.5, 0))
-		vbox.add_child(label)
-		row += 1
+	for row: int in list.size():
+		vbox.add_child(make_soundtrack_row(list[row], row))
 
 func show_sync_result() -> void:
 	sync_title_label.text = "Sync Result"

tests/integration/test_main_window.gd

@@ -240,3 +240,12 @@ func test_log_adds_one_row_per_point_with_padded_time() -> void:
     var time_pattern: RegEx = RegEx.create_from_string("^\\d\\d:\\d\\d:\\d\\d Crono got a point$")
     assert_object(time_pattern.search((log_box.get_child(0) as Label).text)).is_not_null()
     assert_str((log_box.get_child(1) as Label).text).ends_with("Crono lost a point")
+
+
+func test_inspiration_list_alternates_row_backgrounds() -> void:
+    var rows: Array[Node] = _window.get_node("ScrollContainer/VBoxContainer").get_children()
+
+    assert_int(rows.size()).is_equal(2)
+    assert_str((rows[0] as ListRow).text).is_equal("Chrono Trigger")
+    assert_that((rows[0] as ListRow).get_theme_stylebox("panel")) \
+            .is_not_equal((rows[1] as ListRow).get_theme_stylebox("panel"))

tests/integration/test_sync_window.gd

@@ -113,7 +113,7 @@ func test_changed_titles_list_old_and_new_title() -> void:
 
     var vbox: Control = _node("SoundtracksChangedTitleVBox")
     assert_bool(vbox.visible).is_true()
-    assert_str((vbox.get_child(1) as Label).text).is_equal(
+    assert_str((vbox.get_child(1) as ListRow).text).is_equal(
             "FF7\nchanged title to\nFinal Fantasy VII")
 
 

tests/unit/test_list_row.gd

@@ -0,0 +1,26 @@
+extends GdUnitTestSuite
+
+
+func _background(list_row: ListRow) -> Color:
+    return (list_row.get_theme_stylebox("panel") as StyleBoxFlat).bg_color
+
+
+func test_row_shows_text() -> void:
+    var list_row: ListRow = auto_free(ListRow.create("Chrono Trigger", 0, 20))
+
+    assert_str(list_row.text).is_equal("Chrono Trigger")
+
+
+func test_neighbouring_rows_have_different_backgrounds() -> void:
+    var first: ListRow = auto_free(ListRow.create("Chrono Trigger", 0, 20))
+    var second: ListRow = auto_free(ListRow.create("Chrono Cross", 1, 20))
+    var third: ListRow = auto_free(ListRow.create("Xenogears", 2, 20))
+
+    assert_that(_background(first)).is_not_equal(_background(second))
+    assert_that(_background(first)).is_equal(_background(third))
+
+
+func test_long_text_wraps() -> void:
+    var list_row: ListRow = auto_free(ListRow.create("Castlevania: Symphony of the Night", 0, 20))
+
+    assert_int(list_row.label.autowrap_mode).is_equal(TextServer.AUTOWRAP_WORD_SMART)

tests/unit/test_list_row.gd.uid

@@ -0,0 +1 @@
+uid://bouligcywd5se