Loading

Accessibility: Combobox Expanded State Not Announced When Focus Moves to List Item

Publish Date: May 19, 2026
Description

When activating an editable combobox using the down arrow, screen readers announce the focused list item rather than the "expanded" state. This occurs because:

  • Focus shifts immediately to the first list item.
  • Screen readers announce only the newly focused element (default behavior).
  • Queued announcements (like state changes) are dropped when focus moves.

The accessibility tree correctly reflects expanded=false/true, confirming programmatic association.

Resolution

Shifting focus directly to the list item and announcing it upon activation confirms the expansion and places the focus exactly where the user intended. By cutting out redundant announcements and extra activations, it provides an immediate, meaningful focus order along with announcements that keep the user flow seamless. 

This behavior aligns with WCAG 4.1.2 (Name, Role, Value):

  • Programmatic association is present: The expanded state is correctly exposed in the Accessibility API
  • Notification of change is provided: Moving focus to the list and announcing the first item satisfies the notification requirement

It gives developers flexibility in focus management while maintaining compliance.

Knowledge Article Number

005317657

 
Loading
Salesforce Help | Article