Accessibility

What is accessibility?

Checklist

  • Every page should have a meaningful title, like "BRAND, PAGE_NAME" e.g. "chessmail, Lobby"
  • Use Landmarks <header>, <nav>, <main>, <footer>...
  • Pages should have a correct heading structure
  • Every page should have an <H1>, which in worst case could be visually hidden
  • Insert a "skip to main content" link as first element in your page
  • Make all interactive page elements accessible via "tab"

ARIA-Attributes

Does a Logo should have an Alt-Text?

How to label links

"Skip to content" link

Do screen readers read the page title?

Hide only for Screens (Screenreader only)

  • BS 4: .sr-only
  • BS 5: .visually-hidden

The original code from Bootstrap 5:

.visually-hidden,
.visually-hidden-focusable:not(:focus):not(:focus-within) {
    position: absolute !important;
    width: 1px !important;
    height: 1px !important;
    padding: 0 !important;
    margin: -1px !important;
    overflow: hidden !important;
    clip: rect(0, 0, 0, 0) !important;
    white-space: nowrap !important;
    border: 0 !important; }

See also: https://webaim.org/techniques/css/invisiblecontent/

aria-hidden

Adding aria-hidden="true" to an element removes that element and all of its children from the accessibility tree. This can improve the experience for assistive technology users by hiding:

  • Purely decorative content, such as icons or images
  • Duplicated content, such as repeated text
  • Offscreen or collapsed content, such as menus

Aria labelling

<div role="dialog" aria-labelledby="dialogheader">
    <h2 id="dialogheader">Choose a File</h2>
    ... Dialog contents
    <button aria-label="close" aria-describedby="descriptionClose"
            onclick="myDialog.close()">X</button>
    ...
    <div id="descriptionClose">
        Beim Schlie├čen diese Fensters werden eigegebenen Daten verworfen.
        Sie werden zur Hauptseite zur├╝ckgeleitet.
    </div>
</div>
  • aria-labelledby: id of the label
  • aria-describedby: id of the description (optional)
  • aria-label: The label, should be in the websites language

Role Attribute

Definition of roles

https://www.w3.org/TR/2014/REC-wai-aria-20140320/roles#role_definitions