ant-design/docs/blog/hydrate-cssinjs.zh-CN.md
Jerryxin a89bd934d7
site: fix image width issue in markdown (#50399)
Co-authored-by: afc163 <afc163@gmail.com>
2024-08-14 22:52:13 +08:00

5.5 KiB
Raw Permalink Blame History

title date author
动态样式去哪儿了? 2023-07-21 zombieJ

众所周知antd v5 使用了 CSS-in-JS 技术从而支持混合、动态样式的需求。相对的它需要在运行时生成样式,这会造成一定的性能损耗。因此我们研发了组件库级别的 @ant-design/cssinjs 库,通过一定的约束提升缓存效率,从而达到性能优化的目的。不过我们并不止步于此。我们可以通过一些逻辑,直接跳过运行时生成样式的阶段。

动态样式去哪儿了?

如果你研究过 Ant Design 的官网,你会发现 Ant Design 的组件并没有动态插入 <style /> 来控制样式,而是通过 CSS 文件来控制样式:

  • button
  • style

document.head 里有几个 css 文件引用:

  • umi.[hash].css
  • style-acss.[hash].css

前者为 dumi 生成的样式内容,例如 Demo 块、搜索框样式等等。而后者则是 SSR 生成的样式文件。在定制主题文档中,我们提过可以通过整体导出的方式将页面中用到的组件进行预先烘焙,从而生成 css 文件以供缓存命中从而提升下一次打开速度。这也是我们在官网中使用的方式。所以 Demo 中的组件,其实就是复用了这部分样式。

等等CSS-in-JS 不是需要在运行时生成样式的 hash 然后通过 <style /> 进行对齐的么?为什么 css 文件也可以对齐?不用着急,我们慢慢看。

CSS-in-JS 注水

应用级的 CSS-in-JS 方案会对生成的样式计算出 hash 值,并且将其存入 Cache 中。当下次渲染时,会先从 Cache 中查找是否存在对应的样式,如果存在则直接使用,否则再生成一次。这样就可以避免重复生成样式,从而提升性能。

CSS-in-JS process

每个动态插入到页面中的样式同样以 hash 作为唯一标识符。如果页面中已经存在该 hash 的 <style />,则说明 SSR 中做过 inline style 注入。那么 <style /> 就不用再次创建。

你可以发现,虽然 <style /> 的节点创建可以省略,但是因为 hash 依赖于计算出的样式内容。所以即便页面中已经有可以复用的样式内容,它仍然免不了需要计算一次。实属不划算。

组件级 CSS-in-JS

组件级别的 CSS-in-JS 一文中我们提过。Ant Design 的 Cache 机制并不需要计算出完整的样式。对于组件库而言,只要通过 Token 和 ComponentName 就可以确定生成样式一致性,所以我们可以提前计算出 hash 值:

CSS-in-JS hash 计算方式

也因此,我们发现可以复用这套机制,实现在客户端侧感知组件样式是否已经注入过。

SSR HashMap

@ant-design/cssinjsCache 本身包含了每个元素对应的 style 和 hash 信息。过去的 extractStyle 方法只取 Cache 中 style 的内容进行封装:

// e.g. Real world path is much more complex
{
  "bAMbOo|Button": ["LItTlE", ":where(.bAMbOo).ant-btn { color: red }"],
  "bAMbOo|Spin": ["liGHt", ":where(.bAMbOo).ant-spin { color: blue }"]
}

提取:

:where(.bAMbOo).ant-btn {
  color: red;
}
:where(.bAMbOo).ant-spin {
  color: blue;
}

为了复用样式,我们更进一步。将 path 和 hash 值也进行了抽取:

{
  "bAMbOo|Button": "LItTlE",
  "bAMbOo|Spin": "liGHt"
}

并且也打成 css 样式:

// Just example. Not real world code
.cssinjs-cache-path {
  content: 'bAMbOo|Button:LItTlE;bAMbOo|Spin:liGHt';
}

这样 SSR 侧就将我们所需的信息全部留存了下来,接下去只需要在客户端进行提取即可。

CSR HashMap

在客户端则简单的多,我们通过 getComputedStyle 提取 HashMap 信息留存即可:

// Just example. Not real world code
const measure = document.createElement('div');
measure.className = 'cssinjs-cache-path';
document.body.appendChild(measure);

// Now let's parse the `content`
const { content } = getComputedStyle(measure);

在组件渲染阶段,useStyleRegister 在计算 CSS Object 之前,会先在 HashMap 中查找 path 是否存在。如果存在,则说明该数据已经通过服务端生成。我们只需要将样式从现有的 <style /> 里提取出来即可:

// e.g. Real world path is much more complex
{
  "bAMbOo|Button": ["LItTlE", "READ_FROM_INLINE_STYLE"],
  "bAMbOo|Spin": ["liGHt", "READ_FROM_INLINE_STYLE"]
}

而对于 CSS 文件提供的样式(比如官网的使用方式),它不像 <style /> 会被移除,我们直接标记为来自于 CSS 文件即可。和 inline style 一样,它们会在 useInsertionEffect 阶段被跳过。

// e.g. Real world path is much more complex
{
  "bAMbOo|Button": ["LItTlE", "__FROM_CSS_FILE__"],
  "bAMbOo|Spin": ["liGHt", "__FROM_CSS_FILE__"]
}

总结

CSS-in-JS 因为运行时的性能损耗而被人诟病。而在 Ant Design 中,如果你的应用使用了 SSR那么在客户端侧就可以直接跳过运行时生成样式的阶段从而提升性能。当然我们会继续跟进 CSS-in-JS 的发展,为你带来更好的体验。