Skip to content
On this page

useEventListener

管理事件的 Hook

代码演示

基于元素用法

基于浏览器用法

API

useEventListener(
  eventName: string,
  handler: (ev: Event) => void,
  options?: Options,
);
useEventListener(
  eventName: string,
  handler: (ev: Event) => void,
  options?: Options,
);

Params

参数说明类型默认值
eventName事件名称string-
handler处理函数(ev: Event) => void-
options设置(可选)Options-

Options

参数说明类型默认值
targetDOM 节点或者 ref(() => Element) | Element | React.MutableRefObject<Element> | Window | Documentwindow
capture可选项,listener 会在该类型的事件捕获阶段传播到该 EventTarget 时触发。booleanfalse
once可选项,listener 在添加之后最多只调用一次。如果是 true,listener 会在其被调用之后自动移除。booleanfalse
passive可选项,设置为 true 时,表示 listener 永远不会调用 preventDefault() 。如果 listener 仍然调用了这个函数,客户端将会忽略它并抛出一个控制台警告。boolean

Source

源码文档示例