Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sidebar a11y updates: <aside>, aria-label #1437

Open
dbranchini opened this issue Oct 16, 2024 · 4 comments
Open

Sidebar a11y updates: <aside>, aria-label #1437

dbranchini opened this issue Oct 16, 2024 · 4 comments
Assignees

Comments

@dbranchini
Copy link

Because we have a sidebar on the left, the H1 is not seen/read first. We discussed this with SODA and they agreed that a left sidebar is a very common pattern (and in fact used on the WCAG site). Also, it appears under the category of "best practice" in SiteImprove, so it's not as important as an A or AA error. It also doesn't show up in Axe.

All that said, SODA suggested it would be improved by making the entire sidebar area an <aside> and giving it an aria-label that describes it, such as "Download, export and other options."

Screenshot 2024-10-16 at 5 06 42 PM
@dbranchini
Copy link
Author

Also, if it's easy enough, "Also available at" and "Item belong to a collection" should be in the same gray box. See this Figma design - https://www.figma.com/design/nkgg905s5FyXoyPZjVMco0/EarthWorks?node-id=517-18605&t=N5nCgaAU3Yv8eOEv-4.

@thatbudakguy thatbudakguy changed the title Page does not start with a level 1 heading (SiteImprove error) Sidebar a11y updates: <aside>, aria-label Oct 30, 2024
@thatbudakguy
Copy link
Member

Opened projectblacklight/blacklight#3423 in blacklight to partially address this.

@thatbudakguy thatbudakguy self-assigned this Oct 30, 2024
thatbudakguy added a commit that referenced this issue Oct 31, 2024
This refactors the sidebar component to make it easier to determine
what is being rendered in each of the two sections and to render
it without accidentally duplicating the divider elements.

It also ensures that items that should be grouped together in the
second section are displayed in a single box, as noted in #1437.

Fixes #1437
thatbudakguy added a commit that referenced this issue Nov 1, 2024
This refactors the sidebar component to make it easier to determine
what is being rendered in each of the two sections and to render
it without accidentally duplicating the divider elements.

It also ensures that items that should be grouped together in the
second section are displayed in a single box, as noted in #1437.

Fixes #1437
@jcoyne jcoyne closed this as completed in 5fb83a5 Nov 4, 2024
@thatbudakguy thatbudakguy reopened this Nov 4, 2024
@thatbudakguy
Copy link
Member

Spacing is now fixed; waiting on Blacklight release to make it a labeled <aside>.

Screenshot 2024-11-04 at 08 58 03

@thatbudakguy
Copy link
Member

I forgot to backport this 🤦🏻 opened projectblacklight/blacklight#3458 to get it into blacklight 8.x.

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

No branches or pull requests

2 participants