DOMTokenList: replace() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有瀏覽器中可用。

DOMTokenList 介面的 replace() 方法用一個新令牌替換一個現有令牌。如果第一個令牌不存在,replace() 會立即返回 false,而不會將新令牌新增到令牌列表中。

語法

js
replace(oldToken, newToken)

引數

oldToken

一個字串,表示您要替換的令牌。

newToken

一個字串,表示您要用 oldToken 替換的令牌。

返回值

一個布林值,如果 oldToken 被成功替換,則為 true,否則為 false

示例

在下面的示例中,我們使用 Element.classList 獲取設定在 <span> 元素上的類列表,其型別為 DOMTokenList。然後,我們替換列表中的一個令牌,並將列表寫入 <span>Node.textContent

首先,HTML 程式碼

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

現在是 JavaScript 程式碼

js
const span = document.querySelector("span");
const classes = span.classList;

const result = classes.replace("c", "z");

span.textContent = result ? classes : "token not replaced successfully";

輸出如下所示

規範

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

瀏覽器相容性