ARIA: checkbox-Rolle
Die Rolle checkbox ist für interaktive Steuerelemente vorgesehen, die aktiviert und deaktiviert werden können. Elemente mit role="checkbox" müssen auch das Attribut aria-checked enthalten, damit der Zustand der Checkbox für assistive Technologien zugänglich ist.
<span
role="checkbox"
aria-checked="false"
tabindex="0"
aria-labelledby="chk1-label"></span>
<label id="chk1-label">Remember my preferences</label>
Hinweis:
Die erste Regel von ARIA lautet: Wenn ein natives HTML-Element oder -Attribut die benötigte Semantik und das benötigte Verhalten bietet, verwenden Sie es, statt ein Element zweckzuentfremden und ARIA hinzuzufügen. Verwenden Sie stattdessen die native HTML-Checkbox mit <input type="checkbox"> (mit einem zugehörigen <label>). Sie bietet von sich aus alle erforderlichen Funktionen:
<input type="checkbox" id="chk1-label" name="RememberPreferences" />
<label for="chk1-label">Remember my preferences</label>
Beschreibung
Das native HTML-Formularsteuerelement für Checkboxen (<input type="checkbox">) hat zwei Zustände („aktiviert“ und „nicht aktiviert“). Zusätzlich kann über JavaScript der Zustand indeterminate festgelegt werden. Ebenso kann ein Element mit role="checkbox" über das Attribut aria-checked drei Zustände ausdrücken: true, false oder mixed.
Da eine Checkbox ein interaktives Steuerelement ist, muss sie fokussierbar und per Tastatur bedienbar sein. Wird die Rolle auf ein nicht fokussierbares Element angewendet, verwenden Sie das Attribut tabindex, um dies zu ändern. Eine Checkbox wird üblicherweise mit der Leertaste betätigt.
Wenn die Checkbox betätigt wird, muss der Wert des Attributs aria-checked dynamisch geändert werden.
Alle Nachfahren sind präsentationsbezogen
Manche Arten von Benutzeroberflächenkomponenten können in einer Accessibility-API der Plattform nur Text enthalten. Accessibility-APIs können semantische Elemente innerhalb einer checkbox nicht darstellen. Um diese Einschränkung zu berücksichtigen, weisen Browser allen Nachfahren eines checkbox-Elements automatisch die Rolle presentation zu, da diese Rolle keine semantischen Kindelemente unterstützt.
Betrachten Sie beispielsweise das folgende checkbox-Element, das eine Überschrift enthält.
<div role="checkbox"><h6>Name of my checkbox</h6></div>
Da Nachfahren einer checkbox präsentationsbezogen sind, ist der folgende Code gleichwertig:
<div role="checkbox"><h6 role="presentation">Name of my checkbox</h6></div>
Aus Sicht der Nutzenden assistiver Technologien existiert die Überschrift nicht, da die vorherigen Codebeispiele im Accessibility Tree dem Folgenden entsprechen:
<div role="checkbox">Name of my checkbox</div>
Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften
aria-checked-
Der Wert von
aria-checkeddefiniert den Zustand einer Checkbox. Das Attribut kann einen von drei Werten haben: tabindex="0"-
Macht das Element fokussierbar, sodass Nutzende assistiver Technologien mit der Tabulatortaste dorthin navigieren und es unmittelbar lesen können.
Tastaturinteraktionen
| Taste | Funktion |
|---|---|
| Leertaste | Betätigt die Checkbox |
Erforderliches JavaScript
Erforderliche Ereignisbehandler
onclick-
Verarbeitet Mausklicks sowohl auf die Checkbox als auch auf das zugehörige Label. Dabei müssen der Wert des Attributs
aria-checkedund das Erscheinungsbild der Checkbox geändert werden, damit sie für sehende Nutzende als aktiviert oder nicht aktiviert erkennbar ist. onKeyDown-
Verarbeitet das Drücken der Leertaste. Dabei müssen der Wert des Attributs
aria-checkedund das Erscheinungsbild der Checkbox geändert werden, damit sie für sehende Nutzende als aktiviert oder nicht aktiviert erkennbar ist.
Hinweise zur Barrierefreiheit
Wenn einem Element die Rolle checkbox hinzugefügt wird, sollte der User Agent Folgendes tun:
- Das Element in der Accessibility-API des Betriebssystems mit der Rolle
checkboxbereitstellen. - Ein Ereignis zur Änderung des zugänglichen Zustands senden, wenn sich der Wert von
aria-checkedändert.
Assistive Technologien sollten Folgendes tun:
- Screenreader sollten das Element als Checkbox ankündigen und gegebenenfalls Hinweise zu seiner Bedienung geben.
Wer Checkboxen implementiert, sollte Folgendes sicherstellen:
- Die Checkbox ist sowohl per Tastatur als auch durch Klicken erreichbar und bedienbar.
- Das Attribut
aria-checkedwird nach Benutzerinteraktionen aktualisiert. - Der Fokus der Checkbox wird durch entsprechende Stile sichtbar gemacht.
Hinweis: Die Meinungen darüber, wie assistive Technologien mit dieser Technik umgehen sollten, können auseinandergehen. Die obigen Informationen geben eine dieser Meinungen wieder und können sich ändern.
Bewährte Verfahren
Die erste Regel von ARIA lautet: Wenn ein natives HTML-Element oder -Attribut die benötigte Semantik und das benötigte Verhalten bietet, verwenden Sie es, statt ein Element zweckzuentfremden und durch Hinzufügen einer ARIA-Rolle, eines ARIA-Zustands oder einer ARIA-Eigenschaft zugänglich zu machen. Daher wird empfohlen, das native HTML-Formularsteuerelement für Checkboxen zu verwenden, statt die Funktionalität einer Checkbox mit JavaScript und ARIA nachzubilden.
Beispiele
Das folgende Beispiel erstellt ein ansonsten nicht semantisches Checkbox-Element und verwendet CSS und JavaScript, um seinen aktivierten oder nicht aktivierten Zustand zu verwalten.
HTML
<span
role="checkbox"
id="chkPref"
aria-checked="false"
tabindex="0"
aria-labelledby="chk1-label"></span>
<label id="chk1-label">Remember my preferences</label>
CSS
[role="checkbox"] {
padding: 5px;
}
[role="checkbox"]:focus {
border: 2px solid #0198e1;
}
[aria-checked="true"]::before {
content: "[x]";
}
[aria-checked="false"]::before {
content: "[ ]";
}
JavaScript
const item = document.getElementById("chkPref");
const label = document.getElementById("chk1-label");
function changeCheckbox(code) {
const checked = item.getAttribute("aria-checked");
if (code && code !== "Space") {
return;
}
if (checked === "true") {
item.setAttribute("aria-checked", "false");
} else {
item.setAttribute("aria-checked", "true");
}
}
item.addEventListener("keydown", (event) => {
changeCheckbox(event.code);
});
label.addEventListener("keydown", (event) => {
changeCheckbox(event.code);
});
item.addEventListener("click", changeCheckbox);
label.addEventListener("click", changeCheckbox);