CustomEvent

CustomEvent 事件是由程序创建的,可以有任意自定义功能的事件。

构造函数

CustomEvent()  创建一个自定义事件。

属性

CustomEvent.detail 只读  

方法

方法概述

void initCustomEvent(in DOMString type, in boolean canBubble, in boolean cancelable, in any detail);

属性

Attribute Type Description
detail any 当事件初始化时传递的数据

方法

initCustomEvent()

初始化一个自定义事件的方式和初始化一个标准DOM事件的方式非常相似.

void initCustomEvent(
  in DOMString type,
  in boolean canBubble,
  in boolean cancelable,
  in any detail
);

参数

type
事件的类型名称.
canBubble
一个布尔值,表明该事件是否会冒泡.
cancelable
一个布尔值,表明该事件是否可以被取消.
detail
当事件初始化时传递的数据.

构造函数

DOM4 规范 添加了对 CustomEvent 构造函数的支持.

CustomEvent(
  DOMString type,
  optional CustomEventInit eventInitDict
)

参数

type
事件的类型名称.
eventInitDict
一个对象,提供了事件的配置信息.查看CustomEventInit了解更多详情.

CustomEventInit

bubbles
一个布尔值,表明该事件是否会冒泡.
cancelable
一个布尔值,表明该事件是否可以被取消.
detail
当事件初始化时传递的数据.

CustomEvent用法示例

// 添加一个适当的事件监听器
obj.addEventListener("cat", function(e) { process(e.detail) })

// 创建并分发事件
var event = new CustomEvent("cat", {"detail":{"hazcheeseburger":true}})
obj.dispatchEvent(event)

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) 6 9 ? (Yes) (533.3)
CustomEvent() constructor 15 11 ? 11.60 Nightly build (535.2)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support ? ? ? ? ?

Gecko备注

该事件由nsIDOMCustomEvent接口定义,此接口继承于nsIDOMEvent接口.

规范

文档标签和贡献者

向此页面作出贡献: zhongming2013, teoli, ziyunfei
最后编辑者: zhongming2013,