#108835Sorting option dropdown in the file list not labeled reliably
Description
Description
In the TYPO3 backend filelist, the sorting icon in the column header (e.g. column “Name”) is currently labelled only by the visible column title “Name”. For screen reader users, it is therefore not clear that this icon / button is an interactive control for sorting. The function of the graphical element (sorting / opening sorting options) is not clearly exposed programmatically.
Reproduction steps
- Open the TYPO3 backend and navigate to the Filelist.
- In the filelist, locate the column header “Name” (or another sortable column) that contains the sorting icon.
- Inspect the sorting icon or its associated button/link using the browser DevTools.
- Check how the accessible name is implemented:
- There is no explicit accessible name that describes the sorting function (e.g. no aria-label like “Sorting: open options”).
- The label effectively comes only from the column title “Name”.
- Test with a screen reader (e.g. NVDA, JAWS, VoiceOver) how the element is announced and whether it is clearly conveyed as a sorting control.
Impact
- Screen reader users cannot reliably recognize the sorting icon as a sorting control and may perceive it only as a column header.
- The function “Sorting: open/change options” is not clearly communicated, which can lead to uncertainty or non-use of the sorting feature.
- The usability and accessibility of the filelist are reduced for users relying on assistive technologies.
Target group
- Screen reader users
- Users with visual impairments or blindness
- TYPO3 backend editors relying on assistive technologies
Severity
Medium (an important interaction option in the filelist is not clearly exposed as a control for screen reader users).
Frequency
Occurs for every sortable column header in the filelist (100 % of the affected columns).
Definition of Done
- The sorting icon and its associated button/link in the filelist column header have a clear, programmatically determinable accessible name that describes the sorting function (e.g. “Sorting: open options”).
- Screen readers announce the element as a control with a sorting function, not just as a plain column header.
- Manual tests with at least one screen reader (e.g. NVDA, JAWS, VoiceOver) have been performed and confirm that purpose and function of the control are understandable.
- The visual appearance (icon, “Name” text, hover and focus styles) remains unchanged.
Suggestion
Add a clear accessible name to the button/link of the sorting icon, for example using aria-label=“Sortierung: Optionen öffnen” or in English aria-label=“Sorting: open options”.
Recommended solution
Add a descriptive aria-label to the interactive element (button or link) controlling the sorting icon in the filelist, for example:
Optionally, adapt the aria-label dynamically to reflect different sort states (e.g. “Sort ascending by name” / “Sort descending by name”).
Ensure that the visible text “Name” remains correctly exposed as the column header and that the aria-label is used solely to describe the interactive sorting function.
References / WCAG 2.2 Reference
- WCAG 2.2 – 2.5.3 Label in Name: The accessible name should reflect the purpose and function of the control (e.g. “Sorting: open options”).
- WCAG 2.2 – 4.1.2 Name, Role, Value: Interactive elements require a programmatically determinable name that clearly describes their function.
- WCAG 2.2 – 1.3.1 Info and Relationships: Relationships and functions of controls (e.g. sorting a column) must be programmatically determinable.
Reviews 0
No change resolves or names this issue in its commit message, and no comment links one.
Fix this issue
Start the commit message of your patch with this. Add what the patch does, and the versions it goes to in "Releases:". How to create a patch
- Commit message
-
[BUGFIX] Sorting option dropdown in the file list not labeled reliably Resolves: #108835 Releases: main