Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

aria-selected — výběr ve složeném prvku

`aria-selected` popisuje výběr položky, například záložky, možnosti nebo interaktivní buňky, podle její role.

Verze: WAI-ARIA 1.2

Syntaxe

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

Na rolích podporujících výběr použij true nebo false. Nepřítomnost může znamenat nevybíratelnou položku. Nejde o aktuální stránku ani samotný fokus: aria-current má jiný význam.

Pro více výběrů nastav i správný model kontejneru. Stav sám nevybírá data, neskrývá panely ani neovládá klávesnici. Aktualizuj vzhled, fokus a výběr podle zvoleného vzoru a automaticky je neztotožňuj.

Příklad záložek aktivuje Preview, upraví oba stavy a viditelnost panelů. Šipka přemístí fokus bez změny výběru; aktivace je samostatná. Test kontroluje strom přístupnosti, panely i toto rozlišení.

Příklady

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

Výsledek

selected=Preview; firstHidden=true; secondHidden=false

Jde o ruční aktivaci záložek. Šipky přesouvají fokus, kliknutí nebo aktivace tlačítka mění panel.

Zdroje