View mode switch accessibility#2241
Merged
tdonohue merged 2 commits intoDSpace:mainfrom May 11, 2023
Merged
Conversation
tdonohue
approved these changes
May 11, 2023
Member
tdonohue
left a comment
There was a problem hiding this comment.
👍 Thanks @doana for your contribution! I was able to test this today and verified that there are no adverse side effects to the behavior of these buttons. I agree completely that your fixes are more appropriate and improve accessibility.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Use more semantically appropriate elements for list controls and markup that better aligns with WCAG recommendations.
Instructions for Reviewers
This issue originally brought to my attention because our accessibility auditing tools flag the links as having empty link content. While in practice they read fine to me in my testing using the NVDA screen reader, other assistive technology might not infer that the icon title should be used as the link text.
The crux of this change is to use more semantically appropriate elements for the view mode switch controls. The use of button elements is more appropriate as they don't imply a significant change of context the way that a link element does. The other change here is to explicitly include the name for the control in the button element itself, instead of as part of the title attribute on the icon inside of the link. This better aligns with the WCAG since the name of the control is more explicitly available for programmatic access.
List of changes in this PR:
An alternative strategy for #2 would be to set the title element on the button itself, rather than on the icon. This would keep the tool tip that is lost from this change.
Checklist
This checklist provides a reminder of what we are going to look for when reviewing your PR. You need not complete this checklist prior to creating your PR (draft PRs are always welcome). If you are unsure about an item in the checklist, don't hesitate to ask. We're here to help!
yarn lintyarn check-circ-deps)package.json), I've made sure their licenses align with the DSpace BSD License based on the Licensing of Contributions documentation.