#3394·emotion

缺乏有关快速选项的文档

作者: alshaza创建于 2026年8月1日更新于 2026年8月1日
标签needs triagedocumentation

快速选项(createCache({speedy})和@emotion/css的运行时 sheet.speedy(...))在emotion.sh上没有专门的文档,尽管它是一个很重要的选项 - 它在生产环境中默认启用,并将样式插入从文本节点追加到 CSSOM.insertRule。唯一的现有提及是在 SSR 文档中对在 Puppeteer 预渲染中禁用它的窄幅附注。这使得用户难以发现 speedy 的权衡,这表现在许多开放的问题中,这些问题都源于不知道 speedy 的行为/限制(例如 https://GitHub.com/emotion-js/emotion/issues/2404, https://GitHub.com/emotion-js/emotion/issues/2508)。我想添加一个专门的“Speedy”文档页面,解释该选项的作用、默认值、如何配置以及已知的限制(附带上述问题的链接),并将 packages/cache/README.md 的选项列表更新为最新版。

内容来源: emotion-js/emotion