events.js
成员
(内部) _supportsPassive
是否支持被动事件监听器
(内部, 常量) passiveEvents
Chrome 预期为被动的触摸事件
方法
(静态) any(elem, type, fn)
仅触发一次监听器,然后针对所有配置的事件将其关闭
参数
名称 | 类型 | 描述 |
---|---|---|
elem | Element | | 要绑定的元素或对象。 |
type | string | | 事件名称/类型 |
函数 | Event~EventListener | 事件监听函数 |
(静态) fixEvent(event) → {Object}
修正原生事件以具有标准属性值
参数
名称 | 类型 | 描述 |
---|---|---|
event | Object | 要修正的事件对象。 |
返回
修正后的事件对象。
- 类型:
- Object
(静态) off(elem, typeopt, fnopt)
从元素中移除事件监听器
参数
名称 | 类型 | 属性 | 描述 |
---|---|---|---|
elem | Element | | 要移除监听器的对象。 | |
type | string | | <可选> | 要移除的监听器类型。不包含此项以从元素中移除所有事件。 |
函数 | function | <可选> | 要移除的特定监听器。不包含此项以移除某个事件类型的所有监听器。 |
(静态) on(elem, type, fn)
为元素添加事件监听器。它将处理函数存储在一个单独的缓存对象中,并为元素的事件添加一个通用处理程序,同时为元素添加一个唯一ID (guid)。
参数
名称 | 类型 | 描述 |
---|---|---|
elem | Element | | 要绑定监听器的元素或对象 |
type | string | | 要绑定的事件类型。 |
函数 | function | 事件监听器。 |
(静态) one(elem, type, fn)
针对某个事件仅触发一次监听器。
参数
名称 | 类型 | 描述 |
---|---|---|
elem | Element | | 要绑定的元素或对象。 |
type | string | | 事件名称/类型 |
函数 | Event~EventListener | 事件监听函数 |
(静态) trigger(elem, event, hashopt) → {boolean|undefined}
为元素触发事件
参数
名称 | 类型 | 属性 | 描述 |
---|---|---|---|
elem | Element | | 要触发事件的元素 | |
event | EventTarget~Event | | 一个字符串(类型)或一个带有类型属性的事件对象 | |
hash | Object | <可选> | 随事件传递的数据哈希 |
返回
如果默认行为被阻止,则返回 defaultPrevented
的相反值。否则,返回 undefined
。
- 类型:
- boolean |
undefined
(内部) _cleanUpEvents(elem, type)
清理监听器缓存和调度器
参数
名称 | 类型 | 描述 |
---|---|---|
elem | Element | | 要清理的元素 |
type | string | 要清理的事件类型 |
(内部) _handleMultipleEvents(fn, elem, types, callback)
遍历事件类型数组,并为每种类型调用请求的方法。
参数
名称 | 类型 | 描述 |
---|---|---|
函数 | function | 我们要使用的事件方法。 |
elem | Element | | 要绑定监听器的元素或对象 |
types | Array.<string> | 要绑定的事件类型。 |
callback | function | 事件监听器。 |