Issue Bug Closed

#108865Page title edit icon contrast too low

Jennifer Geiß 02/05/26, 07:46 updated 03/31/26, 08:10

Description

Description

The edit icon displayed next to the page title in the TYPO3 backend has an insufficient color contrast in its default (rest) state. As a result, the icon is hard to perceive, especially for users with visual impairments or in low-contrast environments. The default state must be adjusted to follow the standard component styling and comply with WCAG contrast requirements.

Reproduction steps

  1. Log into the TYPO3 backend.
  2. Navigate to a page record where the page title is displayed with an edit icon next to it.
  3. Observe the edit icon in its default (non-hover, non-focused, non-active) state.
  4. Compare the icon’s visibility with edit icons used in the standard components (design system / component library).
  5. Notice that the page-title edit icon appears significantly less visible due to low contrast.

Target group

  • Users with low vision or reduced contrast sensitivity.
  • Users working on displays with poor brightness/contrast or in bright environments (glare).
  • All backend editors who need to quickly identify edit actions in the UI.

Severity

  • Medium to High
    Core functionality is still available, but discoverability is impaired for a significant group of users and negatively impacts accessibility compliance.

Frequency

  • High
    The page-title edit icon is visible on many (or all) page views in the backend and thus frequently encountered by editors.

Definition of Done

  • The default-state styling (color/opacity) of the page-title edit icon is updated to match the standard edit icon styling from the component library.
  • The contrast between the icon and its background meets at least WCAG 2.2 requirements for non-text contrast (minimum 3:1).
  • If the icon is effectively rendered as “text” (e.g., font icon), the contrast ratio meets at least 4.5:1 in line with text contrast recommendations.
  • No negative impact on hover, focus, or active states; they remain clearly distinguishable and at least as visible as the default state.
  • Visual checks are performed in at least one light/default backend theme (and any available high-contrast/dark theme if applicable).
  • Manual verification with a contrast checker tool is documented (e.g., link/screenshot or note in the PR).

Suggestion

  • Reuse existing design tokens / CSS variables for icon colors that are already used for edit icons in the shared component library.
  • Align the page-title edit icon with the standard icon color used for primary interactive icons (e.g., neutral-foreground or primary-foreground token).
  • Avoid custom, one-off color values for this icon; instead, rely on the design system so that future theme changes automatically keep it accessible.

Recommended solution

  • Identify the component or template responsible for rendering the page-title edit icon in the TYPO3 backend.
  • Update the default (rest) state styling (e.g., CSS class, color variable, opacity) to use the same configuration as the edit icon in the standardized components.
  • Verify in the DOM and with design tokens that:
  • The same icon color token / class as used by the component-library edit icon is applied.
  • The background behind the icon does not introduce new low-contrast issues.
  • Measure the contrast ratio between the icon color and its background using a recognized contrast checker (e.g., WebAIM Contrast Checker). Aim for:
  • At least 3:1 for non-text UI elements.
  • Preferably 4.5:1 if the icon is considered a text-like glyph.

References / WCAG 2.2 Reference

  • WCAG 2.2 – Success Criterion 1.4.3: Contrast (Minimum)
    Requires sufficient contrast between text (including text-like icons) and its background, typically at least 4.5:1 for normal text.
  • WCAG 2.2 – Success Criterion 1.4.11: Non-text Contrast
    Requires a contrast ratio of at least 3:1 for graphical objects and user interface components (including icons) against adjacent colors.

Reviews 2