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.