Skip to content

List / ListItemCustom: Selectable item forces unnecessary "Is Active" screen reader announcement (WCAG 4.1.2) #8798

Description

@AlexYanSap1

Describe the bug

In a List with selectionMode="Multiple" (or single-select), a ListItemCustom must have type="Active" in order for its selection checkbox to work. However, type="Active"
unconditionally makes screen readers (JAWS, NVDA, VoiceOver) append "Is Active" to the item's accessible name — e.g. "New Goal - 2025 Dates Is Active Not Selected".

For an item whose only interaction is its selection checkbox (no press/click handler), "Is Active" is misleading, unnecessary information and is flagged as a WCAG 4.1.2 (Name,
Role, Value) issue by accessibility audits.

There is no item type that provides "selectable AND not announced as active":

  • type="Active" → checkbox is selectable ✅ but "Is Active" is announced ❌
  • type="Inactive" → "Is Active" is not announced ✅ but the checkbox no longer fires selection (selection-requested is not fired for inactive items) ❌

Root cause (in @ui5/webcomponents):

  • ListItem.get ariaLabelledByText() appends LIST_ITEM_ACTIVE ("Is Active") whenever type === Active.
  • ListItem.onMultiSelectionComponentPress() / onSingleSelectionComponentPress() early-return when the item isInactive (type === Inactive || Detail), so an inactive item
    cannot be selected via its checkbox.

Isolated Example

https://stackblitz.com/edit/github-g9mzegcd?file=src%2FApp.tsx

Reproduction steps

  1. Open the isolated example in Chrome with a screen reader enabled (JAWS / NVDA; VoiceOver on Safari behaves the same).
  2. Tab into the List and navigate to the first item ("New Goal - 2025 Dates", type="Active").
  3. Observe the screen reader announces "... Is Active Not Selected" — the "Is Active" is unnecessary noise; the row has no press handler, only a selection checkbox.
  4. Navigate to the second item ("Another Goal", type="Inactive"): "Is Active" is not announced, but its checkbox can no longer be toggled (selection does not fire).

Expected Behaviour

A List item whose only interaction is its selection checkbox (single/multi-select mode, no press handler) should be selectable WITHOUT the screen reader announcing "Is Active".

Either:

  • the "Is Active" announcement should not be added for items that are only selectable (not pressable), or
  • there should be a way to keep an item selectable via its checkbox without setting type="Active" (i.e. decouple selectability from the "Active" press/announcement behaviour).

Screenshots or Videos

No response

UI5 Web Components for React Version

2.21.3 or the latest

UI5 Web Components Version

2.21.3 or the latest

Browser

Chrome

Operating System

No response

Additional Context

No response

Relevant log output

Organization

SAP SF

Declaration

  • I’m not disclosing any internal or sensitive information.

Metadata

Metadata

Assignees

No one assigned

    Labels

    SAP SFduplicateThis issue or pull request already exists

    Type

    Fields

    No fields configured for Bug.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions