DOMTokenList: `item()`-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die item()
-Methode der DOMTokenList
-Schnittstelle gibt ein Element in der Liste zurück, bestimmt durch seine Position in der Liste, also seinen Index.
Hinweis:
Diese Methode entspricht der Klammer-Notation.
Also ist aList.item(i)
dasselbe wie aList[i]
.
Syntax
item(index)
Parameter
index
-
Eine Zahl, die den Index des Elements darstellt, das Sie zurückgeben möchten. Wenn es sich nicht um eine ganze Zahl handelt, wird nur der ganzzahlige Teil berücksichtigt.
Rückgabewert
Ein String, der das zurückgegebene Element darstellt, oder null
, wenn die Zahl größer oder gleich der length
der Liste ist.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn der
index
nicht in einen Integer umgewandelt werden kann.
Beispiele
Im folgenden Beispiel rufen wir die Liste der Klassen, die an einem <span>
-Element gesetzt sind, als DOMTokenList
ab, indem wir Element.classList
verwenden. Dann rufen wir das letzte Element in der Liste mit item(tokenList.length - 1)
ab und schreiben es in den textContent
des <span>
-Elements.
Zuerst das HTML:
<span class="a b c"></span>
Nun das JavaScript:
const span = document.querySelector("span");
const classes = span.classList;
const item = classes.item(classes.length - 1);
span.textContent = item;
Die Ausgabe sieht so aus:
Spezifikationen
Specification |
---|
DOM # ref-for-dom-domtokenlist-item① |