如何像导入 JS 模块一样导入 CSS？

ConardLi 脚本之家 2022-05-10

关注

“脚本之家

”，与百万开发者在一起

作者 | ConardLi

出品 | code秘密花园（ID：code_mmhy）

刚刚发布的 Chrome 93 版本中更新了一项令人兴奋的新特性：CSS Module Script，使用它你可以像导入一个 JavaScript 模块一样加载 CSS 样式。

然后，你可以将 CSS 样式与可构造样式表(Constructable Stylesheet) 相同的方式作用于 document 和 shadow dom，这比其他加载 CSS 的方式更方便、更高效。

什么是可构造样式表？

在了解 CSS Module Script 之前，我们先来了解下啥是可构造样式表(Constructable Stylesheet)。和表面意思一样，它是为了 CssStyleSheet 可直接构造而设计的，在 document 和 shadow dom 下都可以使用。

使用可构造样式表：

通过 new CSSStyleSheet() 构造一个样式表
改变可构造样式表
通过 adoptedStyleSheets 使用可构造样式表

改变可构造样式表有如下API：

insertRule(rule，index) 往 cssRules 属性里插入 rule
deleteRule(rule，index) 从 cssRules 属性里删除 rule
replace(text) 异步替换 cssRules
replaceSync(text) 同步的 replace

// Construct the CSSStyleSheet
const stylesheet = new CSSStyleSheet();
 
// Add some CSS
stylesheet.replaceSync('body { background: #000 ; }')
// OR stylesheet.replace, which returns a Promise instead
 
// Tell the document to adopt your new stylesheet.
// Note that this also works with Shadow Roots.
document.adoptedStyleSheets = [...document.adoptedStyleSheets, stylesheet];

使用 CSS Module Script

引入 CSS Module Script 将作用于 document 和 shadow dom，如下：

import sheet from './styles.css' assert { type: 'css' };
document.adoptedStyleSheets = [sheet];
shadowRoot.adoptedStyleSheets = [sheet];

CSS Module Script 默认导出的是一个 可构造样式表 ，与任何其他 可构造样式表 一样，它使用 adoptedstylesheet 作用于 document 和 shadow dom。

和其他使用 JavaScript 引入 CSS 的方式不同，你无需创建一个 <script> 标签，也不需要把 CSS 插入混淆后的 JavaScript 中。

CSS Module 也有像 JavaScript Module 一样的优点：

重复数据删除：如果从应用的多个位置导入相同的 CSS 文件，它仍然只会被提取、实例化和解析一次。
一致的顺序：如果导入一个 JavaScript 运行时，它可以依赖于已经解析过的样式表。
安全性：模块使用 CORS 加载，并且使用严格的 MIME 类型检查。

导入断言（assert）是什么？

import 语句的 assert {type: 'css'} 部分是一个 import 断言，这是必需要声明的的；如果没有它，CSS 将被认为是一个普通的 JavaScript 模块，如果导入的文件具有非 JavaScript MIME 类型，则会导入失败。

import sheet from './styles.css'; // Failed to load module script:
                                  // Expected a JavaScript module
                                  // script but the server responded
                                  // with a MIME type of "text/css".

样式表的动态导入

类似于 JavaScript 模块的动态导入，你还可以用 dynamic import 导入 CSS 模块：

const cssModule = await import('./style.css', {
  assert: { type: 'css' }
});
document.adoptedStyleSheets = [cssModule.default];

这里有个坑需要注意，被添加到 adoptedstylesheet 的并不是 cssModule本身，而是 cssModule.default。

@import 的规则尚未支持

目前，CSS@import 的规则不适用 于可构造样式表，包括 CSS Module Script。如果 CSS 模块中含有@import 规则，则这些规则将被忽略。

/* atImported.css */
div {
    background-color: blue;
}

/* styles.css */
@import url('./atImported.css'); /* Ignored in CSS module */
div {
    border: 1em solid green;
}

<!-- index.html -->
<script type="module">
    import styles from './styles.css' assert { type: "css" };
    document.adoptedStyleSheets = [styles];
</script>
<div>This div will have a green border but no background color.</div>