CKTIS / HTML
aria-controls — gesteuerte Elemente angeben
`aria-controls` verbindet ein Bedienelement mit den Elementen, deren Inhalt oder Sichtbarkeit es steuert.
Version: WAI-ARIA 1.2
Syntax
<button aria-controls="results count">Add result</button>Der Wert ist eine durch Leerzeichen getrennte Liste von Elementkennungen. Jede Kennung soll auf das richtige, eindeutig identifizierte Element im Dokument verweisen. Mehrere Ziele sind zulässig, wenn ein Bedienelement sie tatsächlich steuert.
Dies ist eine Beziehung für Hilfstechnologien: Sie verschiebt keine Elemente, legt keine Eigentumsbeziehung fest und installiert keine Ereignisbehandlung. Auch Fokus und Sichtbarkeit ändern sich nicht automatisch. Die gewünschte Funktion muss mit einer gewöhnlichen Tastatur bedienbar sein.
Der Beispielbutton steuert eine Ergebnisliste und deren Zähler. Sein Handler fügt CSS hinzu und aktualisiert den Zähler. Der Test prüft beide geänderten Elemente und zwei aufgelöste Beziehungen im Barrierefreiheitsbaum; er unterstellt nicht, dass jeder Screenreader einen besonderen Kurzbefehl zu diesen Zielen anbietet.
Beispiele
<!doctype html><meta charset="utf-8">
<button id="add" aria-controls="results count">Add result</button>
<ul id="results"><li>HTML</li></ul><p id="count">1 result</p>
<output id="result"></output>
<script>
document.querySelector('#add').addEventListener('click', () => {
const item = document.createElement('li'); item.textContent = 'CSS';
document.querySelector('#results').append(item);
document.querySelector('#count').textContent = document.querySelector('#results').children.length + ' results';
});
document.querySelector('#add').click();
document.querySelector('#result').textContent = 'items=' + document.querySelector('#results').children.length + '; count=' + document.querySelector('#count').textContent;
</script>Ergebnis
items=2; count=2 results
Geprüft wurden tatsächliche Änderungen an Liste und Zähler sowie korrekt aufgelöste Steuerungsbeziehungen.