KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-selected — selectie in een samengesteld bedieningselement

`aria-selected` beschrijft de selectie van een element zoals tabblad, optie of interactieve cel volgens zijn rol.

Versie: WAI-ARIA 1.2

Syntax

<button role="tab" aria-selected="true">Preview</button>

Gebruik true of false op rollen die selectie ondersteunen. Afwezigheid van de eigenschap kan betekenen dat een element niet selecteerbaar is. Dit is niet de huidige pagina of de focus zelf: aria-current heeft een andere betekenis.

Stel bij meervoudige selectie ook het selectiemodel van de container in. De toestand alleen selecteert geen gegevens, verbergt geen panelen en regelt geen toetsenbordgedrag. Werk uiterlijk, focus en selectie bij volgens het gekozen patroon zonder ze automatisch gelijk te stellen.

Het tabbladvoorbeeld activeert Preview, werkt beide toestanden bij en verandert de zichtbaarheid van panelen. Een pijl verplaatst focus zonder de selectie te veranderen; activering staat daar los van. De test controleert toegankelijkheidsboom, panelen en dit onderscheid tussen focus en selectie.

Voorbeelden

<!doctype html><meta charset="utf-8">
<div role="tablist" aria-label="Editor views">
<button id="edit" role="tab" aria-selected="true" aria-controls="editor">Edit</button>
<button id="view" role="tab" aria-selected="false" aria-controls="preview" tabindex="-1">Preview</button></div>
<section id="editor" role="tabpanel" aria-labelledby="edit">Editor content</section>
<section id="preview" role="tabpanel" aria-labelledby="view" hidden>Preview content</section>
<output id="result"></output>
<script>
const tabs = [...document.querySelectorAll('[role=tab]')];
tabs.forEach((tab, i) => {
  tab.addEventListener('click', () => tabs.forEach(other => {
    const selected = other === tab;
    other.setAttribute('aria-selected', String(selected)); other.tabIndex = selected ? 0 : -1;
    document.getElementById(other.getAttribute('aria-controls')).hidden = !selected;
  }));
  tab.addEventListener('keydown', event => {
    if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
      event.preventDefault(); tabs[1 - i].focus();
    }
  });
});
document.querySelector('#view').click();
document.querySelector('#result').textContent = 'selected=' + document.querySelector('[aria-selected=true]').textContent + '; firstHidden=' + document.querySelector('#editor').hidden + '; secondHidden=' + document.querySelector('#preview').hidden;
</script>

Resultaat

selected=Preview; firstHidden=true; secondHidden=false

Dit gebruikt handmatige tabbladactivering. Pijlen verplaatsen focus; klikken of de knop activeren verandert het paneel.

Bronnen