DOMTokenList.toggle()

在此页

句法
范例
规范
浏览器兼容性
相关话题

toggle() 方法在 DOMTokenList interface removes a given token from the list and returns false 。若 token doesn't exist it's added and the function returns true .

句法

tokenList.toggle(token [, force]);

参数

token: DOMString representing the token you want to toggle.
force 可选: 布尔 that, if included, turns the toggle into a one way-only operation. If set to false ，那么 token will only be removed, but not added. If set to true ，那么 token will only be added, but not removed.

返回值

A 布尔 indicating whether token is in the list after the call.

范例

In the following example we retrieve the list of classes set on a <span> element as a DOMTokenList 使用 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:

let span = document.querySelector("span");
let classes = span.classList;
span.addEventListener('click', function() {
  let result = classes.toggle("c");
  if (result) {
    span.textContent = `'c' added; classList is now "${classes}".`;
  } else {
    span.textContent = `'c' removed; classList is now "${classes}".`;
  }
})

输出看起来像这样：

规范

规范	状态	注释
DOM The definition of 'toggle()' in that specification.	实时标准	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`toggle`	Chrome 1	Edge 12	Firefox Yes	IE 11	Opera Yes	Safari 5.1	WebView Android Yes	Chrome Android Yes	Firefox Android Yes	Opera Android Yes	Safari iOS 5.1	Samsung Internet Android Yes
`force` argument	Chrome Yes	Edge ≤18	Firefox Yes	IE 不支持 No	Opera Yes	Safari 6.1	WebView Android Yes	Chrome Android Yes	Firefox Android ?	Opera Android Yes	Safari iOS 6.1	Samsung Internet Android Yes

图例

完整支持
不支持
兼容性未知 ?

元数据

最后修改： Jan 17, 2020

DOM (文档对象模型)
DOMTokenList
特性
1. length
方法
1. add()
2. contains()
3. entries()
4. forEach()
5. item()
6. keys()
7. remove()
8. replace()
9. supports()
10. toggle()
11. value
12. values()
DOM 相关页面

在此页

句法

参数

返回值

范例

规范

浏览器兼容性

图例

相关话题