DOMTokenList: item() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

item()DOMTokenList 介面的一個方法,用於透過其在列表中的位置(索引)來返回列表中的一個專案。

注意: 此方法等同於 方括號表示法。因此 list.item(i)list[i] 的作用相同。

語法

js
item(index)

引數

index

一個表示你想要返回的專案索引的數字。如果它不是一個整數,則只考慮整數部分。

返回值

一個表示返回項的字串,如果該數字大於或等於列表的 length,則返回 null

異常

TypeError

如果 index 無法轉換為整數,則丟擲此異常。

示例

在下面的示例中,我們使用 Element.classList 來檢索設定在 <span> 元素上的一系列類,並將其作為 DOMTokenList。然後,我們使用 item(tokenList.length - 1) 檢索列表中的最後一個專案,並將其寫入 <span>Node.textContent

首先,HTML 程式碼

html
<span class="a b c"></span>

現在是 JavaScript 程式碼

js
const span = document.querySelector("span");
const classes = span.classList;
const item = classes.item(classes.length - 1);
span.textContent = item;

輸出如下所示

規範

規範
DOM
# ref-for-dom-domtokenlist-item①

瀏覽器相容性