Skip to content

合成事件(Synthetic Event)

一句话解释

SyntheticEvent 包装原生事件以提供一致的跨浏览器行为和池化。

用大白话说

SyntheticEvent 是 React 对浏览器原生事件对象的包装。它规范化事件使其在所有浏览器中行为一致,消除跨浏览器差异。属性包括:target、currentTarget、type、nativeEvent、preventDefault()、stopPropagation()。React 16 及更早使用事件池——SyntheticEvent 对象为性能被重用,所以你必须调用 e.persist() 才能异步使用。React 17+ 移除了事件池。React 将事件监听器附加到 document(React 16)或根容器(React 17+)而非单个 DOM 节点——这是用于性能的事件委托。

示例

jsx
function Form() {
  function handleSubmit(e) {
    // e is a SyntheticEvent
    e.preventDefault(); // Cross-browser
    console.log(e.target); // The <form> element
    console.log(e.nativeEvent); // Original browser event
    // e.type, e.currentTarget, etc.
  }

  function handleChange(e) {
    // SyntheticInputEvent
    console.log(e.target.value); // Input value
  }

  return (
    <form onSubmit={handleSubmit}>
      <input onChange={handleChange} />
      <button type="submit">Submit</button>
    </form>
  );
}

SyntheticEvent 用一致的跨浏览器行为包装原生事件。需要时通过 e.nativeEvent 访问原生事件。

常见混淆

  • 容易混淆的对象: 原生事件

    关键区别: 原生事件是带浏览器特定差异的原始浏览器 Event 对象。SyntheticEvent 是 React 的包装器,跨浏览器规范化行为。通过 e.nativeEvent 访问原生事件。SyntheticEvent 有相同接口但一致行为。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表