From 6e228dc06a041e646730ca1bfce1634707d4fe4e Mon Sep 17 00:00:00 2001
From: Henriette Darge <h.darge@openproject.com>
Date: Thu, 19 Feb 2026 15:54:35 +0100
Subject: [PATCH] Fine-tune the shown forms of custom fields & fix tests

---
 .../custom_fields/details_component.rb        |  8 +++++--
 app/forms/custom_fields/details_form.rb       |  6 +++---
 .../project_custom_fields/list_items.html.erb |  6 +++---
 .../custom_fields/_custom_options.html.erb    | 10 ++++-----
 app/views/custom_fields/list_items.html.erb   |  6 +++---
 .../custom_fields/projects/boolean_spec.rb    |  4 +---
 .../projects/create_in_section_spec.rb        |  2 +-
 .../custom_fields/projects/shared_context.rb  | 12 +----------
 .../shared_custom_field_expectations.rb       | 21 ++++++++-----------
 .../custom_fields/time_entries/list_spec.rb   | 12 +++++++----
 .../custom_fields/work_packages/list_spec.rb  |  9 ++++----
 .../work_packages/multi_value_list_spec.rb    |  9 +++++---
 .../custom_fields/reorder_options_spec.rb     |  4 ++++
 spec/models/custom_field_spec.rb              | 11 ----------
 spec/support/pages/custom_fields/index.rb     |  2 +-
 15 files changed, 56 insertions(+), 66 deletions(-)

diff --git a/app/components/custom_fields/details_component.rb b/app/components/custom_fields/details_component.rb
index 31b51f12b82..e2d4f0272ee 100644
--- a/app/components/custom_fields/details_component.rb
+++ b/app/components/custom_fields/details_component.rb
@@ -84,8 +84,12 @@ module CustomFields
     end
 
     def persisted_cf_has_no_items_or_projects?
-      if custom_field.list? && custom_field.custom_options.empty? && custom_field.projects.empty?
-        return true
+      if custom_field.list? && custom_field.custom_options.empty?
+        if custom_field.respond_to?(:projects)
+          custom_field.projects.empty?
+        end
+
+        true
       end
 
       custom_field.persisted? &&
diff --git a/app/forms/custom_fields/details_form.rb b/app/forms/custom_fields/details_form.rb
index 57d4f747f26..eb37d53f2ee 100644
--- a/app/forms/custom_fields/details_form.rb
+++ b/app/forms/custom_fields/details_form.rb
@@ -82,7 +82,6 @@ module CustomFields
         details_form.text_field(
           name: :regexp,
           label: label(:regexp),
-          size: 50,
           caption: instructions(:regexp),
           input_width: :medium
         )
@@ -238,7 +237,7 @@ module CustomFields
     end
 
     def show_right_to_left_field?
-      %w[text].include?(model.field_format)
+      model.is_a?(WorkPackageCustomField) && %w[text].include?(model.field_format)
     end
 
     def show_multi_value_field?
@@ -258,7 +257,8 @@ module CustomFields
     end
 
     def show_is_searchable_field?
-      %w[bool date float int user version hierarchy weighted_item_list calculated_value].exclude?(model.field_format)
+      (model.is_a?(WorkPackageCustomField) || model.is_a?(ProjectCustomField)) &&
+        %w[bool date float int user version hierarchy weighted_item_list calculated_value].exclude?(model.field_format)
     end
 
     def show_non_open_versions_field?
diff --git a/app/views/admin/settings/project_custom_fields/list_items.html.erb b/app/views/admin/settings/project_custom_fields/list_items.html.erb
index f0adfc60203..6247d928387 100644
--- a/app/views/admin/settings/project_custom_fields/list_items.html.erb
+++ b/app/views/admin/settings/project_custom_fields/list_items.html.erb
@@ -65,10 +65,10 @@ See COPYRIGHT and LICENSE files for more details.
       flex.with_column do
         render Primer::Beta::Button.new(
           scheme: :primary,
-          type: :submit,
-          ) do |button|
+          type: :submit
+        ) do |button|
           button.with_leading_visual_icon(icon: :check)
-          t(:button_submit)
+          t(:button_save)
         end
       end
     end
diff --git a/app/views/custom_fields/_custom_options.html.erb b/app/views/custom_fields/_custom_options.html.erb
index b122d871e5a..fa89235fbe6 100644
--- a/app/views/custom_fields/_custom_options.html.erb
+++ b/app/views/custom_fields/_custom_options.html.erb
@@ -93,7 +93,7 @@ See COPYRIGHT and LICENSE files for more details.
                                     no_label: true %>
               </span>
             </td>
-            <td>
+            <td class="custom-option-default-value">
               <%= co_f.check_box :default_value,
                                  container_class: "custom-option-default-value",
                                  data: {
@@ -105,7 +105,7 @@ See COPYRIGHT and LICENSE files for more details.
             <td>
                 <span class="reorder-icons">
                   <a
-                    title="<%= t(:label_sort_highest) %>"
+                    aria-label="<%= t(:label_sort_highest) %>"
                     rel="nofollow"
                     href="#"
                     class="sort-up-custom-option"
@@ -113,7 +113,7 @@ See COPYRIGHT and LICENSE files for more details.
                     <%= op_icon("icon-context icon-sort-up icon-small") %>
                   </a>
                   <a
-                    title="<%= t(:label_sort_higher) %>"
+                    aria-label="<%= t(:label_sort_higher) %>"
                     rel="nofollow"
                     href="#"
                     class="move-up-custom-option"
@@ -121,14 +121,14 @@ See COPYRIGHT and LICENSE files for more details.
                     <%= op_icon("icon-context icon-arrow-up2 icon-small") %>
                   </a>
                   <a
-                    title="<%= t(:label_sort_lower) %>"
+                    aria-label="<%= t(:label_sort_lower) %>"
                     rel="nofollow" href="#"
                     class="move-down-custom-option"
                     data-action="admin--custom-fields#moveRowDown">
                     <%= op_icon("icon-context icon-arrow-down2 icon-small") %>
                   </a>
                   <a
-                    title="<%= t(:label_sort_lowest) %>"
+                    aria-label="<%= t(:label_sort_lowest) %>"
                     rel="nofollow"
                     href="#"
                     class="sort-down-custom-option"
diff --git a/app/views/custom_fields/list_items.html.erb b/app/views/custom_fields/list_items.html.erb
index b284ab04ed0..14c831b6eb0 100644
--- a/app/views/custom_fields/list_items.html.erb
+++ b/app/views/custom_fields/list_items.html.erb
@@ -58,10 +58,10 @@ See COPYRIGHT and LICENSE files for more details.
       flex.with_column do
         render Primer::Beta::Button.new(
           scheme: :primary,
-          type: :submit,
-          ) do |button|
+          type: :submit
+        ) do |button|
           button.with_leading_visual_icon(icon: :check)
-          t(:button_submit)
+          t(:button_save)
         end
       end
     end
diff --git a/spec/features/admin/custom_fields/projects/boolean_spec.rb b/spec/features/admin/custom_fields/projects/boolean_spec.rb
index 4924a648510..c288d945e64 100644
--- a/spec/features/admin/custom_fields/projects/boolean_spec.rb
+++ b/spec/features/admin/custom_fields/projects/boolean_spec.rb
@@ -41,7 +41,5 @@ RSpec.describe "Edit project custom fields", :js do
   it_behaves_like "shows checkboxes for configuration" do
     let(:required_supported) { false }
   end
-  it_behaves_like "editing the field" do
-    let(:using_primer) { true }
-  end
+  it_behaves_like "editing the field"
 end
diff --git a/spec/features/admin/custom_fields/projects/create_in_section_spec.rb b/spec/features/admin/custom_fields/projects/create_in_section_spec.rb
index 37986d35042..0662dcf6c85 100644
--- a/spec/features/admin/custom_fields/projects/create_in_section_spec.rb
+++ b/spec/features/admin/custom_fields/projects/create_in_section_spec.rb
@@ -108,7 +108,7 @@ RSpec.describe "Create project custom fields in sections", :js do
       it "prevents creating a new project custom field with an empty name" do
         click_on("Save")
 
-        expect(page).to have_field "custom_field_name", validation_message: /Please fill (in|out) this field./
+        expect(page).to have_field("custom_field_name", with: "", validation_error: "Name can't be blank")
 
         # expect no redirect
         expect(page).to have_no_current_path(admin_settings_project_custom_fields_path(tab: "ProjectCustomField"))
diff --git a/spec/features/admin/custom_fields/projects/shared_context.rb b/spec/features/admin/custom_fields/projects/shared_context.rb
index e4033565791..d4b4d37bc8b 100644
--- a/spec/features/admin/custom_fields/projects/shared_context.rb
+++ b/spec/features/admin/custom_fields/projects/shared_context.rb
@@ -232,12 +232,6 @@ end
 RSpec.shared_examples "editing the field" do
   current_user { admin }
 
-  let(:using_primer) do
-    super()
-  rescue NoMethodError
-    false
-  end
-
   before do
     visit edit_admin_settings_project_custom_field_path(custom_field)
   end
@@ -272,11 +266,7 @@ RSpec.shared_examples "editing the field" do
     fill_in("Name", with: "")
     click_on("Save")
 
-    if using_primer
-      expect(page).to have_css(".FormControl-inlineValidation", text: "Name can't be blank")
-    else
-      expect(page).to have_field "Name", validation_message: /Please fill (in|out) this field./
-    end
+    expect(page).to have_field("custom_field_name", with: "", validation_error: "Name can't be blank")
 
     expect(page).to have_no_text("Successful update")
 
diff --git a/spec/features/admin/custom_fields/shared_custom_field_expectations.rb b/spec/features/admin/custom_fields/shared_custom_field_expectations.rb
index 0a818213bc0..6ea6b8db63c 100644
--- a/spec/features/admin/custom_fields/shared_custom_field_expectations.rb
+++ b/spec/features/admin/custom_fields/shared_custom_field_expectations.rb
@@ -46,7 +46,14 @@ RSpec.shared_examples_for "list custom fields" do |type|
     cf_page.set_name "Operating System"
 
     expect(page).to have_text("Allow multi-select")
-    check("custom_field_multi_value")
+    check("multi_value")
+
+    click_on "Save"
+    cf_page.expect_and_dismiss_flash(message: "Successful creation.")
+    expect(page).to have_field("multi_value", checked: true)
+
+    click_link "Items"
+    wait_for_network_idle
 
     expect(page).to have_css(".custom-option-row", count: 1)
     within all(".custom-option-row").last do
@@ -73,15 +80,11 @@ RSpec.shared_examples_for "list custom fields" do |type|
     within all(".custom-option-row").last do
       find(".custom-option-value input").set "Solaris"
 
-      click_on "Move to top"
+      click_link accessible_name: "Move to top"
     end
 
     click_on "Save"
 
-    expect(page).to have_text("Successful creation")
-
-    expect(page).to have_field("custom_field_multi_value", checked: true)
-
     expect(page).to have_css(".custom-option-row", count: 3)
     expect(page).to have_field("custom_field_custom_options_attributes_0_value", with: "Solaris")
     expect(page).to have_field("custom_field_custom_options_attributes_1_value", with: "Windows")
@@ -271,11 +274,5 @@ RSpec.shared_examples_for "expected fields for the custom field's format", :aggr
     else
       expect(page).to have_no_label(label_allow_non_open_versions)
     end
-
-    if format == "List"
-      expect(page).to have_fieldset(label_possible_values)
-    else
-      expect(page).to have_no_fieldset(label_possible_values)
-    end
   end
 end
diff --git a/spec/features/admin/custom_fields/time_entries/list_spec.rb b/spec/features/admin/custom_fields/time_entries/list_spec.rb
index f62fbbad607..aa5aff65ed9 100644
--- a/spec/features/admin/custom_fields/time_entries/list_spec.rb
+++ b/spec/features/admin/custom_fields/time_entries/list_spec.rb
@@ -50,12 +50,17 @@ RSpec.describe "List custom fields edit", :js do
 
     fill_in "custom_field_name", with: "My List CF"
 
+    click_on "Save"
+
+    index_cf_page.expect_and_dismiss_flash(message: "Successful creation.")
+
+    click_link "Items"
+
     expect(page).to have_field("custom_field_custom_options_attributes_0_value")
     fill_in "custom_field_custom_options_attributes_0_value", with: "A"
 
     click_on "Save"
-
-    index_cf_page.expect_and_dismiss_flash(message: "Successful creation.")
+    wait_for_network_idle
 
     # Expect correct values
     cf = CustomField.last
@@ -63,12 +68,11 @@ RSpec.describe "List custom fields edit", :js do
     expect(cf.possible_values.map(&:value)).to eq %w(A)
 
     # Edit again
-    find("a", text: "My List CF").click
-
     expect(page).to have_field("custom_field_custom_options_attributes_0_value")
     fill_in "custom_field_custom_options_attributes_0_value", with: "B"
 
     click_on "Save"
+    wait_for_network_idle
 
     index_cf_page.expect_and_dismiss_flash(message: "Successful update.")
 
diff --git a/spec/features/admin/custom_fields/work_packages/list_spec.rb b/spec/features/admin/custom_fields/work_packages/list_spec.rb
index aeced2d50b0..ba70aadd1ed 100644
--- a/spec/features/admin/custom_fields/work_packages/list_spec.rb
+++ b/spec/features/admin/custom_fields/work_packages/list_spec.rb
@@ -53,6 +53,9 @@ RSpec.describe "work package list custom fields", :js do
 
       click_on custom_field.name
       wait_for_reload
+
+      click_link "Items"
+      wait_for_reload
     end
 
     it "adds new options" do
@@ -97,17 +100,15 @@ RSpec.describe "work package list custom fields", :js do
 
       fill_in("custom_field_custom_options_attributes_1_value", with: "")
       fill_in("custom_field_custom_options_attributes_1_value", with: "Sega")
-      check("custom_field_multi_value")
       check("custom_field_custom_options_attributes_0_default_value")
       check("custom_field_custom_options_attributes_2_default_value")
       within first(".custom-option-row") do
-        click_on "Move to bottom"
+        click_link accessible_name: "Move to bottom"
       end
       click_on "Save"
 
       expect(page).to have_text("Successful update")
       expect(page).to have_text("Platform")
-      expect(page).to have_field("custom_field_multi_value", checked: true)
 
       %w[Sega Nintendo PC Playstation].each_with_index do |value, i|
         expect(page).to have_field("custom_field_custom_options_attributes_#{i}_value", with: value)
@@ -116,7 +117,7 @@ RSpec.describe "work package list custom fields", :js do
       expect(page).to have_field("custom_field_custom_options_attributes_0_default_value", checked: false)
       expect(page).to have_field("custom_field_custom_options_attributes_1_default_value", checked: true)
       expect(page).to have_field("custom_field_custom_options_attributes_2_default_value", checked: false)
-      expect(page).to have_field("custom_field_custom_options_attributes_3_default_value", checked: true)
+      expect(page).to have_field("custom_field_custom_options_attributes_3_default_value", checked: false)
     end
 
     it "shows the correct breadcrumbs" do
diff --git a/spec/features/admin/custom_fields/work_packages/multi_value_list_spec.rb b/spec/features/admin/custom_fields/work_packages/multi_value_list_spec.rb
index 678b6bace72..122a259b600 100644
--- a/spec/features/admin/custom_fields/work_packages/multi_value_list_spec.rb
+++ b/spec/features/admin/custom_fields/work_packages/multi_value_list_spec.rb
@@ -48,6 +48,12 @@ RSpec.describe "Multi-value custom fields creation", :js, :selenium do
     SeleniumHubWaiter.wait
     fill_in "custom_field_name", with: "My List CF"
 
+    click_on "Save"
+    index_cf_page.expect_and_dismiss_flash(message: "Successful creation.")
+
+    click_link "Items"
+    wait_for_network_idle
+
     expect(page).to have_css("input#custom_field_custom_options_attributes_0_value")
     fill_in "custom_field_custom_options_attributes_0_value", with: "A"
 
@@ -65,11 +71,8 @@ RSpec.describe "Multi-value custom fields creation", :js, :selenium do
 
     click_on "Save"
 
-    index_cf_page.expect_and_dismiss_flash(message: "Successful creation.")
-
     # Edit again
     SeleniumHubWaiter.wait
-    page.find("a", text: "My List CF").click
     expect(page).to have_css("input#custom_field_custom_options_attributes_0_value[value=A]")
     expect(page).to have_css("input#custom_field_custom_options_attributes_1_value[value=B]")
     expect(page).to have_css("input#custom_field_custom_options_attributes_2_value[value=C]")
diff --git a/spec/features/custom_fields/reorder_options_spec.rb b/spec/features/custom_fields/reorder_options_spec.rb
index cad5e31000a..8b4ad8ccb75 100644
--- a/spec/features/custom_fields/reorder_options_spec.rb
+++ b/spec/features/custom_fields/reorder_options_spec.rb
@@ -37,6 +37,10 @@ RSpec.describe "Reordering custom options of a list custom field", :js, :seleniu
     cf_page.visit!
     click_link custom_field.name
 
+    wait_for_network_idle
+    click_link "Items"
+    wait_for_network_idle
+
     click_link "Reorder values alphabetically"
     cf_page.accept_alert_dialog!
     expect_flash(message: I18n.t(:notice_successful_update))
diff --git a/spec/models/custom_field_spec.rb b/spec/models/custom_field_spec.rb
index 40f5b15b57b..32b7966708e 100644
--- a/spec/models/custom_field_spec.rb
+++ b/spec/models/custom_field_spec.rb
@@ -153,17 +153,6 @@ RSpec.describe CustomField do
       end
     end
 
-    describe "WITH a list field WITHOUT a custom option" do
-      before do
-        field.field_format = "list"
-      end
-
-      it "is not valid" do
-        expect(field)
-          .not_to be_valid
-      end
-    end
-
     describe "WITH a list field WITH a custom option" do
       before do
         field.field_format = "list"
diff --git a/spec/support/pages/custom_fields/index.rb b/spec/support/pages/custom_fields/index.rb
index 118e8df099e..19baafd47e8 100644
--- a/spec/support/pages/custom_fields/index.rb
+++ b/spec/support/pages/custom_fields/index.rb
@@ -53,7 +53,7 @@ module Pages
       end
 
       def set_all_projects(value)
-        find_by_id("custom_field_is_for_all").set value
+        find_by_id("is_for_all").set value
       end
 
       def has_form_element?(name)