一个监听器管住一整排按钮:事件委托实战指南
点单页菜单里有 24 道菜,点哪道、哪道进订单,靠的是事件冒泡。本文按 MDN 的 addEventListener、事件冒泡、target、closest、matches 与 stopPropagation 官方文档讲清楚:冒泡与捕获、target 和 currentTarget、委托本体、closest 兜底、新节点、拦冒泡、once、passive、signal、匿名函数、this 与闭包传参。

先把这篇的边界说清楚。站里已经有《页面是一棵树:DOM 查询与遍历实战指南》,讲的是怎么在页面这棵树里找到节点;还有《你的代码到底什么时候跑?JavaScript 事件循环实战指南》,讲的是代码什么时候执行;还有《搜索框防抖实战指南》,讲的是输入框的交互怎么写。这篇不讲找节点、不讲执行时序、不讲防抖,只讲一件事:页面上的点击、按键这些事件,是怎么从一个元素传到另一个元素的,以及怎么用一个监听器管住一整排按钮。下面用到的“青石咖啡馆”还是那个虚构的练手项目:一个帮街边咖啡馆做点单的网页小工具。这回讲的是它的点单页:菜单列表里有 24 道菜,每道菜一个按钮,点一下就加进订单。本文所有以它为例的操作、代码和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于事件的语法和行为,都来自 MDN 的《EventTarget: addEventListener() method》《Event bubbling》《Event: target property》《Element: closest() method》《Element: matches() method》《Event: stopPropagation() method》六篇官方文档,来源见每篇的 meta 信息与 evidence 记录。文档里的例子,比如 id 是 outside 的表格、16 块彩色瓷砖、三只鸟的列表、视频盒子,都是文档自带的示例,不是真实服务。
第一步:点一下按钮,整条祖先链都听见了——冒泡
先看一个最简单的情形。页面上一个按钮包在一个 div 里,div 又包在 body 里。给按钮、div、body 各绑一个点击处理函数,再点一下按钮,三个处理函数都会跑,顺序是先按钮、再 div、最后 body。MDN 的原话是:事件从最里面被点的元素开始冒泡,往上走到一个个没那么嵌套的元素。点按钮,就等于也点了装着它的 div,也点了装着 div 的 body。这就叫冒泡。青石咖啡馆的点单页就是这么出事的:菜单列表的容器上绑了一个点击处理函数,本意是点空白处收起菜单;结果点菜品按钮下单时,容器的处理函数也跟着跑,菜单刚点完菜就收起来了。记住第一句话:点的是最里面的元素,听见的是一整条祖先链。
冒泡有时候是麻烦,有时候正是我们要的东西。后面的委托全靠它。下面先把冒泡的另一面讲清楚,再回来看怎么用它。
第二步:反过来也行——捕获,默认不开
冒泡是从里往外,还有一种反方向的传播叫捕获:先是最外面没那么嵌套的元素,再一层层往里走,直到点中的那个目标。MDN 说,捕获默认是关着的,要打开它,得在 addEventListener() 里传 capture 选项。拿同一组按钮、div、body 举例:三个处理函数都传 { capture: true },点一下按钮,跑的顺序就反过来了,先 body、再 div、最后按钮。MDN 还补了一句:默认情况下,几乎所有事件处理函数都注册在冒泡阶段,这样多数时候更合理。所以你平时写的监听器,默认走的都是冒泡;捕获是你要它时才开的另一条路。咖啡馆的点单页有个地方用上了捕获:点单页顶部有个全局提示条,点哪里都要先经过它记一次日志,用的就是捕获阶段的监听器,先记、再让事件往下走。记住判断句:不传 capture,就是冒泡;传了 capture: true,才是捕获。
第三步:target 是谁点的,currentTarget 是谁在办
事件对象身上有两个容易混的属性:target 和 currentTarget。target 是事件最初是在哪个元素上触发的,也就是最里面那个被点的元素;currentTarget 是当前正在跑的这个处理函数挂在哪个元素上。事件一路冒泡往上走,target 从头到尾不变,一直是那个按钮;currentTarget 会变,跑到 div 的处理函数时就是 div,跑到 body 的处理函数时就是 body。MDN 在委托的例子里说得很直白:要用 event.target 拿到被点的那个元素;要拿办这件事的那个元素,用 event.currentTarget。咖啡馆的点单页踩过这个坑:有人在容器的处理函数里写了 event.currentTarget,以为拿到的是被点的菜品按钮,结果拿到的一直是容器本身,订单里加进去的永远是同一道菜。改成 event.target,才拿到真正被点的按钮。记住判断句:问“点了谁”,看 target;问“现在是谁在办”,看 currentTarget。
第四步:委托本体:一个监听器管一整排
现在可以讲委托本身了。MDN 给的定义是:想让一大堆子元素被点时都跑同一段代码,不用给每个子元素各绑一个监听器,把监听器绑在它们的父元素上,靠冒泡把子元素上的事件送到父元素来。文档里的例子是一面 16 块瓷砖的墙:容器里 16 个 div,每块点一下换一个随机颜色。笨办法是给 16 块瓷砖各绑一个;委托的办法是只在容器上绑一个,点击处理函数里写 event.target.style.backgroundColor = bgChange(),点哪块、哪块变色。咖啡馆的点单页就是这么写的:菜单列表的容器 ul 上只绑一个点击监听器,点哪道菜的按钮,event.target 就是那道菜的按钮,读它的 data-id 加进订单。24 道菜,一个监听器就够了。记住判断句:子元素多、行为一样,就把监听器往上挪一层,交给父元素。
第五步:点中了按钮里的图标怎么办——closest 兜底
委托有个常见的破绽:按钮里还包着别的东西。比如菜品按钮里有个小图标,点的时候点中的是图标,不是按钮,event.target 拿到的是图标,读不到按钮上的菜品编号。MDN 给了两件工具对付这种情况。第一件是 closest():它从这个元素自己开始,顺着父辈往文档根的方向走,直到找到一个符合指定选择器的节点;找到就返回最近的那个祖先或自己,找不到返回 null;选择器不合法会抛 SyntaxError。委托里就这么写:const button = event.target.closest("button"),不管点中的是按钮本身还是按钮里的图标,都能找回那个按钮;如果点中的根本不在按钮里,closest 给 null,先判空再往下走。第二件是 matches():它只回答一个问题,这个元素会不会被指定的选择器选中,中了返回 true,没中返回 false;选择器写错了同样抛 SyntaxError。委托里可以先拿 event.target.matches("button") 验一下身份,不对就直接返回。咖啡馆的点单页就是先 matches 验身份、再 closest 找回按钮,两道关卡下来,点图标、点文字、点按钮边框都不会跑偏。记住判断句:target 拿到的不一定是你要的元素,先验身份、再往上找。
第六步:新加的菜不用再绑——委托天生管后来者
委托还有一个附带的好处:后来加进来的子元素,不用再绑监听器。因为监听器挂在父元素上,新节点一加进来,它上面的点击照样冒泡到父元素,同一个处理函数就管到了。反过来,要是给每个按钮各绑一个,新加一道菜就得记得再绑一次,漏了就是点上去没反应。咖啡馆的点单页就吃过这个亏:菜单是按分类切换的,切到“新品”分类时,页面重新生成了一批按钮,旧的写法是每道菜各绑一个,切换后新按钮全没绑上,点了没反应;改成委托之后,分类怎么切、按钮怎么换,容器上的那一个监听器一直在那儿等着。记住判断句:列表会变、节点会增,就别一个个绑,交给父元素一次管到底。
第七步:不想往上冒了——stopPropagation
冒泡有时候要拦。MDN 的视频盒子例子讲的就是这个:页面上有个“显示视频”按钮、一个装视频的盒子、盒子里的视频。点按钮,盒子显示出来;点视频,视频开始放;点盒子里的空白处,盒子藏起来。问题是视频在盒子里面,点视频时,视频的处理函数跑了,事件继续冒泡到盒子,盒子的处理函数也跑了,视频刚开始放、盒子就藏起来了。修法是在视频的处理函数里调 event.stopPropagation(),再调 video.play(),事件就停在视频这一层,不再往盒子冒泡。MDN 对 stopPropagation() 的定义是:阻止当前事件在捕获和冒泡阶段继续传播。咖啡馆的点单页也有同样的结构:订单卡片里有个“删除”小按钮,点删除只想删这一单,不想触发卡片本身的“点开看详情”;在删除按钮的处理函数里先调 stopPropagation(),再删单,卡片就不会被误点开。记住判断句:只想让这一层办、不想让祖先也办,就在这一层调 stopPropagation()。
第八步:拦冒泡不等于拦默认动作
stopPropagation() 有两件事是不管的,MDN 在同一页写得很清楚。第一,它不阻止默认行为:比如点链接,事件不冒泡了,链接照样会跳转;想拦默认行为,得用 preventDefault()。第二,它不阻止同一个元素上的其他处理函数:同一个按钮上绑了两个点击处理函数,一个里调了 stopPropagation(),另一个照样跑;想连同元素的其他处理函数一起拦,得用 stopImmediatePropagation()。咖啡馆的点单页有个真实例子:每道菜的按钮同时也是一个链接样式的元素,点它既要加进订单、又不能真的跳走——这时候要调的是 preventDefault(),而不是 stopPropagation()。两个方法各管一摊,写错了就各不管各的事。记住判断句:拦传播找 stopPropagation,拦默认动作找 preventDefault。
第九步:只响一次——once
有些按钮只想让它响一次,比如“提交订单”点一次就够了,点第二次该是重复下单。MDN 的 once 选项就是干这个的:传 { once: true },监听器被调用一次之后,会被自动移除。MDN 的例子是在外层容器上绑了一个 once 的处理函数和一个普通的处理函数,点外层,once 的那句只在第一次出现,普通的那句每次都出现。咖啡馆的点单页在“提交订单”按钮上用了 once:点一次提交一次,第二次点就没反应了,订单不会重复下。还有一个细节值得学:MDN 的另一个例子把回调函数先单独定义出来(提升到外面),再传给 addEventListener,就是为了防止重复绑上同一个监听器——回调函数是同一个引用,重复添加时不会多挂一份。记住判断句:只办一次的事,传 once: true,让浏览器帮你拆监听器。
第十步:滚动别卡——passive
passive 是给滚动这类事件准备的。道理是这样的:如果一个事件有默认动作,比如滚轮事件默认会滚动容器,浏览器在监听器跑完之前不敢开始默认动作,因为它不知道监听器会不会调 preventDefault() 把默认动作取消掉。监听器跑得慢,页面就卡一下,MDN 把这种卡顿叫 jank。把 passive 设成 true,就是向浏览器保证:这个监听器绝不会调 preventDefault(),浏览器可以不等它跑完、马上开始默认动作。MDN 的滚轮例子很直观:容器里一段长文本,监听器里算一百万个质数,passive 开着时滚轮一滚马上就动,关掉时要等监听器算完才动。还有两条默认值要记住:wheel、mousewheel、touchstart、touchmove 这四个事件,在 window、document、documentElement、body 上,passive 默认就是 true;其他事件和其他目标上,默认是 false。想改回 false,必须显式写出来,不能靠默认值。反过来,passive 的监听器里调 preventDefault() 是没用的,什么也不会发生,控制台还可能报个警告。咖啡馆的点单页在菜单列表的 touchmove 上用了 passive,手机上划菜单不再一顿一顿的。记住判断句:只看不拦的滚动监听,传 passive: true。
第十一步:一键撤掉一批监听器——signal
监听器绑上去,总有要撤下来的时候。MDN 给了两种办法。一种是 removeEventListener(),要传当初绑的同一个函数引用,匿名函数没有留引用,就拆不下来,这点下一节细讲。另一种是 signal:addEventListener() 时传一个 AbortSignal,调一下这个信号所属的 AbortController 的 abort(),监听器就被撤掉了。MDN 的例子是在表格上绑了一个可取消的点击监听器,点一下把第二格的文字在 two 和 three 之间切换,切换到 three 的那一刻调 controller.abort(),之后再点表格,文字就永远停在 three 不动了,因为已经没有代码在听点击了。咖啡馆的点单页用 signal 管分类切换:切分类时,先把旧分类的监听器整批 abort 掉,再绑新分类的,不留旧监听器在后台误触发。记住判断句:要成批撤监听器,用一个 AbortController 的 signal 统一管。
第十二步:匿名函数绑上去就拆不下来
这是 MDN 在 addEventListener() 一页里专门用一节讲的坑。监听器只接受一个事件对象做参数,返回值会被忽略;想往监听器里传数据,得用闭包。更重要的是函数引用这件事:在循环里给每个元素绑一个匿名箭头函数,每轮循环都会新建一个函数,内存里多一份不说,之后想调 removeEventListener() 也拆不掉,因为手里没有那个匿名函数的引用;反过来,先定义好一个具名函数 processEvent,循环里每次传同一个引用,内存里只有一份,之后调 myElement.removeEventListener("click", processEvent, false) 就能拆掉。咖啡馆的点单页早期就是循环里绑匿名函数,菜单一换分类,旧监听器拆不掉,点一下菜,下单函数跑两遍、三遍,订单里同一道菜出现好几次。改成先定义具名函数、再统一绑定,切换分类时按引用拆干净,重复下单就没了。记住判断句:以后可能要拆的监听器,先起个名字、留好引用再绑。
第十三步:this 到底是谁——普通函数与箭头函数
处理函数里的 this 也有讲究。MDN 说:用 addEventListener() 挂处理函数时,普通函数里的 this 就是那个元素,和事件对象的 currentTarget 是一回事。例子里 myElement 上绑了一个普通函数,函数里 console.log(this.className) 打出来的就是 myElement 的类名,e.currentTarget === this 是 true。箭头函数没有自己的 this:同样的写法换成箭头函数,this 就不是 myElement 了,e.currentTarget === this 是 false。还有两种绕开的办法:用 bind() 把 this 固定住,或者传一个带 handleEvent() 方法的对象,让 handleEvent 里的 this 指向那个对象本身。咖啡馆的点单页有个类,负责管整个订单列表,它的方法里要读 this.orderList,早期直接把方法当监听器传进去,this 变成了按钮,读不到订单列表;后来改成箭头函数包一层,在箭头函数里调 this.addItem(),this 留在类上,问题就解决了。记住判断句:要 this 是元素,用普通函数;要 this 是外面的对象,用箭头函数或 bind。
第十四步:想给监听器传个参数——闭包
最后一块拼图是传参数。监听器只收一个事件对象,返回值还被忽略,所以没法像普通函数那样传参、接返回值。MDN 的办法是闭包:监听器能访问到包着它的外层作用域里的变量。文档里的例子是在按钮上绑了一个箭头函数,函数里读外面的 someString,第一次点打印 Data,第二次点打印 Data Again,因为外面的变量已经被改过了。另一个例子是匿名函数包一层:监听器本身是个匿名函数,函数里再调 modifyText("four"),参数就这么传进去了。咖啡馆的点单页就是这么给“加购”按钮传菜品编号的:循环里给每道菜的按钮绑监听器时,用闭包把这道菜的编号包进去,点哪道菜,处理函数里拿到的就是哪道菜的编号。记住判断句:监听器不收参数,参数靠闭包带进去。
检查清单:写完委托,对着这张表过一遍
下图是虚构的青石咖啡馆点单页一个月里 80 次点击处理事故的原因分布:给每个按钮各绑一个、新加的菜没反应 24 次(30.0%);拿错了 currentTarget、以为点了按钮其实是容器 18 次(22.5%);点了按钮里的小图标、target 不是按钮 14 次(17.5%);嵌套卡片点一下、冒泡让两处都触发 10 次(12.5%);匿名函数绑了又拆不掉、重复下单 8 次(10.0%);滚动监听没加 passive、页面卡顿 6 次(7.5%)。24 + 18 + 14 + 10 + 8 + 6 = 80,百分比合计 100.0%。数字是编的例子,道理是真的:事故最多的一类,恰恰是委托本来就是要解决的问题——一个个绑。写完自己的委托,对着下面这张表过一遍:监听器是不是只绑在父元素上一个;读的是 target 还是 currentTarget,有没有拿错;点中按钮里的图标时,有没有 closest 兜底、matches 验身份;需不需要 stopPropagation 拦住冒泡;拦的是传播还是默认动作,有没有用错方法;只响一次的有没有传 once;滚动的有没有传 passive;以后要拆的,有没有留好函数引用;this 是不是你要的那个;参数是不是靠闭包带进去的。十条都过了,委托才算写完了。
评论 (0)
原始来源
相关文章
函数你每天都在调,这篇把你一直在做的事讲清楚。本文按 MDN 的《Functions》《Arrow function expressions》《Rest parameters》三篇官方文档讲清楚:声明与表达式、参数与实参、默认值、剩余参数、展开语法、返回值、箭头函数省写规则、this 的坑、回调与高阶函数、作用域。
同一个页面要在手机、平板、电脑上都站得住。本文按 MDN 的《Responsive web design》《Using media queries》《viewport meta 参考》三篇官方文档讲清楚:流式 HTML、viewport 标签、流式网格与 max-width、图片不撑破容器、媒体查询语法、按内容定断点、mobile-first、响应式字号、按能力查设备与上线检查清单。
JavaScript 里数字只有一种类型 Number,存成 64 位浮点数,所以 0.1 + 0.2 等于 0.30000000000000004。本文按 MDN 的《Basic math in JavaScript》《Math》《Number》三篇官方文档讲清楚:一种数字类型、浮点误差、钱改成分算、字符串转数字、NaN 与 Infinity、安全整数、四种取整、Math.random、Math 工具箱与显示格式化。