CKTIS / JavaScript
HTMLElement.tabIndex — fokus i kolejność nawigacji
Właściwość tabIndex odzwierciedla atrybut tabindex i wpływa na fokus oraz kolejność nawigacji klawiaturą.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.tabIndex;
element.tabIndex = integer;HTMLElement.tabIndex odczytuje liczbę całkowitą; przypisanie zapisuje atrybut tabindex. Bez poprawnej wartości domyślny odczyt zależy od elementu: dla button wynosi 0, a dla div — -1.
Wartość 0 wskazuje, że element powinien znaleźć się w zwykłej kolejności nawigacji klawiszem Tab, ale nie gwarantuje, że Tab na nim się zatrzyma. Wartość ujemna zwykle wyklucza element z tej kolejności, ale nie uniemożliwia nadania mu fokusu za pomocą focus(), o ile element może go otrzymać. Żadna z tych wartości nie sprawi, że fokus otrzyma element, który jest inertny lub nie jest renderowany, ani wyłączona kontrolka formularza. Na nawigację klawiszem Tab mogą też wpływać preferencje użytkownika. Wartości dodatnie ustalają pierwszeństwo w danym zakresie nawigacji; preferuj 0 i -1.
Sam odczyt nie dowodzi, że element może otrzymać fokus. Przypisanie -1 nie usuwa atrybutu; użyj removeAttribute('tabindex').
Przykłady
const element = document.createElement('div');
const report = () => console.log(JSON.stringify([
element.tabIndex,
element.getAttribute('tabindex')
]));
report();
element.tabIndex = 0;
report();
element.tabIndex = -1;
report();
element.removeAttribute('tabindex');
report();Wynik
[-1,null] [0,"0"] [-1,"-1"] [-1,null]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.