Skip to content
This repository was archived by the owner on Dec 18, 2024. It is now read-only.

docs-infra: address numerous a11y issues #697

Merged
merged 13 commits into from
Jan 17, 2020
Merged

Conversation

Splaktar
Copy link
Contributor

@Splaktar Splaktar commented Dec 28, 2019

Please see commits for descriptions and related issues (#671 captures most, but not all of the issues).

More Accessible Theme Picker

The current theme picker is a mat-grid-list nested in a mat-menu which isn't ideal.
The new theme picker is a mat-menu with button elements.

Screen Shot 2019-12-28 at 19 34 31
Screen Shot 2019-12-28 at 19 34 13

TODO

  • This list
  • Add some visual color hints to theme picker

@Splaktar Splaktar force-pushed the a11y-codelyzer-tslint branch from 35c75f3 to 4b339a0 Compare December 30, 2019 12:18
@Splaktar Splaktar force-pushed the a11y-codelyzer-tslint branch 2 times, most recently from dbf5810 to f354578 Compare January 14, 2020 02:41
Copy link
Member

@jelbourn jelbourn left a comment

Choose a reason for hiding this comment

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

Just a couple last things I noticed

@Splaktar Splaktar force-pushed the a11y-codelyzer-tslint branch from e759ed2 to 77fbd7b Compare January 17, 2020 02:26
- do some merging of tslint:recommended and our rules
enable Codelyzer a11y rules

Relates to #671
…prove contrast

- use Roboto font instead of system-ui for `docs-nav-content-btn`s
- use a different background color for selected route, in addition to different text color
- increase opacity of `docs-nav-content-btn`s to meet contrast guidelines
- switch to `mat-nav-list` to get the benefits of better contrast and hover/focus styles
  - plus slightly more padding for touch interfaces

Fixes #694. Relates to #671.
- improves screen reader support
- footer tags were already properly used

Relates to #671.
- so that they can be differentiated by screen readers

Relates to #671.
- aria-expanded already covers whether the section can be toggled or not
- the button's text content already covers the accessible name

Relates to #671.
- the aria-label is sufficient

Relates to #671.
- minify theme-demo-icon.svg
- use & instead of / as it reads better on a screen reader
- prefix classes with `docs-`
- tell screen reader users when a theme has been selected

Fixes #671
@Splaktar Splaktar force-pushed the a11y-codelyzer-tslint branch from 77fbd7b to 419de93 Compare January 17, 2020 02:28
@Splaktar
Copy link
Contributor Author

Addressed feedback and also added a LiveAnnouncer message when a theme is selected from the list.

Copy link
Member

@jelbourn jelbourn left a comment

Choose a reason for hiding this comment

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

LGTM

@jelbourn jelbourn merged commit 5580b24 into master Jan 17, 2020
@Splaktar Splaktar deleted the a11y-codelyzer-tslint branch January 17, 2020 19:09
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants