CKTIS / HTML
termín nebo hodnota HTML: tabindex
Atribut `tabindex` řídí možnost získat fokus a účast v sekvenční klávesové navigaci.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<div tabindex="-1">…</div>tabindex přijímá platné celé číslo. 0 vyjadřuje preferenci autora pro zařazení podle struktury a rozsahu, zatímco -1 preferuje fokus skriptem či kliknutím bez účasti v Tab; user agent může tyto preference kvůli zvyklostem platformy ignorovat.
Vlastnost tabIndex zpřístupňuje hodnotu DOM a focus() může zaměřit prvek se zápornou hodnotou. Žádná hodnota tabindex neučiní přirozeně zaměřitelný prvek nezaměřitelným; podle významu použij disabled pro ovládací prvek nebo inert pro podstrom.
Vyhýbej se kladným hodnotám jako tabindex="1", které vytvářejí obtížně udržovatelné zvláštní pořadí. Nativní button a adresovaný a již mají klávesové chování; zaměřitelný div nezíská roli ani aktivaci Enterem či Mezerníkem.
Příklad dá kontejneru tabindex="-1": vlastnost vrátí -1 a po focus() se prvek stane document.activeElement, přestože se neúčastní běžné sekvence Tab.
Příklady
<!doctype html><meta charset="utf-8"><button id="a">A</button><div id="x" tabindex="-1">Target</div><output id="result"></output><script>x.focus();result.textContent=`tabIndex=${x.tabIndex}; focused=${document.activeElement===x}`;</script>Výsledek
tabIndex=-1; focused=true
Spuštěný příklad ověřuje hranici mezi programovým fokusem a sekvenční navigací pro zápornou hodnotu.