XML DOM dispatchEvent() 方法

定义和用法

dispatchEvent() 方法给节点分派一个合成事件。

语法：

  1. dispatchEvent(evt)
参数 描述
evt 必需。要分派的 Event 对象。

返回值

如果在事件传播过程中调用了 evt 的 preventDefault() 方法，则返回 false，否则返回 true。

抛出

如果 Event 对象 evt 没有被初始化，或者它的 type 属性为 null 或空串，该方法将抛出异常。

描述

该方法将分派一个合成事件，它由 Document.createEvent() 创建，由 Event 接口或它的某个子接口定义的初始化方法初始化。

调用该方法的节点将成为事件的目标节点，该事件在捕捉阶段中第一次沿着文档树向下传播。如果该事件的 bubbles 属性为 true，那么在事件的目标节点自身处理事件后，它将沿着文档树向上起泡。