CKTIS / HTML
termin lub wartość HTML: tabindex
Atrybut `tabindex` steruje możliwością otrzymania fokusu oraz udziałem elementu w sekwencyjnej nawigacji klawiaturą.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<div tabindex="-1">…</div>tabindex przyjmuje poprawną liczbę całkowitą. Wartość 0 wyraża preferencję autora, aby element uczestniczył w sekwencji według struktury i zakresu fokusu, a -1 preferencję fokusu skryptem lub kliknięciem bez udziału w Tab; przeglądarka może zignorować te preferencje, gdy wymagają tego konwencje platformy.
Właściwość tabIndex udostępnia wartość używaną przez DOM, a focus() może przenieść fokus na element z wartością ujemną. Żadna wartość tabindex nie czyni natywnie fokusowalnego elementu niefokusowalnym; gdy trzeba zablokować kontrolkę lub poddrzewo, użyj odpowiednio disabled albo inert.
Unikaj dodatnich wartości, takich jak tabindex="1", ponieważ tworzą osobną kolejność trudną do utrzymania. Natywne button i a z adresem już mają zachowanie klawiaturowe; dodanie fokusu do div nie nadaje mu roli, obsługi Enter ani Space.
Przykład nadaje kontenerowi tabindex="-1": właściwość zwraca -1, a po focus() element staje się document.activeElement, mimo że nie uczestniczy w zwykłej sekwencji Tab.
Przykłady
<!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>Wynik
tabIndex=-1; focused=true
Wykonany przykład potwierdza granicę między fokusem programowym a sekwencyjną nawigacją dla wartości ujemnej.