Fix #6135: board/list/swimlane numbering broke first-letter keyboard nav

The move/copy card popups prefixed a number to each option (e.g. '3. Board'),
which broke jumping to an entry by typing its first letter and made digit-named
boards confusing. Remove the numeric prefix so options start with their name
again. Pure boardOptionLabel helper added (numbering off by default) with tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Lauri OjansivuandClaude Opus 4.8 committed 2026-06-20 14:39:02 +03:00
1 parent a8ed326a5b
commit fe4d2a56f2
3 files changed
+123 -16

No files matched your search

@@ -0,0 +1,42 @@
/**
* Pure helpers for building the option labels shown in board / list /
* swimlane selectors (e.g. the move-card and copy-card popups).
*
* Regression #6135 ("numbering boards, list, swim caused some issues"):
* a previous change prepended a sequential number to every option label
* (e.g. "3. My Board"). That broke two things:
*
* 1. Boards whose name itself starts with a digit became hard to read.
* 2. First-letter keyboard navigation in the native <select> dropdown
* stopped working, because every option started with a number instead
* of the board name.
*
* The fix: numbering is OPTIONAL and OFF by default. By default the label is
* exactly the entity name, so its first character is the name's first
* character and first-letter navigation works again. When numbering is
* explicitly enabled, the number is appended as a trailing visual suffix so
* the label still STARTS with the name.
*/
/**
* Build the label for a selectable board/list/swimlane option.
*
* @param {string} name The entity (board/list/swimlane) name/title.
* @param {number} index Zero-based position in the list.
* @param {Object} [opts]
* @param {boolean} [opts.numbered=false] When true, append the 1-based
* number as a trailing suffix. When false (default), return the bare
* name so first-letter keyboard navigation keeps working.
* @returns {string} The option label.
*/
export function boardOptionLabel(name, index, { numbered = false } = {}) {
const label = name == null ? '' : String(name);
if (!numbered) {
return label;
}
const position = Number(index);
const number = Number.isFinite(position) ? position + 1 : index;
return `${label} (${number})`;
}
export default boardOptionLabel;
+16 -16
View File
@@ -948,22 +948,22 @@ template(name="moveCardPopup")
label {{_ 'boards'}}:
select.js-select-boards(autofocus)
each boards
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{title}}
label {{_ 'swimlanes'}}:
select.js-select-swimlanes
each swimlanes
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{add @index 1}}. {{isTitleDefault title}}
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{isTitleDefault title}}
label {{_ 'lists'}}:
select.js-select-lists
each lists
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{title}}
label {{_ 'cards'}}:
select.js-select-cards
each cards
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{title}}
div
input(type="radio" name="position" value="above" checked id="position-above" style="display: inline")
@@ -983,22 +983,22 @@ template(name="copyCardPopup")
label {{_ 'boards'}}:
select.js-select-boards(autofocus)
each boards
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{title}}
label {{_ 'swimlanes'}}:
select.js-select-swimlanes
each swimlanes
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{add @index 1}}. {{isTitleDefault title}}
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{isTitleDefault title}}
label {{_ 'lists'}}:
select.js-select-lists
each lists
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{title}}
label {{_ 'cards'}}:
select.js-select-cards
each cards
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{title}}
div
input(type="radio" name="position" value="above" checked id="position-above" style="display: inline")
@@ -1018,22 +1018,22 @@ template(name="copyManyCardsPopup")
label {{_ 'boards'}}:
select.js-select-boards(autofocus)
each boards
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{title}}
label {{_ 'swimlanes'}}:
select.js-select-swimlanes
each swimlanes
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{add @index 1}}. {{isTitleDefault title}}
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{isTitleDefault title}}
label {{_ 'lists'}}:
select.js-select-lists
each lists
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{title}}
label {{_ 'cards'}}:
select.js-select-cards
each cards
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{title}}
div
input(type="radio" name="position" value="above" checked id="position-above" style="display: inline")
@@ -1053,22 +1053,22 @@ template(name="convertChecklistItemToCardPopup")
label {{_ 'boards'}}:
select.js-select-boards(autofocus)
each boards
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedBoardId _id}}selected{{/if}}") {{title}}
label {{_ 'swimlanes'}}:
select.js-select-swimlanes
each swimlanes
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{add @index 1}}. {{isTitleDefault title}}
option(value="{{_id}}" selected="{{#if isSelectedSwimlaneId _id}}selected{{/if}}") {{isTitleDefault title}}
label {{_ 'lists'}}:
select.js-select-lists
each lists
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isSelectedListId _id}}selected{{/if}}") {{title}}
label {{_ 'cards'}}:
select.js-select-cards
each cards
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{add @index 1}}. {{title}}
option(value="{{_id}}" selected="{{#if isDialogOptionCardId _id}}selected{{/if}}") {{title}}
div
input(type="radio" name="position" value="above" checked id="position-above" style="display: inline")
+65
View File
@@ -0,0 +1,65 @@
/* eslint-env mocha */
import { expect } from 'chai';
import { boardOptionLabel } from '/client/components/boards/boardLabelHelpers';
/**
* Unit tests for board/list/swimlane option label building.
*
* Regression #6135: numbering prepended to option labels broke first-letter
* keyboard navigation and readability of boards whose name starts with a
* number. Numbering must be OFF by default and, when enabled, must not be a
* prefix.
*/
describe('boardOptionLabel (#6135)', function() {
describe('default (numbering off)', function() {
it('returns the name unchanged', function() {
expect(boardOptionLabel('My Board', 0)).to.equal('My Board');
expect(boardOptionLabel('My Board', 4)).to.equal('My Board');
});
it('keeps first-letter navigation: label starts with the name', function() {
const name = 'Zebra';
const label = boardOptionLabel(name, 7);
expect(label.charAt(0)).to.equal(name.charAt(0));
expect(label.indexOf(name)).to.equal(0);
});
it('does not prepend a number to names that start with a digit', function() {
const name = '2024 Roadmap';
const label = boardOptionLabel(name, 2);
expect(label).to.equal(name);
expect(label.charAt(0)).to.equal('2');
});
it('treats an explicit numbered:false the same as the default', function() {
expect(boardOptionLabel('Alpha', 3, { numbered: false })).to.equal('Alpha');
});
it('handles empty / nullish names safely', function() {
expect(boardOptionLabel('', 0)).to.equal('');
expect(boardOptionLabel(null, 0)).to.equal('');
expect(boardOptionLabel(undefined, 0)).to.equal('');
});
});
describe('numbering on', function() {
it('still STARTS with the name (number is a suffix, not a prefix)', function() {
const name = 'Projects';
const label = boardOptionLabel(name, 0, { numbered: true });
expect(label.indexOf(name)).to.equal(0);
expect(label.charAt(0)).to.equal(name.charAt(0));
});
it('appends the 1-based position', function() {
expect(boardOptionLabel('Projects', 0, { numbered: true })).to.equal('Projects (1)');
expect(boardOptionLabel('Projects', 4, { numbered: true })).to.equal('Projects (5)');
});
it('preserves first-letter navigation even for digit-named boards', function() {
const name = '2024 Roadmap';
const label = boardOptionLabel(name, 1, { numbered: true });
expect(label.charAt(0)).to.equal('2');
expect(label.indexOf(name)).to.equal(0);
});
});
});