#108445Modal dialog box – Close button not explicitly labeled
Description
Description
The X button in modal dialog boxes are only labeled “Close.” This is not meaningful enough, as it is not clear what is being closed.
Reproduction steps
1. Create a “Text&Media” content element on any page.
2. Switch to the “Images” tab in the editing mask.
3. Click on the “Add image” button.
4. The “file selector” module opens. The close icon for closing the module is located in the upper right corner of the module.
file_selector_close_dialog.png
Impact
Users who rely on screen readers
Target group
blind users
Severity
high
Frequency
common
Definition of Done
The dialog has an accessible name. The screen reader reads the button aloud in a way that is understandable to blind people, so that blind people always know where they are in the dialog and what to do.
Recommended solution
1. The heading should be the accessible name of the dialog.2. The accessible name of the close button should simply be “Close.” The context is provided by the accessible name of the dialog.
Reviews 0
No change resolves or names this issue in its commit message, and no comment links one.
Files 1
History 2
-
Garvin Hicking changed category <span data-processor="relativetime" data-value="2025-12-09T15:46:45+00:00" > 12/09/25, 15:46 </span>
-
Oliver Bartsch commented and changed status
NewClosed <span data-processor="relativetime" data-value="2026-11-05T15:15:15+00:00" > 11/05/26, 15:15 </span>
Hey,
thanks for the detailed report and the accessibility tree screenshot.
The screenshot is from TYPO3 13.4.20, which still uses the old Bootstrap-based modal. There the dialog has no accessible name (the
dialog ""in your screenshot), and the close button reads “SchließenDateiauswahl” because of a missing space. The space was fixed in #108899 for main and 13.4.In TYPO3 v14 the modal was rewritten to use a native
<dialog>element (#107443). That dialog now references the modal title viaaria-labelledby, or usesaria-labelwith the title if the header is hidden. So v14 already does what you suggest in point 1: the dialog takes its accessible name from its title.I’ll keep the close button label as “Close <title>“. It was extended on purpose in #104091, and with the dialog named it is a bit redundant but still clear. A backport of the dialog name to 13.4 is not planned because 13.4 is out of regular maintenance.</p> <p>I’m closing this as resolved in v14. If a modal in v14 still shows up without an accessible name for you, please reopen with the module and steps, and I’ll take care of it.</p> <p>Cheers, Oli</p></title>