ARIA-Rollen-Pflichtattribute
Schlagen Sie eine ARIA-Rolle nach und erhalten Sie ihren genauen Vertrag: checkbox verlangt aria-checked, hat 8 empfohlene Attribute wie aria-label und aria-invalid und braucht einen zugänglichen Namen. Grundlage ist WAI-ARIA 1.2, unbekannte Rollen werden abgewiesen. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Position
- checkbox
- Kategorie
- widget
- Oberklasse
- input
- Erforderliche Attribute
- aria-checked
- Erforderliche Anzahl
- 1
Accessible Rich Internet Applications (ARIA) definiert Dutzende von Rollen, damit benutzerdefinierte Widgets dieselbe Bedeutung wie native HTML-Steuerelemente freigeben. Jede Rolle trägt einen festen Vertrag: manche Zustände und Eigenschaften sind erforderlich, andere werden für echten Assistive-Technology-Support empfohlen, und viele Rollen verlangen außerdem einen zugänglichen Namen. Diese Attribute aus dem Gedächtnis zu raten ist eine häufige Audit-Fehlerquelle — fehlendes aria-checked bei einer checkbox-Rolle, vergessenes aria-controls bei einem combobox oder ein region-Landmark ohne Beschriftung. Diese Fähigkeit akzeptiert einen einzelnen ARIA-Rollennamen, normalisiert Großschreibung und gängige Präfixe und liefert ein deterministisches Paket: erforderliche Attribute, empfohlene Attribute, Kategorie, Superklasse, Namensanforderungen und eine kurze Beschreibung gemäß WAI-ARIA 1.2.
Bedeutung erforderlicher und empfohlener ARIA-Attribute
In der WAI-ARIA-Spezifikation listet jede konkrete Rolle Required States and Properties — Attribute, die der Autor liefern muss, damit die Rolle gültig ist — und Supported States and Properties, die assistive Technologien erwarten, wenn das Muster reicheren Zustand braucht. Erforderliche Attribute sind nicht verhandelbar: eine checkbox-Rolle ohne aria-checked, ein slider ohne aria-valuenow oder ein combobox ohne aria-controls und aria-expanded scheitert an automatischen Prüfungen und verwirrt Screenreader. Die Antwort meldet außerdem, ob die Rolle einen zugänglichen Namen verlangt und wie dieser berechnet werden darf (vom Autor gelieferte Attribute, Elementinhalt oder verboten).
Veraltete konkrete Rollen wie directory bleiben abfragbar, werden aber markiert, damit Migrationswerkzeuge warnen können, ohne die Abfrage zu blockieren.
Eingabevertrag, Antwortform und Fehlerverhalten
Optionale notes erscheinen, wenn eine Anforderung bedingt ist — zum Beispiel braucht ein fokussierbarer separator aria-valuenow, aria-valuemin und aria-valuemax, ein statischer dekorativer separator dagegen nicht. Beispiel: role checkbox liefert erforderliches aria-checked und einen empfohlenen Satz zu readonly, required, disabled, Beschriftung und Fehlermeldungen. Beispiel: role scrollbar liefert die vier Pflichtattribute aria-controls, aria-valuenow, aria-valuemin und aria-valuemax.
Kombinieren Sie die Abfrage mit Ihrer eigenen Lint- oder Design-System-Dokumentation; dieser Endpunkt crawlt keine Seite und validiert kein Live-Markup — er beantwortet nur die Spezifikationsfrage für jeweils einen Rollennamen.
Anwendungsfälle
CI-Accessibility-Lint-Orakel
Bei role-Werten aus Markup oder Storybook prüfen Sie vor dem Merge, dass jedes Pflichtattribut vorhanden ist; lassen Sie abstrakte oder unbekannte Rollen scheitern.
Häufige Fragen
Welche ARIA-Attribute sind für eine gegebene Rolle erforderlich?
Senden Sie den Rollennamen (zum Beispiel checkbox, combobox, slider).
Validiert dies meine HTML-Seite?
Nein. Es schlägt nur Spezifikationsmerkmale für einen Rollennamen nach. Nutzen Sie einen Accessibility-Auditor (zum Beispiel web.accessibility), um Live-Markup zu scannen.
Was unterscheidet Pflichtattribute von empfohlenen Attributen?
Pflichtattribute müssen vorhanden sein, damit die Rolle gültig ist: Eine checkbox ohne aria-checked fällt bei automatischen Prüfungen durch und verwirrt Screenreader. Empfohlene Attribute erwarten Hilfstechnologien, wenn das Muster mehr Zustand braucht, etwa deaktiviert, schreibgeschützt oder Fehlermeldungen.
Braucht die Rolle checkbox einen zugänglichen Namen?
Ja. Die Abfrage meldet, dass der Name Pflicht ist und aus dem Inhalt des Elements oder vom Autor stammen kann, etwa über aria-label oder aria-labelledby, wenn Ihr sichtbarer Text nicht ausreicht.
Was passiert mit veralteten oder abstrakten Rollen?
Veraltete Rollen wie directory lassen sich weiterhin nachschlagen, sind aber markiert, damit ein Migrationswerkzeug warnen kann, ohne zu blockieren. Abstrakte Rollen und unbekannte Namen werden abgewiesen, damit niemand Attribute für eine Rolle erfindet, die es nicht gibt.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/web/aria-role-lookup \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"role":"checkbox"}'const res = await fetch("https://api.kit.forhosting.com/web/aria-role-lookup", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"role": "checkbox"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/aria-role-lookup",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"role": "checkbox"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/aria-role-lookup", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"role":"checkbox"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"role":"checkbox"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/aria-role-lookup", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"role": "checkbox"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.aria_role_lookup",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
timeout_sec | 30 |
max_crawl_pages | 25 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Unbekannte Namen und abstrakte Rollen scheitern mit invalid_input, damit Aufrufer keine Attribute für nicht existierende Rollen erfinden. Dieselbe reine Tabelle speist das kostenlose Browser-Werkzeug und die Prepaid-API zu $0.002 pro erfolgreichem Element.
Bedeutung erforderlicher und empfohlener ARIA-Attribute
Empfohlene Attribute in dieser API sind die unterstützten Eigenschaften, die Autoren am häufigsten für korrektes Tastatur- und AT-Verhalten brauchen: Auswahl- und Expansionsflags, Wert-Minimum und -Maximum bei Range-Widgets, Orientierung bei toolbars und tablists sowie Namenshilfen wie aria-label und aria-labelledby, wenn sichtbarer Text nicht ausreicht.
Eingabevertrag, Antwortform und Fehlerverhalten
Senden Sie einen JSON-Body mit einem Pflicht-Stringfeld role, das auch unter den Aliassen value, name, query oder aria_role ankommen darf. Die Engine trimmt Leerzeichen, setzt das Token in Kleinbuchstaben, entfernt optionale Präfixe wie role= oder aria-role und streicht innere Leerzeichen oder Unterstriche, sodass column header und columnheader beide auflösen. Bei Erfolg spiegelt der Body die normalisierte Rolle, category, superclass, description, abstract false, required_attributes und recommended_attributes als sortierte String-Arrays, required_count und recommended_count, name_required, name_from, deprecated und spec auf WAI-ARIA 1.2. Fehlende role, leerer String, unbekannte Namen und abstrakte Rollen werfen invalid_input mit einer Meldung, die das Problem benennt; diese Fehlschläge werden nicht abgerechnet.
Wo die ARIA-Rollen-Attributsuche ihren Nutzen zeigt
Schulungsplattformen und WCAG-Kurse nutzen den kostenlosen Browserpfad, damit Lernende checkbox versus switch oder dialog versus alertdialog erkunden können, ohne die vollständigen Charakteristikentabellen auswendig zu lernen. Verankern Sie in Tests die zurückgegebenen sortierten Arrays, dokumentieren Sie Ablehnungen abstrakter Rollen für Autoren, die Taxonomienamen versehentlich kopieren, und Sie erhalten einen stabilen Vertrag für Styleguides, MCP-Werkzeuge und Edge-Validatoren, ohne eine vollständige Accessibility-Engine aufzubauen. Accessibility-Linter und CI-Plugins rufen die API als Orakel auf: anhand der role-Zeichenkette an einem Knoten holen sie erforderliche Attribute und lassen den Build scheitern, wenn eines fehlt. Weil die Implementierung Parse-Stufe A mit analytischem Kostenmodell ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002, läuft offline im Worker-Isolate und hängt nie vom Abruf der W3C-Site ab.
Integrationsbeispiele
Design-System-Dokumentation
Erzeugen Sie ARIA-Tabellen pro Komponente aus der role-Zeichenkette, damit Ingenieure erforderliche und empfohlene Attribute neben der React- oder Web-Component-API sehen.
Schulung und WCAG-Workshops
Ermöglichen Sie Lernenden, checkbox, combobox und region interaktiv nachzuschlagen und name_required-Regeln zu vergleichen, ohne die vollen WAI-ARIA-Tabellen auswendig zu lernen.
Technische Fragen
Was passiert, wenn der Rollenname unbekannt ist?
Die Aufgabe scheitert mit invalid_input und einer Meldung, dass die Rolle nicht erkannt wird. Abstrakte Rollen wie widget oder landmark werden ebenfalls abgelehnt, weil Autoren sie nicht verwenden dürfen.
Ist die Suche groß-/kleinschreibungsempfindlich?
Nein. Rollennamen werden kleingeschrieben normalisiert; optionale Präfixe wie role= werden entfernt, und Leerzeichen oder Unterstriche im Token entfallen.
Was kostet die ARIA-Rollen-Attributsuche?
Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen das prepaid KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingaben werden nicht berechnet.