Bug 39706 - Accessibility: Missing text alternative for the star rating.
Summary: Accessibility: Missing text alternative for the star rating.
Status: Needs Signoff
Alias: None
Product: Koha
Classification: Unclassified
Component: Accessibility (show other bugs)
Version: unspecified
Hardware: All All
: P5 - low enhancement
Assignee: Nina Martinez
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks: 23003
  Show dependency treegraph
 
Reported: 2025-04-23 08:30 UTC by Nina Martinez
Modified: 2025-05-12 10:10 UTC (History)
4 users (show)

See Also:
GIT URL:
Change sponsored?: ---
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:
Circulation function:


Attachments
Bug 39706: Add alternative text to the stars rating (7.55 KB, patch)
2025-05-12 10:09 UTC, Nina Martinez
Details | Diff | Splinter Review

Note You need to log in before you can comment on or make changes to this bug.
Description Nina Martinez 2025-04-23 08:30:04 UTC
After trying to navigate in Koha with a screen reader, I noticed that the star rating of the record was difficult to understand without sight. 
The stars don’t have text alternatives, and the links are empty.

It would be great to improve this!

If you want to test this issue, you can use screen readers like Orca. There are some pages with star ratings:

Enable the following system preference: OpacStarRatings (results, details, and patron).
-The results page (make a search).
-The OPAC details page (choose a record).
-Your summary "checked out" page (You have to make a checkout before for your patron account. Go to the staff interface, enter the card number or your patron name in the search bar, and make a checkout).
Comment 1 Nina Martinez 2025-05-12 10:09:48 UTC
Created attachment 182254 [details] [review]
Bug 39706: Add alternative text to the stars rating

This patch improves the accessibility of the star ratings. To test this patch, you need to use a screen reader.

Some help for using the screen reader: to navigate between links, use the Tab key, to hear the text on the page, use the arrow keys.

Test Plan:

1. Enable the following system preference: OpacStarRatings (results, details, and patron).
2. Apply the patch.
3. Launch your screen reader (ex: Orca).
4. Go to the Opac interface.
5. Make a search.
6. Navigate through the record results and go to the star rating, you should hear only the rating average of each record and the number of votes.
7. On a record, do the same: go to the star rating, you should hear the rating average of the record and the number of votes.
8. Now, log into an account.
9. Make a search.
10. Navigate with the screen reader to the stars; you should hear the same information as in step 6.
11. Click on a record to view the details and navigate to the rating. Now, you can change the rating. Tab through the stars, it should tell you the number of each star. When you use the tab or arrow keys, you should still hear the average and the number of votes.
12. For this part, you need to have a record checkout (if you don't have a record checked out, go to the staff interface and do it. Choose your patron and enter the barcode of the record).
13. Go to your account. In the "Checked Out" section, navigate with the screen reader to the star rating, you should hear the number of stars and be able to change your rating or make a new one. You have to hear your rating, the average and the number of votes.