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

feat(docs): added accessibility guide #2122

Merged
merged 14 commits into from
Jun 17, 2024
Merged
5 changes: 2 additions & 3 deletions docs/guide/advanced/accessibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,9 +119,8 @@ contained icon.
## A note on `aria-label`

Although you could provide accessible labels to your elements via the `aria-label` attribute, we
generally suggest using your chosen CSS framework's "visually hidden" utility instead whenever
possible, since some assistive technology fails to announce `aria-label` attributes in case the
element is not of an appropriate semantic role.
generally recommend against this for and instead suggest that
you [use your chosen CSS framework's "visually hidden" utility whenever possible](https://gomakethings.com/revisting-aria-label-versus-a-visually-hidden-class/).
karsa-mistmere marked this conversation as resolved.
Show resolved Hide resolved

karsa-mistmere marked this conversation as resolved.
Show resolved Hide resolved
E.g. in case of Bootstrap:
karsa-mistmere marked this conversation as resolved.
Show resolved Hide resolved

Expand Down
16 changes: 8 additions & 8 deletions docs/images/a11y/alttext-buttons.svg
karsa-mistmere marked this conversation as resolved.
Show resolved Hide resolved
jguddas marked this conversation as resolved.
Show resolved Hide resolved
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 8 additions & 8 deletions docs/images/a11y/alttext-iconbuttons.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
40 changes: 20 additions & 20 deletions docs/images/a11y/alttext-standalone.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading