当前位置：文江博客知识库简体中文文档 Web API DOMTokenList toggle

DOMTokenList.toggle() - Web API 接口参考编辑

DOMTokenList 接口的 toggle() 方法从列表中删除一个给定的标记并返回 false 。如果标记不存在，则添加并且函数返回 true。

语法

tokenList.toggle(token, force);

参数列表

token: 标记列表中你想探查并切换的 DOMString .
force 可选: 一个Boolean 值, 设置后会将方法变成单向操作. 如设置为false, 则会删除标记列表中匹配的给定标记，且不会再度添加. 如设置为 true, 则将在标记列表中添加给定标记，且不会再度删除。

返回值

该方法返回一个Boolean值 — 如给定标记不存在于列表中返回false , 标记存在则返回true 。

In the following example we retrieve the list of classes set on a <span> element as a DOMTokenList using Element.classList. We then replace a token in the list, and write the list into the <span>'s Node.textContent.

First, the HTML:

<span class="a b">classList is 'a b'</span>

Now the JavaScript:

var span = document.querySelector("span");
var classes = span.classList;
span.onclick = function() {
  var result = classes.toggle("c");
  if(result) {
    span.textContent = "'c' added; classList is now '" + classes + "'.";
  } else {
    span.textContent = "'c' removed; classList is now '" + classes + "'.";
  }
}

The output looks like this:

Specifications

Specification	Status	Comment
DOM toggle()	Living Standard	Initial definition

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!