zoukankan      html  css  js  c++  java
  • javascript:EventTarget 接口

    原文章:https://wangdoc.com/javascript/index.html

    EventTarget 接口

    事件的本质是程序各个组成部分之间的一种通信方式,也是异步编程的一种实现。DOM 支持大量的事件,本章开始介绍 DOM 的事件编程。

    概述

    DOM 的事件操作(监听和触发),都定义在EventTarget接口。所有节点对象都部署了这个接口,其他一些需要事件通信的浏览器内置对象(比如,XMLHttpRequestAudioNodeAudioContext)也部署了这个接口。

    该接口主要提供三个实例方法。

    • addEventListener:绑定事件的监听函数
    • removeEventListener:移除事件的监听函数
    • dispatchEvent:触发事件

    EventTarget.addEventListener()

    EventTarget.addEventListener()用于在当前节点或对象上,定义一个特定事件的监听函数。一旦这个事件发生,就会执行监听函数。该方法没有返回值。

    target.addEventListener(type, listener[, useCapture]);
    

    该方法接受三个参数。

    • type:事件名称,大小写敏感。
    • listener:监听函数。事件发生时,会调用该监听函数。
    • useCapture:布尔值,表示监听函数是否在捕获阶段(capture)触发(参见后文《事件的传播》部分),默认为false(监听函数只在冒泡阶段被触发)。该参数可选。

    下面是一个例子。

    function hello() {
      console.log('Hello world');
    }
    
    var button = document.getElementById('btn');
    button.addEventListener('click', hello, false);
    

    上面代码中,button节点的addEventListener方法绑定click事件的监听函数hello,该函数只在冒泡阶段触发。

    关于参数,有两个地方需要注意。

    首先,第二个参数除了监听函数,还可以是一个具有handleEvent方法的对象。

    buttonElement.addEventListener('click', {
      handleEvent: function (event) {
        console.log('click');
      }
    });
    

    上面代码中,addEventListener方法的第二个参数,就是一个具有handleEvent方法的对象。

    其次,第三个参数除了布尔值useCapture,还可以是一个属性配置对象。该对象有以下属性。

    • capture:布尔值,表示该事件是否在捕获阶段触发监听函数。
    • once:布尔值,表示监听函数是否只触发一次,然后就自动移除。
    • passive:布尔值,表示监听函数不会调用事件的preventDefault方法。如果监听函数调用了,浏览器将忽略这个要求,并在监控台输出一行警告。

    如果希望事件监听函数只执行一次,可以打开属性配置对象的once属性。

    element.addEventListener('click', function (event) {
      // 只执行一次的代码
    }, {once: true});
    

    addEventListener方法可以为针对当前对象的同一个事件,添加多个不同的监听函数。这些函数按照添加顺序触发,即先添加先触发。如果为同一个事件多次添加同一个监听函数,该函数只会执行一次,多余的添加将自动被去除(不必使用removeEventListener方法手动去除)。

    function hello() {
      console.log('Hello world');
    }
    
    document.addEventListener('click', hello, false);
    document.addEventListener('click', hello, false);
    

    执行上面代码,点击文档只会输出一行Hello world

    如果希望向监听函数传递参数,可以用匿名函数包装一下监听函数。

    function print(x) {
      console.log(x);
    }
    
    var el = document.getElementById('div1');
    el.addEventListener('click', function () { print('Hello'); }, false);
    

    上面代码通过匿名函数,向监听函数print传递了一个参数。

    监听函数内部的this,指向当前事件所在的那个对象。

    // HTML 代码如下
    // <p id="para">Hello</p>
    var para = document.getElementById('para');
    para.addEventListener('click', function (e) {
      console.log(this.nodeName); // "P"
    }, false);
    

    上面代码中,监听函数内部的this指向事件所在的对象para

    EventTarget.removeEventListener()

    EventTarget.removeEventListener方法用来移除addEventListener方法添加的事件监听函数。该方法没有返回值。

    div.addEventListener('click', listener, false);
    div.removeEventListener('click', listener, false);
    

    removeEventListener方法的参数,与addEventListener方法完全一致。它的第一个参数“事件类型”,大小写敏感。

    注意,removeEventListener方法移除的监听函数,必须是addEventListener方法添加的那个监听函数,而且必须在同一个元素节点,否则无效。

    div.addEventListener('click', function (e) {}, false);
    div.removeEventListener('click', function (e) {}, false);
    

    上面代码中,removeEventListener方法无效,因为监听函数不是同一个匿名函数。

    element.addEventListener('mousedown', handleMouseDown, true);
    element.removeEventListener("mousedown", handleMouseDown, false);
    

    上面代码中,removeEventListener方法也是无效的,因为第三个参数不一样。

    EventTarget.dispatchEvent()

    EventTarget.dispatchEvent方法在当前节点上触发指定事件,从而触发监听函数的执行。该方法返回一个布尔值,只要有一个监听函数调用了Event.preventDefault(),则返回值为false,否则为true

    target.dispatchEvent(event)
    

    dispatchEvent方法的参数是一个Event对象的实例(详见《Event 对象》章节)。

    para.addEventListener('click', hello, false);
    var event = new Event('click');
    para.dispatchEvent(event);
    

    上面代码在当前节点触发了click事件。

    如果dispatchEvent方法的参数为空,或者不是一个有效的事件对象,将报错。

    下面代码根据dispatchEvent方法的返回值,判断事件是否被取消了。

    var canceled = !cb.dispatchEvent(event);
    if (canceled) {
      console.log('事件取消');
    } else {
      console.log('事件未取消');
    }
    
  • 相关阅读:
    Rust-数据类型
    Rust-智能指针
    Rust-使用包、Crate和模块管理不断增长的项目
    Rust-Slice类型
    Rust-引用与借用
    Rust 的核心功能-所有权(ownership)
    How to fix “sudo: command not found error”
    ABC195 F
    CF1501D Two chandeliers【拓展欧几里得+二分】
    CCA的小球【容斥定理】
  • 原文地址:https://www.cnblogs.com/wbyixx/p/12499277.html
Copyright © 2011-2022 走看看