Skip to content

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。

相关术语

相关资源

相关课程

解读错误信息

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

查看错误

← 返回术语表