Skip to content

Conversation

@jwlilly
Copy link

@jwlilly jwlilly commented Jul 4, 2025

Brief summary

Accessibility Improvements for users with disabilities. The only visual change is adding a visible focus indicator to the author cards.

Which issue is fixed?

Pull Request Type

  • Affects Android and iOS
  • Font-end change

In-depth Description

The app contains lots of unlabeled controls and controls that do not have roles. This should address the issues listed above, but the whole app needs some work to make it accessible. This app can be particularly appealing to screen reader users since audiobooks are generally favored over Braille books.

  • Improving labels and keyboard navigation in appbar
  • Add list semantics to shelf view (audiobooks only for now)
  • Improving keyboard navigation and labeling for author view, series view, collection, and home
  • Improving labeling and keyboard navigation for book card (more work needed for podcasts)
  • Adding labels to bookshelf nav bar
  • Adding label for connection indicator
  • More robust labeling method for the search field
  • Labeling and keyboard navigation of player controls
  • Focus management for going between fullscreen and collapsed player

How have you tested this?

Tested with mobile screen readers, inspected the output HTML, and used the Android Accessibility Inspector.

Screenshots

This screenshot is the only visible front end change that I made. It is a focus indicator for the author cards which is necessary for users that might be using a bluetooth keyboard with their device.
screenshot of the updated focus indicator

jwlilly added 2 commits July 3, 2025 22:27
- Improving labels and keyboard navigation in appbar
- Add list semantics to shelf view (audiobooks only for now)
- Improving keyboard navigation and labeling for author view
- Improving labeling and keyboard navigation for book card (more work needed for podcasts)
- Adding labels to bookshelf nav bar
- Adding label for connection indicator
- More robust labeling method for the search field
- Accessibility labels for all controls excluding the modals
- Accessibility roles for all controls excluding the modals
- Keyboard events for all controls
- Focus management for opening and closing the fullscreen player
@jwlilly jwlilly marked this pull request as ready for review July 6, 2025 02:23
@jwlilly
Copy link
Author

jwlilly commented Jul 6, 2025

There are still improvements to be done. But I think this is a good place for the first PR. I didn't want the changes to get too big to keep track of

@jwlilly
Copy link
Author

jwlilly commented Oct 9, 2025

I see conflicts with 2 files but it looks like changes that were made have introduced hardcoded strings into the aria-label attributes. Shouldn't we want all strings to come from resources to support translations?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Unlabeled Elements and Navigation Problems with VoiceOver Unable to tap on a series or an author with Voiceover enabled

2 participants