侧边栏壁纸
博主头像
一笑痕

人生若只如初见,
是可喜亦或者是可悲?

  • 累计撰写 297 篇文章
  • 累计收到 7 条评论

focus 不冒泡,表单容器用 focusin 做委托

2026-11-21 / 0 评论 / 9 阅读

focus 不冒泡,表单容器用 focusin 做委托

表单外层容器监听 focus,想在任意输入框获得焦点时显示提示,回调却没有触发。把监听器绑到每个输入框当然能工作,但动态增删字段后还得重复绑定。这里的问题是事件传播方式:focus 不冒泡。

容器为什么收不到 focus?

在容器上用默认参数监听 focus,点击或调用 .focus() 聚焦子元素时,事件不会沿冒泡阶段传到容器。blur 也一样。事件确实发生在目标上,只是监听器所在的祖先节点不会在冒泡阶段收到它。

这和 click 的委托写法不同。点击按钮时,click 会从按钮向祖先节点冒泡,所以可以在列表容器上监听一次,再通过 event.target 判断是哪一项。把同一段代码里的 click 换成 focus,委托就失灵了。

focusin 会沿祖先节点传播

浏览器提供了 focusin 和 focusout,它们分别对应焦点进入与离开,并且会冒泡。容器可以只注册一组监听器,检查事件目标后处理任意后代字段:

const form = document.querySelector('form');

form.addEventListener('focusin', event => {
  if (event.target.matches('input, textarea, select')) {
    event.target.classList.add('has-focus');
  }
});

form.addEventListener('focusout', event => {
  if (event.target.matches('input, textarea, select')) {
    event.target.classList.remove('has-focus');
  }
});

focusout 的 relatedTarget 可以指出焦点将要移向的元素。若焦点从一个输入框移到另一个输入框,离开的节点是 event.target,新焦点节点则是 event.relatedTarget。从容器角度处理整个焦点范围时,可以比较这两个节点是否仍在容器内,避免焦点在内部字段间切换时把整块区域误判为失焦。

实测事件顺序

在本机浏览器的两个按钮页面上,先点击空白处让文档获得焦点,再监听 focus、focusin、blur、focusout 并依次点击两个按钮。文档收到两次 focusin 和一次 focusout,没有收到冒泡阶段的 focus 或 blur。焦点从 one 移到 two 时,离开事件的 relatedTarget 指向新按钮。

after activating page: {"hasFocus":true,"active":"BODY","events":[]}
after button transitions: {"hasFocus":true,"active":"two","events":[{"type":"focusin","target":"one","related":null},{"type":"focusout","target":"one","related":"two"},{"type":"focusin","target":"two","related":"one"}]}

focus 也能在捕获阶段监听

不冒泡不代表祖先完全看不到 focus。捕获阶段会从祖先往目标传递,因此也可以这样注册:

form.addEventListener('focus', event => {
  if (event.target.matches('input, textarea, select')) {
    console.log('字段获得焦点', event.target.name);
  }
}, true);

最后的 true 表示使用捕获阶段。现代写法也可以传 { capture: true }。该事件虽不冒泡,捕获监听器仍能在目标处理前观察到它。这个方案适合需要明确监听 focus 本身的场合;只为容器做焦点委托时,我会先选 focusin,读代码的人不必从第三个参数猜传播阶段。

两种写法别混成一种:focusin 是另一个事件,监听默认冒泡;focus 仍是不冒泡的事件,只是祖先能在捕获阶段看见它。测试中注册的是默认阶段监听,因此没收到 focus 和 blur,并不意味着它们不会在目标上触发。

焦点事件还有个容易漏掉的边界:当焦点从容器内一个字段移到另一个字段,容器会收到一次离开和一次进入。若需求是判断整个表单区域是否失焦,不能在每次 focusout 都立刻关闭提示;检查 relatedTarget 是否仍包含在容器里更合适。单字段状态则可直接按目标元素切换样式。若容器本身也能获得焦点,还要把它是否属于目标范围纳入判断,不能只筛选表单控件。事件委托解决的是监听位置和传播路径,目标元素该不该处理仍由业务条件决定。

relatedTarget 也可能为空,例如焦点离开当前页面时就不能把它当成一个确定的 DOM 节点。容器需要在判断前确认它有值,再调用 contains;如果为空,按焦点已经离开容器处理更稳妥。代码只看 event.target 会知道谁失去焦点,却不知道焦点是移到表单内的下一个字段,还是去了别处,两种情况的提示行为通常不同。

委托处理动态字段时,focusin / focusout 通常最直观;需要捕获事件、或代码明确依赖 focus 名称时,用捕获阶段监听。不要把 focus 当成 click 的同类冒泡事件,否则容器上的回调会安静地缺席。

    🤞 分享