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

Description list not structured properly for screen readers #3053

Conversation

precious-onyenaucheya-ons
Copy link
Contributor

@precious-onyenaucheya-ons precious-onyenaucheya-ons commented Feb 26, 2024

What is the context of this PR?

Fixes #3027
The current structure of the summary component utilises multiple <dl> elements, causing the screen reader to interpret them as separate list elements, which does not pass accessibility tests.

This PR addresses the issue by restructuring the Summary component so that the list is enclosed within a single <dl> element. This change ensures that the screen reader recognises it as one list rather than multiple lists.

This PR also removed some rules from the Axe tests on the summary component. When resolving this DAC issue the tests failed and to fix them would require a major refactor. The issue they raised wasn't something that was seen as an a problem accessibility wise so it was decided that we would disable the rules on these tests.

How to review this PR

Check that the summary list is wrapped in a <dl> element and is being read out correctly by the screen reader

Checklist

This needs to be completed by the person raising the PR.

  • I have selected the correct Assignee
  • I have linked the correct Issue

@precious-onyenaucheya-ons precious-onyenaucheya-ons added the Accessibility Issues discovered through accessibility testing label Feb 26, 2024
Copy link

netlify bot commented Feb 26, 2024

Deploy Preview for ons-design-system-preview ready!

Name Link
🔨 Latest commit b1a488b
🔍 Latest deploy log https://app.netlify.com/sites/ons-design-system-preview/deploys/65df4a24ad952d0008a5b0b4
😎 Deploy Preview https://deploy-preview-3053--ons-design-system-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor

@rmccar rmccar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Other than this looks good

@precious-onyenaucheya-ons precious-onyenaucheya-ons merged commit f9fd468 into main Feb 28, 2024
9 checks passed
@precious-onyenaucheya-ons precious-onyenaucheya-ons deleted the feature/fix-list-structure-not-properly-represented-for-screenreaders branch February 28, 2024 15:54
rmccar pushed a commit that referenced this pull request Mar 6, 2024
* initial change

* update test

* update test

* update comment

* update comment
alessioventuriniAND added a commit that referenced this pull request Apr 4, 2024
…wcag 22 level aaa (#3119)

* ⬆️  Back To Top Link  ⬆️  (#2990)

* Page template for length

* Add macro

* Add component foundations

* Build stylesheet

* Add additional functionality

* Improved functionality

* Fix border and layout

* Fix resize behaviour

* Changes to CSS

* Add more tests

* Update VR Tests

* Change to full width

---------

Co-authored-by: Alessio Venturini <112873190+alessioventuriniAND@users.noreply.github.com>

* Description list not structured properly for screen readers (#3053)

* initial change

* update test

* update test

* update comment

* update comment

* Update placeholder text colour (#3062)

* Fix/3004/icon in footer not clickable (#3036)

* Fix checkbox appearance on safari (#3066)

* Adding the change in readme (#3067)

* updated youtube video to a more accessible one

* updated reference files

---------

Co-authored-by: Aditya Unnithan_ONS <56112669+adi-unni@users.noreply.github.com>
Co-authored-by: Precious Onyenaucheya <86783201+precious-onyenaucheya-ons@users.noreply.github.com>
Co-authored-by: rmccar <42928680+rmccar@users.noreply.github.com>
Co-authored-by: Bali Birch-Lee_ONS <149602681+balibirchlee@users.noreply.github.com>
Co-authored-by: SriHV <123635670+SriHV@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Accessibility Issues discovered through accessibility testing
Projects
None yet
Development

Successfully merging this pull request may close these issues.

List structure: summary lists (WCAG 2.2 Level A - Accessibility)
3 participants