概要
CSS Modulesとは、CSSのクラス名をコンポーネント単位でローカル化できる仕組みです。
通常のCSSとの違い
通常のCSSはグローバルスコープのため、以下のようにするとどこで.titleを使っても、全部に影響します。
.title {
color: red;
}
大規模化すると以下のようになってしまいます。
- クラス名の衝突
- 影響範囲が読めない
- 命名地獄(BEM地獄)
そこでCSS Modulesの力を借ります。
CSS Modulesを使うとどうなるか
以下のようなフローでCSSをJavaScriptのimport対象にして、クラス名を内部で一意化してくれます。
/* button.module.css */
.title {
color: red;
}
import styles from "./button.module.css"
<h1 className={styles.title}>Hello</h1>
ビルド後
<h1 class="title__3f8a2">Hello</h1>
→このようにクラス名が自動ハッシュ化されるため、他と絶対に衝突しないクラス名になります。
CSS Modulesで解決できること
| 解決 | 内容 |
|---|---|
| スコープ | ファイル単位で閉じる |
| 衝突ゼロ | 自動ハッシュ |
| 命名自由 |
.titleを何個作ってもOK |
| 安全なリファクタ | 影響範囲が明確 |
cstと同様にglobalでも使える
:global(.markdown h1) {
font-size: 24px;
}