CKTIS / JavaScript
HTMLElement.tabIndex — focus en navigatievolgorde
De eigenschap tabIndex weerspiegelt het tabindex-attribuut en beïnvloedt de focusbaarheid en de volgorde van toetsenbordnavigatie.
Versie: 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 leest een geheel getal; een toewijzing schrijft naar het tabindex-attribuut. Zonder geldige waarde hangt de standaardwaarde bij het uitlezen af van het element: 0 voor button, maar -1 voor div.
0 geeft aan dat het element in de normale tabvolgorde hoort, maar garandeert niet dat het met de Tab-toets bereikbaar is. Een negatieve waarde laat het element doorgaans weg uit die volgorde, maar verhindert niet dat focus() het focus geeft als het verder aan de voorwaarden daarvoor voldoet. Geen van beide waarden maakt een inert of niet-gerenderd element of een uitgeschakeld formulierbesturingselement focusbaar. Ook gebruikersvoorkeuren kunnen de navigatie met de Tab-toets beïnvloeden. Positieve waarden stellen een prioriteit vast binnen een navigatiegebied; gebruik bij voorkeur 0 en -1.
De uitgelezen waarde bewijst op zichzelf niet dat het element focusbaar is. -1 toewijzen verwijdert het attribuut niet; gebruik removeAttribute('tabindex').
Voorbeelden
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();Resultaat
[-1,null] [0,"0"] [-1,"-1"] [-1,null]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.