starred/audiobookshelf-app
1
0
Fork 0
mirror of https://github.com/advplyr/audiobookshelf-app.git synced 2026-07-25 22:18:38 +02:00
Code Issues 454 Packages Projects Releases 10 Wiki Activity

[PR #1620] Accessibility Improvements #1636

New Issue
Open
opened 2026-04-24 23:59:52 +02:00 by adam · 0 comments
adam commented 2026-04-24 23:59:52 +02:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/advplyr/audiobookshelf-app/pull/1620
Author: @jwlilly
Created: 7/4/2025
Status: 🔄 Open

Base: master ← Head: Accessibility-Improvements-7-25

📝 Commits (4)

  • e0a07a4 Accessibility Improvements
  • 534a660 Accessibility Overhaul of Player
  • 0a484e0 Updating lazy card semantics
  • 9126b1c Merge branch 'master' into Accessibility-Improvements-7-25

📊 Changes

14 files changed (+258 additions, -143 deletions)

View changed files

📝 components/app/Appbar.vue (+16 -6)
📝 components/app/AudioPlayer.vue (+85 -18)
📝 components/bookshelf/LazyBookshelf.vue (+2 -2)
📝 components/bookshelf/Shelf.vue (+2 -2)
📝 components/cards/AuthorCard.vue (+4 -4)
📝 components/cards/LazyBookCard.vue (+93 -81)
📝 components/cards/LazyCollectionCard.vue (+11 -9)
📝 components/cards/LazySeriesCard.vue (+13 -11)
📝 components/covers/AuthorImage.vue (+4 -4)
📝 components/home/BookshelfNavBar.vue (+1 -1)
📝 components/widgets/ConnectionIndicator.vue (+14 -1)
📝 pages/bookshelf/authors.vue (+2 -2)
📝 pages/search.vue (+2 -2)
📝 strings/en-us.json (+9 -0)

📄 Description

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

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/advplyr/audiobookshelf-app/pull/1620 **Author:** [@jwlilly](https://github.com/jwlilly) **Created:** 7/4/2025 **Status:** 🔄 Open **Base:** `master` ← **Head:** `Accessibility-Improvements-7-25` --- ### 📝 Commits (4) - [`e0a07a4`](https://github.com/advplyr/audiobookshelf-app/commit/e0a07a487286ae00642b22766f6e847b2d412336) Accessibility Improvements - [`534a660`](https://github.com/advplyr/audiobookshelf-app/commit/534a6600d4912613ab3bfde75b370d4a72178011) Accessibility Overhaul of Player - [`0a484e0`](https://github.com/advplyr/audiobookshelf-app/commit/0a484e05d833296402892908f07474164abaaa2c) Updating lazy card semantics - [`9126b1c`](https://github.com/advplyr/audiobookshelf-app/commit/9126b1cdcac4f164083aa115c5b18ea470e7ecfc) Merge branch 'master' into Accessibility-Improvements-7-25 ### 📊 Changes **14 files changed** (+258 additions, -143 deletions) <details> <summary>View changed files</summary> 📝 `components/app/Appbar.vue` (+16 -6) 📝 `components/app/AudioPlayer.vue` (+85 -18) 📝 `components/bookshelf/LazyBookshelf.vue` (+2 -2) 📝 `components/bookshelf/Shelf.vue` (+2 -2) 📝 `components/cards/AuthorCard.vue` (+4 -4) 📝 `components/cards/LazyBookCard.vue` (+93 -81) 📝 `components/cards/LazyCollectionCard.vue` (+11 -9) 📝 `components/cards/LazySeriesCard.vue` (+13 -11) 📝 `components/covers/AuthorImage.vue` (+4 -4) 📝 `components/home/BookshelfNavBar.vue` (+1 -1) 📝 `components/widgets/ConnectionIndicator.vue` (+14 -1) 📝 `pages/bookshelf/authors.vue` (+2 -2) 📝 `pages/search.vue` (+2 -2) 📝 `strings/en-us.json` (+9 -0) </details> ### 📄 Description ## 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? - Fixes #1575 - Fixes #497 ## 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](https://github.com/jwlilly/Android-Accessibility-Inspector-App). ## 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. <img width="328" alt="screenshot of the updated focus indicator" src="https://github.com/user-attachments/assets/442b685f-ae56-4c5d-93e4-64d286ea6a37" /> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
adam added the pull-request label 2026-04-24 23:59:52 +02:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
android
android auto
backlog
bug
enhancement
ereader
help wanted
iOS
progress sync
pull-request
Mirrored from GitHub Pull Request
 sleep timer
unable to reproduce
waiting
No labels pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
adam (Adam Melkus)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf-app#1636