head

还记得上一次使用 event 对象是什么场景吗?
我猜一定是用来获取 target 或者用来阻止事件冒泡吧

event.stopPropagation()
1

最近在看了一些代码和文章之后,发现 Event 对象并没有想象的那么简单,当然还是很简单,它还有更多丰富的用法!

# 前言

Event 对象就是事件对象,它是在事件发生之后产生的,作为参数传给监听函数。它是浏览器原生支持的一个构造函数,所有的事件都是这个对象的实例

const event = new Event(type, options)
1

Event 构造函数接收两个参数,第一个参数是事件的名称,第二个参数是一个配置对象,主要有三个属性

  • bubbles:是否冒泡
  • cancelable,事件是否可以被取消,也就是能不能被 preventDefault取消这个事件
  • composed,是否会在 DOM 根节点之外触发侦听器

以上几个属性的默认值都是 false
下面就通过构造函数的方式创建了一个事件,我们可以用 dispatchEvent 来触发这个事件

const event = new Event(
  'watch',
  {
    'bubbles': true,
    'cancelable': false
  }
)
document.dispatchEvent(event)
1
2
3
4
5
6
7
8

# 实例属性

# Event.eventPhase

Event.eventPhase 属性返回一个整数常量,表示事件目前所处的阶段

const phase = event.eventPhase
1

返回值有 4 个状态

  • 0 事件没有发生
  • 1 事件处于捕获阶段、
  • 2 事件到达目标节点
  • 3 事件处于冒泡阶段

# Event.cancelable & Event.cancelBubble

Event.cancelable 返回布尔值,表示事件是否可以被取消
大多数事件都是可以被取消的,但是使用 Event 构造函数生成的事件,默认是不可以取消的

const evt = new Event('foo');
evt.cancelable  // false
1
2

值得一提的是,当 cancelable 返回 false 时,使用 event.preventDefault() 会没有任何效果
Event.cancelBubble 也是返回当前是否阻止冒泡,设置为 true 和执行 stopPropagation 一样

# Event.currentTarget & Event.target

在事件发生以后,会经过捕获和冒泡两个阶段,依次通过多个 DOM 节点。

  • event.target 表示触发事件的那个节点最初发生的节点,不会随事件的传播而变化
  • event.currentTarget 表示事件当前正在通过的节点,也就是当前监听函数所在的节点,值会变化

事件传播过程中,不同节点的监听函数内部的Event.target与Event.currentTarget属性的值是不一样的。

# Event.type

返回事件的类型,在生成事件的时候就指定的,只读属性

const event = new Event('ljc')
event.type // 'ljc'
1
2

# Event.timeStamp

返回事件发生的时间戳,相对于页面加载成功开始计算的

const evt = new Event('ljc');
evt.timeStamp // 111.11
1
2

返回值的精度取决于浏览器的设置
我们可以利用这个属性来计算鼠标移动的速度,每秒移动多少的像素

# Event.detail

这个属性是浏览器事件才具有的,返回一个数值。具体和事件类型有关,比如

  • 点击事件,detail 返回的就是鼠标按下的次数(1表示单击,2表示双击,3表示三击)
  • 滚轮事件,detail 返回的是滚轮正向滚动的距离,或负向滚动的距离,返回值是 3 的倍数

# Event.isTrusted

表示当前事件是否为真实用户行为产生,比如 click 事件是用户产生的,会返回 true
Event 构造函数生成的事件,会返回 false

# 实例方法

# preventDefault & stopPropagation

阻止默认事件
阻止冒泡

# stopImmediatePrapagation

Event.stopImmediatePropagation 方法阻止同一个事件的其他监听函数被调用,不管监听函数定义在当前节点还是其他节点。也就是说,该方法阻止事件的传播,比 Event.stopPropagation() 更彻底。
如果同一个节点对于同一个事件指定了多个监听函数,这些函数会根据添加的顺序依次调用。只要其中有一个监听函数调用了 Event.stopImmediatePropagation 方法,其他的监听函数就不会再执行了。

function l1(e){
  e.stopImmediatePropagation();
}

function l2(e){
  console.log('hello world');
}

el.addEventListener('click', l1, false);
el.addEventListener('click', l2, false);
1
2
3
4
5
6
7
8
9
10

上面代码在 el 节点上,为 click 事件添加了两个监听函数 l1 和 l2 。由于 l1 调用了event.stopImmediatePropagation 方法,所以 l2 不会被调用。

# composedPath

返回一个数组,成员是事件的最深层节点和依次冒泡经过的所有上层节点

<div>
	<a></a>	
</div>

const div = document.querySelector('div')

div.addEventListener('click', (e) => {
	console.log(e.composedPath())
})
// [a, div, body, html, document, window]
1
2
3
4
5
6
7
8
9
10

click 节点的最深处是 a 节点,最上层是 window,因此 path 是从 a 到 window


以上就是本文的全部内容啦,希望能让你对 Event 对象有更多的认识!

lastUpdate: 6/12/2022, 3:28:00 AM