Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła