Skip to content

Commit

Permalink
Accessibility doc updates on known a11y issue for Dropdown/Combo-box
Browse files Browse the repository at this point in the history
  • Loading branch information
jake-costa authored Dec 17, 2024
1 parent 8674d1a commit f1c7d43
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 2 deletions.
36 changes: 36 additions & 0 deletions site/docs/components/combo-box/accessibility.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,42 @@ data:
$ref: ./#/data
---

## Accessibility considerations

**Browser/Assistive Technology Combination Issue**: We have identified an accessibility issue when using Safari and VoiceOver that affects the usability of combo boxes. This issue is not related to our design system but is a known limitation in the interaction between these specific technologies and can be confirmed using the [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/) (APG) example on the [World Wide Web Consortium](https://www.w3.org/) (w3c) [Who created the Web Content Accessibility Guidelines](https://www.w3.org/WAI/standards-guidelines/wcag/) (WCAG) which is the industry standard on accessibility.

**Issue Details**:

- Affected Components: Combobox (role=listbox)
- OS: MacOS 14
- Browser: Safari v15+
- Assistive Technology: VoiceOver
- Issue Confirmed on: 10/8/24
- Problem: Focus is not managed correctly when using VoiceOver to select options from the combo box drop-down in Safari

**User Impact**:
VoiceOver users using Safari may experience difficulties when interacting with combo boxes across various websites and applications, not limited to those using our design system.

**Steps To Reproduce Using APG**:

1. Go to [APG Select-Only Combobox Example](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/) using Safari
1. Turn on VoiceOver
1. Navigate to the example
1. Open the combo box using space/enter
1. Try to navigate and select an option.

**Recommendations**:

- Use Chrome or Firefox, or update to MacOS 15.1+

**Resources**:

- https://bugs.webkit.org/show_bug.cgi?id=231724
- https://discussions.apple.com/thread/255614236?sortBy=rank
- https://github.com/w3c/aria-practices/issues/2060

Update 12/17/24: This issue has been resolved in MacOS 15.

## Keyboard interactions

<KeyboardControls>
Expand Down
4 changes: 2 additions & 2 deletions site/docs/components/dropdown/accessibility.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ data:

## Accessibility considerations

**Browser/Assistive Technology Combination Issue**: We have identified an accessibility issue when using Safari and VoiceOver that affects the usability of combo boxes. This issue is not related to our design system but is a known limitation in the interaction between these specific technologies and can be confirmed using the APG example on the w3c (Who created WCAG) which is the industry standard on accessibility.
**Browser/Assistive Technology Combination Issue**: We have identified an accessibility issue when using Safari and VoiceOver that affects the usability of combo boxes. This issue is not related to our design system but is a known limitation in the interaction between these specific technologies and can be confirmed using the [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/) (APG) example on the [World Wide Web Consortium](https://www.w3.org/) (w3c) [Who created the Web Content Accessibility Guidelines](https://www.w3.org/WAI/standards-guidelines/wcag/) (WCAG) which is the industry standard on accessibility.

**Issue Details**:

Expand Down Expand Up @@ -49,7 +49,7 @@ VoiceOver users using Safari may experience difficulties when interacting with c
- https://discussions.apple.com/thread/255614236?sortBy=rank
- https://github.com/w3c/aria-practices/issues/2060

We will continue to monitor this situation and update this note when the issue has been resolved.
Update 12/17/24: This issue has been resolved in MacOS 15.

## Keyboard interactions

Expand Down

0 comments on commit f1c7d43

Please sign in to comment.