Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje