Issue Feature New Orphaned

#108211Clear Labeling and Accessibility for Language Select in Filelist (Edit Dialog)

Christian Jung 11/20/25, 10:25 updated 11/20/25, 10:25

Description

Description

In the Filelist file edit dialog, the language select is currently not clearly labeled. To improve clarity and accessibility:

  • Add a clear, visible label (e.g., “Language”).
  • Since select elements don’t support true placeholders, add a first, non-valid default option “Please select a language” with an empty value.
  • Display a short helper text (below the field), e.g., “This setting controls the display language.”
  • For screen readers, ensure proper label-for/aria-label and, if a helper text exists, aria-describedby linkage.
  • Existing save behavior remains unchanged; the placeholder option must not be stored as a valid selection.
  • Note: If a language is already set, it should be preselected; the placeholder option must not appear as the active selection.

Acceptance Criteria

  • Visible label:
    > * A visible label “Language” is shown next to/above the select.
    > * The label is correctly associated with the select via for/id.
  • Placeholder option:
    > * The first option reads “Please select a language” and has an empty value.
    > * The placeholder option cannot be saved as a valid selection.
    > * If a language is already set, it is preselected; the placeholder is not selected.
  • Helper text:
    > * A short helper text is displayed below the field: “This setting controls the display language” (translatable/configurable).
    > * The helper text is linked to the select via aria-describedby.
  • Accessibility/screen readers:
    > * The select has the visible label (preferred) or, as a fallback, an aria-label “Language”.
    > * Screen readers announce the helper text via aria-describedby.
    > * Keyboard navigation (Tab, Arrow keys, Enter/Space) continues to work as before.
  • i18n/translations:
    > * Label, placeholder option, and helper text are translatable via XLF and appear in the backend user’s language.
  • UI/UX:
    > * Styling is consistent with TYPO3 backend (spacing, contrast, dark/light mode).
    > * No layout shifts or overlapping in the edit dialog.
  • Functionality/saving:
    > * Existing save/validation logic for the language selection is unchanged, except that the placeholder is not accepted as a valid value.
    > * If language is required (project-specific), validation prevents saving without a valid selection and shows a clear error message.
  • Regression:
    > * No impact on other fields or forms in Filelist.
    > * No effect on already stored language assignments.

Out of Scope

  • No changes to language inheritance or resolution logic outside the edit dialog.
  • No changes to permissions/roles.

Implementation Notes (for Devs)

  • Prefer a visible label for best accessibility; aria-label is a fallback only.
  • Add the placeholder option as the first select item with an empty value; enforce invalidity server-side and client-side.
  • Render the helper text as a field description and use its ID for aria-describedby.
  • Maintain all user-facing strings (label, placeholder, helper) in XLF for translation.

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
[FEATURE] Clear Labeling and Accessibility for Language Select in Filelist (Edit Dialog) Resolves: #108211 Releases: main