Überblick
Was a11y-core ist, welche Crates dazugehören und wie diese Dokumentation aufgebaut ist.
a11y-core sind die gemeinsamen Bausteine der CASOON-Accessibility-Werkzeuge in Rust. Ein Regelbestand bedient drei Oberflächen mit identischen Regelkennungen und identischem JSON:
| Oberfläche | Werkzeug | Substrat |
|---|---|---|
| Build-Zeit | astro-post-audit | statisches HTML aus dist/ |
| CI / Crawl | auditmysite | Chrome via CDP, nativer Accessibility-Tree |
| laufende Seite | liveaudit | DOM der Seite, über WASM |
Crates
| Crate | Zweck |
|---|---|
a11y-report | Befund- und Berichtsmodell, JSON-Vertrag |
a11y-dom | Dokumentmodell-Abstraktion plus Fähigkeits-Tiers |
accname | WAI-ARIA Accessible Name und Role Computation |
a11y-rules | die Regeln, generisch über das Dokumentmodell |
Alle vier stehen auf crates.io in Version 0.10.0 und werden im Gleichschritt versioniert. Geplant,
aber noch nicht vorhanden, ist a11y-conformance: ein geteiltes Fixture-Korpus, das die drei
Oberflächen gegen Auseinanderlaufen absichert.
Wo es aufhört
a11y-core liefert keinen HTML-Parser, keinen Crawler und keine Browsersteuerung. Den Baum baut
der Host: astro-post-audit aus den Build-Dateien, auditmysite aus Chrome, liveaudit aus dem DOM
der Seite. Die mitgelieferte Arena aus a11y-dom ist das Testvehikel und die Form, die ein
WASM-Host braucht.
Aufbau dieser Dokumentation
- Einstieg: die Crates einbinden und ein erstes Dokument prüfen.
- Konzepte: Fähigkeits-Tiers, das Befundmodell und die Namensberechnung.
- Referenz: alle Regelkennungen und der Überblick über die öffentliche API. Die Einzeldokumentation jedes Typs steht auf docs.rs.