DevTools 中 CSS 的先前状态 DevTools 以两种不同的方式实现 CSS: 一种用于DevTools遗留部分中使用的 CSS 文件 另一种用于 DevTools 中使用的现代 Web 组件。 对于第一种遗留部分的来说,我们翻开Chromium源码,可以大致猜想它的实现: Chromium源码 DevTool
DevTools 中 CSS 的先前状态
DevTools 以两种不同的方式实现 CSS:
对于第一种遗留部分的来说,我们翻开Chromium源码,可以大致猜想它的实现:
Chromium源码 DevTools 中的 CSS 实现是多年前定义的,现在已经过时了。DevTools 一直坚持使用该 module.json 模式, 那么我们来看下这个文件具体形式是如何的:
module.json 这些CSS文件会被放在同一个目录下,为了将添加到 DevTools,您需要 registerRequiredCSS 使用要加载的文件的确切路径进行调用。 那么它的调用如下:
通过检索CSS文件的内容后,通过 appendStyle 函数将内容插入到 <style> 标签中,
但是,假设我们引入现代 Web 组件(使用自定义元素)时,我们最初决定在组件文件中通过内联 style> 使用CSS。这带来了自己的挑战:
基于以上的问题,那有哪些可以解决的方案呢? 问题可以分为两个不同的部分:
接下来我们看下,他们是如何为每个部分研究了不同的潜在解决方案,下面概述了这些解决方案。 在TypeScript文件中导入和利用CSS的目的是为了尽可能地贴近标准,在整个DevTools中执行一致性,并避免在我们的HTML中重复CSS。我们还希望能够选择一个解决方案,使我们的变化能够迁移到新的网络平台标准,如CSS模块脚本。 由于这些原因,@import语句和标签似乎并不适合DevTools。它们与DevTools其他部分的导入不一致,会导致Flash Of Unstyled Content(FOUC)的出现。迁移到CSS模块脚本会更难,因为导入必须明确地添加,并且与标签的处理方式不同。
总结的话,潜在的解决方案是使用 @import 或 <link> 。 相反,我们选择找到一种方法,将CSS文件作为CSSStyleSheet对象导入,这样我们就可以使用其adoptedStyleSheets属性将其添加到Shadow Dom(DevTools使用Shadow DOM已经有几年了)。
至于Shadow DOM 不清楚的,可以参考: 我们需要一种将 CSS 文件转换为 CSSStyleSheet 对象的方法,以便我们可以轻松地在 TypeScript 文件中对其进行操作。最后选择放弃Rollup和webpack做转化,可能考虑的原因在于,构建过程中,将任何一个bundler 添加到生产构建中都可能存在潜在的性能问题。 我们与Chromium的GN构建系统的整合使得捆绑更加困难,因此捆绑器往往不能很好地与当前的Chromium构建系统整合。 相反,我们探索了使用当前 GN 构建系统为我们进行这种转换的选项。 新的解决方案涉及到使用adoptedStyleSheets向特定的Shadow DOM添加样式,同时使用GN构建系统来生成可被文档或ShadowRoot采用的CSSStyleSheet对象。
使用adoptedStyleSheets有多种好处,包括:
该解决方案的唯一注意事项是,导入语句需要导入.css.js文件。为了让GN在构建过程中生成一个CSS文件,我们编写了generate_css_js_files.js脚本。构建系统现在处理每一个CSS文件,并将其转换为一个JavaScript文件,该文件默认导出一个CSSStyleSheet对象。因为我们可以导入CSS文件并轻松地采用它。此外,我们现在还可以轻松地对生产构建进行最小化,节省文件大小。 iconButton.css.js 生成的例子:
后续计划
到目前为止,Chromium DevTools 中的所有 Web 组件都已迁移到使用新的 CSS 基础架构,而不是使用内联样式。大多数遗留用法 registerRequiredCSS 也已迁移到使用新系统。剩下的就是删除尽可能多的 module.json 文件,然后迁移当前的基础架构以在未来实现 CSS 模块脚本! |
2021-04-14
2021-04-29
2018-01-07
2022-06-10
2021-09-30