Issue Bug Closed

#108445Modal dialog box – Close button not explicitly labeled

Jennifer Geiß 12/09/25, 15:06 updated 11/05/26, 15:15

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

  1. Oliver Bartsch commented and changed status New Closed <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 via aria-labelledby, or uses aria-label with 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.&lt;/p&gt; &lt;p&gt;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.&lt;/p&gt; &lt;p&gt;Cheers, Oli&lt;/p&gt;</title>