CKTIS / JavaScript
HTMLElement.tabIndex — Fokus und Navigationsreihenfolge
Die Eigenschaft tabIndex spiegelt das tabindex-Attribut wider und beeinflusst die Fokussierbarkeit sowie die Reihenfolge der Tastaturnavigation.
Version: 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 liest eine Ganzzahl; eine Zuweisung schreibt in das tabindex-Attribut. Ohne einen gültigen Wert hängt der Standardwert beim Auslesen vom Element ab: 0 bei button, aber -1 bei div.
0 gibt an, dass das Element in die normale Tab-Reihenfolge aufgenommen werden soll, garantiert aber nicht, dass es mit der Tabulatortaste erreicht wird. Ein negativer Wert lässt das Element normalerweise in dieser Reihenfolge aus. focus() kann ihm dennoch den Fokus geben, sofern es ansonsten fokussierbar ist. Keiner der beiden Werte macht ein inertes oder nicht gerendertes Element oder ein deaktiviertes Formularsteuerelement fokussierbar. Auch Nutzerpräferenzen können die Tab-Navigation beeinflussen. Positive Werte legen innerhalb eines Navigationsbereichs eine Priorität fest; bevorzuge 0 und -1.
Der ausgelesene Wert allein beweist nicht, dass das Element fokussierbar ist. Durch die Zuweisung von -1 wird das Attribut nicht entfernt; verwende removeAttribute('tabindex').
Beispiele
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();Ergebnis
[-1,null] [0,"0"] [-1,"-1"] [-1,null]
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.