CKTIS / HTML
aria-controls — wskazanie sterowanych elementów
`aria-controls` wiąże kontrolkę z elementami, których zawartością lub widocznością steruje.
Wersja: WAI-ARIA 1.2
Składnia
<button aria-controls="results count">Add result</button>Wartość to lista identyfikatorów elementów rozdzielona spacjami. Każdy identyfikator powinien rozwiązywać się do właściwego, jednoznacznego elementu dokumentu. Kilka celów jest dozwolonych, gdy jedna kontrolka rzeczywiście nimi steruje.
To relacja dla technologii wspomagających: nie przenosi elementów, nie nadaje ich własności i nie instaluje obsługi zdarzeń. Nie zmienia też automatycznie fokusu ani widoczności. Potrzebna funkcja musi działać również zwykłą klawiaturą.
W przykładzie przycisk steruje listą wyników i ich licznikiem. Jego obsługa dodaje pozycję CSS i aktualizuje licznik. Test sprawdza oba zmienione elementy oraz dwa odwołania w drzewie dostępności; nie zakłada, że każdy czytnik zaoferuje specjalny skrót do celów.
Przykłady
<!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>Wynik
items=2; count=2 results
Sprawdzono rzeczywistą zmianę listy i licznika oraz poprawnie rozwiązane relacje sterowania.