| Summary: | OPAC cover images use non-descriptive alt text | ||
|---|---|---|---|
| Product: | Koha | Reporter: | Laura Escamilla <Laura.escamilla> |
| Component: | Accessibility | Assignee: | Laura Escamilla <Laura.escamilla> |
| Status: | Needs Signoff --- | QA Contact: | Testopia <testopia> |
| Severity: | normal | ||
| Priority: | P5 - low | CC: | acampbell, martin.renvoize, matt.blenkinsop, oleonard |
| Version: | Main | Keywords: | accessibility |
| Hardware: | All | ||
| OS: | All | ||
| GIT URL: | Initiative type: | --- | |
| Sponsorship status: | --- | Comma delimited list of Sponsors: | |
| Crowdfunding goal: | 0 | Patch complexity: | --- |
| Documentation contact: | Documentation submission: | ||
| Text to go in the release notes: | Version(s) released in: | ||
| Circulation function: | |||
| Attachments: | Bug 41639: Improve cover image alt text for WCAG 2.2 compliance | ||
|
Description
Laura Escamilla
2026-01-15 20:35:44 UTC
Created attachment 191537 [details] [review] Bug 41639: Improve cover image alt text for WCAG 2.2 compliance Steps to Test 1. Enable at least one cover image provider: * Amazon cover images * Syndetics * Google Jackets * Open Library * Coce * Local cover images * Custom cover images 2. Go to the Staff Intranet search results page and locate a bibliographic record with a visible cover image. 3. Inspect the cover image element in the browser developer tools. 4. Observe that the <img> element (or injected cover element in the case of Google Jackets / Open Library / Coce) uses a generic or non-descriptive alternative text, such as: * alt="Amazon cover image" * alt="Local cover image" * alt="Cover from Syndetics" * or no meaningful accessible name for injected images (Google Jackets, Open Library, Coce) 5. Click into the bibliographic record detail page in the Staff Intranet. 6. Inspect the cover image again and observe the same behavior. 7. Test for all cover image providers. 8. Repeat steps for the OPAC. 9. Apply the patch. 10. Repeat steps 1 - 8. 11. Confirm that the alt text (or accessible name) is now dynamically generated using bibliographic metadata, for example: * alt="Cover of Complete Joe Pass by Joe Pass" 12. Everything is now accessibility verified, WCAG 2.2 SC 1.1.1 compliant, and with no regression across providers. Sign off and have an amazing day! :D Thanks Laura! This looks like it should work for most everything. We do have images of items that aren't books and thus don't have a 'cover'. For example we may have some instances of "Cover of [iPad] by [Apple Inc.]", or "Cover of [hand trowel] by [NULL]". Maybe for a future patch, we can have a required alt text field when we upload local images where we could add the required alt text to the image -- these non-book/DVD items don't have ISBNs to pull images from 3rd-party sources. That being said I think even if we end up having everything described as “Cover of [Title] by [Author],” we can make adjustments after the fact through further patches. If anything, it's something to think about in the future. |