Issue Bug Resolved

#109091Improve accessibility of image alignment icons (imageorient) in the backend

Christian Jung 02/24/26, 15:46 updated 10/23/26, 14:35

Description

The icons for image alignment (imageorient) are only labeled via title attributes and do not have unique accessible names. Within the selection list the icons appear redundant, and the current selection is only visually indicated. Screen readers announce the buttons with identical names, without reference to the group, and the visually active button is not recognized as selected (no aria-pressed / aria-checked).

Steps to Reproduce

  1. Log into the TYPO3 backend as an editor.
  2. Create or edit a content element with one or more images.
  3. Navigate to the field for image alignment (imageorient) and open the icon selection.
  4. Use a screen reader (e.g. NVDA, JAWS, VoiceOver) to navigate through the icons/buttons.

Impact

  • Screen reader users cannot reliably distinguish the individual alignment options.
  • The current selection is not exposed programmatically; the visual “active” state is not announced.
  • Interaction is unnecessarily complex and violates basic accessibility requirements.

Possible solution

  • Provide each icon button with a unique accessible name (visible text inside the button or an aria-label such as “image left”, “image centered”, “image right”).
  • Mark up the icon group as a single selection group (e.g. role=“radiogroup” and each option as role=“radio” or an equivalent semantic pattern).
  • Mark the currently chosen option programmatically (e.g. aria-checked=“true” or aria-pressed=“true”, matching the chosen role).
  • Ensure that the selection is not conveyed by title only and is usable without mouse and without tooltips.
  • Or maintain this icons only decorative without functions

Reviews 2

Files 1

History 36

  1. Christian Rath-Ulrich commented <span data-processor="relativetime" data-value="2026-10-21T19:19:41+00:00" > 10/21/26, 19:19 </span>

    as the dropdown is anonced we hide the imagelist blow as the information is redundant

  2. Christian Rath-Ulrich commented and changed status Under Review Resolved done 0 % 100 % <span data-processor="relativetime" data-value="2026-10-23T14:35:17+00:00" > 10/23/26, 14:35 </span>

    Applied in changeset commit:db471c6a7ad5a2640b0f8b3e0685eaa976376b0c.