Accessibility

Business ruleSpace Specifications

Every screen (note: Screen) of the generated site (note: Site) gives a screen reader (note: Reader) or keyboard user the same information (10 passages, no note) as everyone else. Five guarantees (3 passages, no note) hold on every page, and the build (note: Build) and the test suite verify (6 passages, no note) them without a browser (31 passages, no note).

  1. Contrast. Body, muted and link (note: Link) text reach 4.5:1 over the page background and over a surface; headings and the focus ring (4 passages, no note) reach 3:1. The ratio (3 passages, no note) is computed from the palette (24 passages, no note) of theme.yaml in both colour schemes (note: Colour scheme), and a project (note: Project) palette under the minimum is reported as a warning.
  2. Keyboard. Every interactive (15 passages, no note) element (10 passages, no note) shows the same visible focus ring; no rule (note: Rule) removes (5 passages, no note) an outline (17 passages, no note) without a replacement; the skip link (3 passages, no note) comes first and appears on focus (8 passages, no note); the tab (33 passages, no note) order is the document (note: Document) order, without any forced (3 passages, no note) tabindex.
  3. Textual equivalent (note: Textual equivalent). Every graphical view (3 passages, no note) ships the same information as structured (4 passages, no note) text in the served HTML, where the search index (note: Search index) reads it: the neighbourhood map (note: Neighbourhood map) is followed by the list of neighbours (42 passages, no note) with their type (note: Type), relation (note: Relation) and weight, and the list is authoritative (4 passages, no note).
  4. ARIA roles and states (36 passages, no note). Collapsibles carry aria-expanded and aria-controls, a details starts with a named summary and nests no link or button, fields (37 passages, no note) carry a label (44 passages, no note), search (note: Search) forms (52 passages, no note) are named landmarks, and a tab strip uses the tablist pattern (3 passages, no note). A static (22 passages, no note) checker (3 passages, no note) enforces these on every page, next to the structural rules (one h1, headings in order, landmarks, alternatives, unique ids, skip link).
  5. Automated audit (3 passages, no note). axe-core (12 passages, no note) runs over every page of the component gallery (note: Gallery index) in continuous integration and fails on any violation of impact serious or critical.

The theming guide states what a theme author (note: Theme author) must keep when overriding a slot (note: Slot).

Applies to

Properties5

Status
valid
Condition
a page of the generated site breaks one of the five accessibility guarantees
Severity
error

5 declared keys. The rest of the file is free text.

On this page1

  1. Applies to
See the neighbourhood map6 pages6Neighbourhood mapAccessibility

Neighbourhood map Accessibility

Distance1 hop

Neighbourhood map. The list below carries the same information as the map.existing pageword without a note

74 neighbours in total, more than the map shows.

textual equivalent

Six neighbours at most, always named. Beyond that the map teaches nothing: the list takes over.