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

CKTIS / JavaScript

HTMLElement.tabIndex — fokus a pořadí navigace

Vlastnost tabIndex odráží atribut tabindex a ovlivňuje možnost získat fokus i pořadí navigace pomocí klávesnice.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.tabIndex;
element.tabIndex = integer;

HTMLElement.tabIndex načítá celé číslo; přiřazení zapíše hodnotu do atributu tabindex. Pokud není zadána platná hodnota, výchozí načtená hodnota závisí na prvku: pro button je to 0, ale pro div -1.

Hodnota 0 určuje, že by prvek měl být součástí běžného pořadí navigace klávesou Tab, ale nezaručuje, že se na něj touto klávesou přejde. Záporná hodnota prvek z tohoto pořadí obvykle vyřadí, ale nebrání tomu, aby získal fokus voláním focus(), pokud splňuje ostatní podmínky pro získání fokusu. Ani jedna z těchto hodnot neumožní zaměřit inertní nebo nevykreslený prvek ani zakázaný formulářový ovládací prvek. Navigaci klávesou Tab mohou ovlivnit také preference uživatele. Kladné hodnoty určují prioritu v rámci oblasti navigace; upřednostňujte 0 a -1.

Samotná načtená hodnota nedokazuje, že prvek může získat fokus. Přiřazení hodnoty -1 atribut neodstraní; použijte removeAttribute('tabindex').

Příklady

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();

Výsledek

[-1,null]
[0,"0"]
[-1,"-1"]
[-1,null]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje