useInsertionEffect
一句话解释
useInsertionEffect 在任何 DOM 变更前触发——用于 CSS-in-JS 样式注入,非通用逻辑。
用大白话说
useInsertionEffect(React 18)是 useEffect 的变体,在任何 DOM 变更之前同步触发。专为 CSS-in-JS 库(styled-components、emotion)设计,需要在浏览器绘制前注入 <style> 标签。它在 useLayoutEffect 和 DOM 更新之前运行。你不应将其用于通用逻辑——仅用于样式注入。它无法访问 refs,因为 DOM 尚未更新。大多数开发者不会直接使用它——它是给库作者用的。如果你在构建 CSS-in-JS 库,用它在绘制前注入样式以避免无样式内容闪烁。
示例
jsx
import { useInsertionEffect } from "react";
function useStyledComponent(styles) {
useInsertionEffect(() => {
// Inject <style> before DOM mutation
const tag = document.createElement("style");
tag.textContent = styles;
document.head.appendChild(tag);
return () => document.head.removeChild(tag);
}, [styles]);
}
function Button({ children }) {
useStyledComponent(`
.btn { background: blue; color: white; padding: 8px 16px; }
`);
return <button className="btn">{children}</button>;
}useInsertionEffect 在 DOM 变更前注入样式,防止无样式内容闪烁。仅用于 CSS-in-JS 库。
常见混淆
容易混淆的对象: useLayoutEffect
关键区别: useLayoutEffect 在 DOM 变更后、绘制前运行——它可以读取布局(测量)。useInsertionEffect 在 DOM 变更前运行——它无法读取布局。样式注入用 useInsertionEffect,DOM 测量用 useLayoutEffect。
相关术语
相关资源
相关课程
- React 18 特性
useInsertionEffect。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。