合成事件(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 有相同接口但一致行为。
相关术语
相关资源
相关课程
- React 事件
合成事件。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。