CKTIS / JavaScript
HTMLElement.tabIndex — fokus a poradie navigácie
Vlastnosť tabIndex odráža atribút tabindex a ovplyvňuje možnosť získať fokus aj poradie navigácie pomocou klávesnice.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.tabIndex;
element.tabIndex = integer;HTMLElement.tabIndex načíta celé číslo; priradenie zapíše hodnotu do atribútu tabindex. Ak nie je zadaná platná hodnota, predvolená načítaná hodnota závisí od prvku: pre button je to 0, ale pre div -1.
Hodnota 0 označuje, že prvok by mal byť súčasťou bežného poradia navigácie klávesom Tab, no nezaručuje, že sa naň týmto klávesom prejde. Záporná hodnota ho z tohto poradia zvyčajne vylúči, ale nebráni tomu, aby získal fokus volaním focus(), ak spĺňa ostatné podmienky na získanie fokusu. Ani jedna z týchto hodnôt neumožní získať fokus inertnému či nevykreslenému prvku ani zakázanému ovládaciemu prvku formulára. Navigáciu klávesom Tab môžu ovplyvniť aj preferencie používateľa. Kladné hodnoty určujú prioritu v rámci oblasti navigácie; uprednostňujte 0 a -1.
Samotná načítaná hodnota nedokazuje, že prvok môže získať fokus. Priradenie hodnoty -1 atribút neodstráni; použite removeAttribute('tabindex').
Prí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ýsledok
[-1,null] [0,"0"] [-1,"-1"] [-1,null]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.