Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri