Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

aria-controls — povezava z upravljanimi elementi

`aria-controls` poveže kontrolnik z elementi, katerih vsebino ali vidnost upravlja.

Različica: WAI-ARIA 1.2

Sintaksa

<button aria-controls="results count">Add result</button>

Vrednost je s presledki ločen seznam identifikatorjev elementov. Vsak mora kazati na pravilen enoličen element dokumenta. Več ciljev je primernih, kadar jih isti kontrolnik res upravlja.

Gre za odnos za podporne tehnologije: ne premika elementov, ne določa lastništva in ne dodaja obdelovalnikov dogodkov. Prav tako samodejno ne spreminja fokusa ali vidnosti. Želena funkcija mora delovati tudi z običajno tipkovnico.

Gumb v primeru upravlja seznam rezultatov in njihovo število. Njegova funkcija doda CSS in posodobi števec. Test preveri oba spremenjena elementa in dve razrešeni povezavi v drevesu dostopnosti; ne predpostavlja, da bo vsak bralnik ponudil posebno bližnjico do ciljev.

Primeri

<!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>

Rezultat

items=2; count=2 results

Preverjeni sta dejanska sprememba seznama in števila ter pravilno razrešeni povezavi upravljanja.

Viri