starred/audiobookshelf
1
0
Fork 0
mirror of https://github.com/advplyr/audiobookshelf.git synced 2026-05-30 23:40:40 +02:00
Code Issues 1.0k Packages Projects Releases 10 Wiki Activity

[Enhancement]: UI Improvements: Heading Levels and Accessibility Enhancements #2409

New Issue
Closed
opened 2026-04-25 00:06:50 +02:00 by adam · 3 comments
adam commented 2026-04-25 00:06:50 +02:00
Owner
Copy Link
Copy Source

Originally created by @math65 on GitHub (Dec 9, 2024).

Type of Enhancement

Web Interface/Frontend

Describe the Feature/Enhancement

The current interface lacks proper heading levels, which makes it difficult for screen reader users to navigate effectively. For instance, on the homepage, categories like ‘Continue Reading’ and ‘Recently Added’ do not have headings, which would make navigation faster and more intuitive. Additionally, the web player section could benefit from a dedicated heading or ARIA landmarks for improved accessibility.

Some elements on the homepage are not labeled correctly, such as ‘play_arrow,’ ‘radio_button_unchecked,’ and ‘more_vert,’ leaving their purpose unclear to screen reader users.

On the book detail page, after the ‘Play’ button, there are two unlabeled buttons whose function is not specified, making it hard to interact with these elements.

Why would this be helpful?

Improving heading levels and labeling would significantly enhance navigation and usability for screen reader users, making it easier to quickly locate and interact with key sections and controls on the interface. Clear labels ensure all users understand the purpose of buttons and elements, providing a more inclusive and user-friendly experience.

Future Implementation (Screenshot)

I am unable to provide a doodle or screenshot as I am blind, but I have described the issue in detail to help you understand and visualize the areas needing improvement. I am happy to collaborate further if needed.

Audiobookshelf Server Version

2.17.5

Current Implementation (Screenshot)

I was looking at the homepage and the book detail page when I noticed these areas that could benefit from enhancements.

Originally created by @math65 on GitHub (Dec 9, 2024). ### Type of Enhancement Web Interface/Frontend ### Describe the Feature/Enhancement The current interface lacks proper heading levels, which makes it difficult for screen reader users to navigate effectively. For instance, on the homepage, categories like ‘Continue Reading’ and ‘Recently Added’ do not have headings, which would make navigation faster and more intuitive. Additionally, the web player section could benefit from a dedicated heading or ARIA landmarks for improved accessibility. Some elements on the homepage are not labeled correctly, such as ‘play_arrow,’ ‘radio_button_unchecked,’ and ‘more_vert,’ leaving their purpose unclear to screen reader users. On the book detail page, after the ‘Play’ button, there are two unlabeled buttons whose function is not specified, making it hard to interact with these elements. ### Why would this be helpful? Improving heading levels and labeling would significantly enhance navigation and usability for screen reader users, making it easier to quickly locate and interact with key sections and controls on the interface. Clear labels ensure all users understand the purpose of buttons and elements, providing a more inclusive and user-friendly experience. ### Future Implementation (Screenshot) I am unable to provide a doodle or screenshot as I am blind, but I have described the issue in detail to help you understand and visualize the areas needing improvement. I am happy to collaborate further if needed. ### Audiobookshelf Server Version 2.17.5 ### Current Implementation (Screenshot) I was looking at the homepage and the book detail page when I noticed these areas that could benefit from enhancements.
adam added the enhancement label 2026-04-25 00:06:50 +02:00
adam closed this issue 2026-04-25 00:06:50 +02:00
adam commented 2026-04-25 00:06:51 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Dec 10, 2024):

Related to and may be able to be combined with https://github.com/advplyr/audiobookshelf/issues/2268

Also related to https://github.com/advplyr/audiobookshelf/issues/441

@advplyr commented on GitHub (Dec 10, 2024): Related to and may be able to be combined with https://github.com/advplyr/audiobookshelf/issues/2268 Also related to https://github.com/advplyr/audiobookshelf/issues/441
adam commented 2026-04-25 00:06:51 +02:00
Author
Owner
Copy Link
Copy Source

@math65 commented on GitHub (Dec 10, 2024):

Sorry, I looked for Accessibility in the issues before writing, but I hadn't found them :)

Le 10 déc. 2024 à 00:28, advplyr @.***> a écrit :

Related to and may be able to be combined with #2268 https://github.com/advplyr/audiobookshelf/issues/2268
Also related to #441 https://github.com/advplyr/audiobookshelf/issues/441
—
Reply to this email directly, view it on GitHub https://github.com/advplyr/audiobookshelf/issues/3699#issuecomment-2529777151, or unsubscribe https://github.com/notifications/unsubscribe-auth/AG4WO54ZSJWCGBB5ZJLQ5732EYRRZAVCNFSM6AAAAABTJEAPMCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDKMRZG43TOMJVGE.
You are receiving this because you authored the thread.

@math65 commented on GitHub (Dec 10, 2024): Sorry, I looked for Accessibility in the issues before writing, but I hadn't found them :) > Le 10 déc. 2024 à 00:28, advplyr ***@***.***> a écrit : > > > Related to and may be able to be combined with #2268 <https://github.com/advplyr/audiobookshelf/issues/2268> > Also related to #441 <https://github.com/advplyr/audiobookshelf/issues/441> > — > Reply to this email directly, view it on GitHub <https://github.com/advplyr/audiobookshelf/issues/3699#issuecomment-2529777151>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AG4WO54ZSJWCGBB5ZJLQ5732EYRRZAVCNFSM6AAAAABTJEAPMCVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDKMRZG43TOMJVGE>. > You are receiving this because you authored the thread. >
adam commented 2026-04-25 00:06:51 +02:00
Author
Owner
Copy Link
Copy Source

@advplyr commented on GitHub (Dec 31, 2024):

A ton of accessibility improvements were made for v2.17.6 but there is still a lot to be done.

The main thread for accessibility issues is going to be https://github.com/advplyr/audiobookshelf/issues/2268 so I'll post updates there.

@advplyr commented on GitHub (Dec 31, 2024): A ton of accessibility improvements were made for v2.17.6 but there is still a lot to be done. The main thread for accessibility issues is going to be https://github.com/advplyr/audiobookshelf/issues/2268 so I'll post updates there.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
authentication
backlog
bug
chapter editor
config-issue
ebooks
encoding/embedding
enhancement
help wanted
listening sessions & progress
planned
possible plugin
progress sync
pull-request
Mirrored from GitHub Pull Request
 sorting/filtering/searching
unable to reproduce
upload
users & permissions
waiting
No Label enhancement
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam (Adam Melkus)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#2409
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?