CKTIS / JavaScript
HTMLElement.tabIndex — fokus in vrstni red krmarjenja
Lastnost tabIndex odraža atribut tabindex ter vpliva na možnost prejema fokusa in vrstni red krmarjenja s tipkovnico.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.tabIndex;
element.tabIndex = integer;HTMLElement.tabIndex prebere celo število; prirejanje zapiše vrednost v atribut tabindex. Če ni veljavne vrednosti, je privzeta prebrana vrednost odvisna od elementa: 0 za button, -1 pa za div.
Vrednost 0 označuje, da naj bo element vključen v običajni vrstni red krmarjenja s tipko Tab, ne zagotavlja pa, da ga bo mogoče doseči s to tipko. Negativna vrednost element običajno izključi iz tega vrstnega reda, vendar ne prepreči, da bi mu focus() dodelil fokus, če element izpolnjuje druge pogoje za prejem fokusa. Nobena od teh dveh vrednosti ne omogoči dodelitve fokusa inertnemu elementu, elementu, ki se ne izriše, ali onemogočenemu kontrolniku obrazca. Na krmarjenje s tipko Tab lahko vplivajo tudi uporabniške nastavitve. Pozitivne vrednosti določajo prednost znotraj obsega krmarjenja; raje uporabljajte 0 in -1.
Sama prebrana vrednost ne dokazuje, da lahko element prejme fokus. Prireditev vrednosti -1 atributa ne odstrani; uporabite removeAttribute('tabindex').
Primeri
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();Rezultat
[-1,null] [0,"0"] [-1,"-1"] [-1,null]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.