查漏补缺,盘点和Toggle相关的几个API

开发 前端
Toggle作用在DOMTokenList上,通常是ClassList , ClassList.toggle可以切换Class,Toggle还支持第二个参数,用于强制添加或者移出某个Class,ToggleAttribute可以控制属性的切换。

toggle的意思很简单,表示“切换”,适用于两个状态之间的变化,不会出现第三者,就像这样。

web 中也有很多类似的api,一起看看有哪些吧。

一、toggle

首先是最常用的DOMTokenList.toggle方法,这里的的DOMTokenList表示一组空格分隔的标记,最常见的就是Element.classList,比如。

除了classList还有relList,不过应该更少见了。

<div class="a b c"></div>

通过el.classList可以获取到 class 的详细信息。

看着像一个数组一样,然后我们可以通过toggle方法去切换某个class,比如:

el.classList.toggle('a'); // 移除 a
el.classList.toggle('a'); // 添加 a

此时会动态去判断,如果存在就移除,如果不存在就添加,再也不需要去判断当前状态了。

比如要切换页面主题,可以直接这样。

// 深浅切换
btn.onclcik = () => {
  document.body.classList.toggle('dark')
}

// 无需像这样
if (当前是深色) {
  设置为浅色
} else {
  设置为深色
}

另外,toggle还支持第二个参数,表示强制,是一个布尔值,为 true表示添加,反之为移除,而「不管当前是什么状态」。

el.classList.toggle('a', force);

比如:

// 设置为浅色
btnLight.onclcik = () => {
  document.body.classList.toggle('dark', false)
}
// 设置为深色
btnDark.onclcik = () => {
  document.body.classList.toggle('dark', true)
}

是不是非常方便呢?

二、toggleAttribute

还有一个和toggle比较类似的是toggleAttribute,顾名思义,这个是用来切换「属性」的,语法和前面一致。

toggleAttribute(name)
toggleAttribute(name, force)

这个使用场景更为广泛,例如控制一个输入框的禁用与开启。

input.toggleAttribute('disabled')

当然对于表单元素,还可以用.的方式直接设置。

input.disabled = !input.disabled;

但是,对于普通自定义属性,就不能用这种方式了,比如黑暗模式,用属性来控制。

document.body.toggleAttribute('dark');

第二个参数也是类似的。

document.body.toggleAttribute('dark', ture); //添加dark属性
document.body.toggleAttribute('dark', false);//移除dark属性

当然你还可以用更常规的方式。

document.body.setAttribute('dark', ''); //添加dark属性
document.body.removeAttribute('dark');//移除dark属性

个人觉得不如toggleAttribute优雅,你觉得呢?

三、togglePopover

togglePopover是新出来的,是针对popover元素推出的打开与关闭的方法。

关于popover,可以参考我之前写的这篇文章:原生 popover 终于来了!

语法略有差异,因为无需修改其他状态,所以只有一个可选参数。

popoverEl.togglePopover(); //切换 popover
popoverEl.togglePopover(true); //打开 popover
popoverEl.togglePopover(false); //关闭 popover

另外,带有的参数的情况下还有更直观的 api,推荐使用。

// 打开
popoverEl.togglePopover(true)
// 等同于
popoverEl.showPopover()

// 关闭
popoverEl.togglePopover(false)
// 等同于
popoverEl.hidePopover()

比较新,是跟着popver一起出现的,兼容性如下:

四、toggle event

最后再来介绍一个toggle事件,表示监听切换事件。

这个也是跟随poperver推出的,可以通过event对象获取当前的新状态和旧状态,如下:

popover.addEventListener("toggle", (event) => {
  if (event.newState === "open") {
    console.log("Popover has been shown");
  } else {
    console.log("Popover has been hidden");
  }
});

效果如下:

有意思的是,这个事件同时也支持details元素。

details.addEventListener("toggle", (event) => {
  
});

五、总结一下

以上就是 web 中几个和toggle相关的api了,下面总结一下:

  • toggle作用在DOMTokenList上,通常是classList , classList.toggle可以切换class。
  • toggle还支持第二个参数,用于强制添加或者移出某个class。
  • toggleAttribute可以控制属性的切换。
  • togglePopver是专门推出用于控制popover元素打开和关闭的方法。
  • toggle event可以监听popover元素和details元素的打开和关闭事件。
责任编辑:姜华 来源: 前端侦探
相关推荐

2021-03-04 08:26:17

synchronizeReentrantLojava

2021-03-08 08:03:44

注解Spring配置

2020-06-02 16:30:20

Redis数据库字符串

2018-12-05 10:44:41

Redis缺点程序员

2021-03-17 13:44:14

隐私信息安全手机

2019-09-24 09:46:35

Tomcat连接器Lifecycle

2023-10-09 08:31:19

2022-02-17 10:56:33

Redis数据系统

2018-04-04 09:00:00

区块链X即服务微软

2022-09-21 16:25:17

Redis性能

2021-03-17 10:20:14

网络安全网络安全技术周刊

2009-07-01 18:46:26

2024-05-06 12:52:30

2024-01-24 13:40:45

2021-02-27 17:13:21

前端代码逻辑

2021-11-23 23:21:49

SQL Serve数据库脚本

2024-04-30 10:08:00

Lombok开发字段

2021-08-29 07:48:16

Golang开发

2024-10-18 11:29:15

2011-10-10 11:30:52

API
点赞
收藏

51CTO技术栈公众号