CSS変数の抽出方法|--変数を一覧表にまとめて検索・コピー

長いCSSファイルで、--から始まるカスタムプロパティが:root、特定のクラス、メディアクエリなど複数の場所に散らばって宣言されていると、目でひとつずつ探すのは大変です。
この記事では、正規表現ベースの抽出ツールが宣言の位置に関係なくすべての--変数宣言を1つの表にまとめる仕組みと、表から名前・値で検索して絞り込み、var(--名前)の形式でそのままコピーする方法を整理します。値が途中で切れて出てくるように見えてよく混乱するマッチングルールについても触れます。
まとめ ① 正規表現は
--名前: 値のパターンを:root・クラス・メディアクエリの区別なく、テキスト全体から見つけて表にまとめます。 ② 表の検索ボックスに名前や値の一部を入力すると、リストがリアルタイムで絞り込まれます。 ③ コピーボタンを押すと、値ではなくvar(--名前)の形式でクリップボードにコピーされるので、そのまま貼り付けて使えます。
CSS変数があちこちに散らばる理由
CSSカスタムプロパティは、1か所だけにまとめて宣言されるものではありません。基本値は:rootに置き、ダークモード用の上書きは.darkや[data-theme="dark"]セレクタの中に、特定の画面幅でだけ変わる値は@mediaクエリの中に別々に置く、という構成がよくあります。
コンポーネント単位でローカル変数を宣言している場合まで加わると、同じファイルの中でも宣言が上下に散らばります。
この状態で、いまこのプロジェクトにどの変数がいくつあるのか、同じ名前が重複して宣言されていないかを確認するには、ファイル全体をスクロールしながら--で始まる行をひとつずつ探すしかありません。ファイルが数百行を超えていたり、複数のCSSファイルに分かれていたりすると、目で見落とす変数が出てきやすくなります。
ツールを使わずに自分で探す方法
CSSカスタムプロパティは文法が決まっているので、ツールがなくても同じルールで自分で探せます。ポイントとなるパターンは、--名前の後ろにコロン(:)が来て、その後に値が続き、セミコロン(;)か波かっこ(})にぶつかったところで終わる、というものです。
コードエディタとターミナルで探す
コードエディタの検索機能で正規表現モードをオンにし、--[a-zA-Z0-9-]+\s*:を検索すると、ファイル内のすべての変数宣言行がハイライトされます。ターミナルでは、次のコマンドで名前と値を一度に抜き出せます。
grep -oE -- '--[a-zA-Z0-9_-]+ *: *[^;{}]+' style.css
この方法は、セレクタが:rootなのか.darkなのか、メディアクエリの中なのかを区別せず、ファイルのテキスト全体から--名前: 値のパターンだけを拾います。私たちのツールが使っているルールと同じ原理です。
ブラウザの開発者ツールで確認する
ブラウザの開発者ツールで実際に適用されている値を見たい場合は、Elementsパネルで:root要素を選択し、Computedタブで--を検索する方法もあります。ただしこれは最終的な計算値なので、ソースコードのどのセレクタで宣言されていたのかまでは分かりません。
数十行、数百行規模のCSSなら、この作業を毎回手で繰り返すより、一度に表で確認したほうが速く済みます。私たちのツールで確認する。
貼り付けたCSSテキストから--変数の宣言をすべて見つけて表に整理し、値はvar(--名前)の形式でそのままコピーできます。

よく混乱しやすいマッチングルール
正規表現は、--名前のすぐ後ろにコロンが来るパターンだけを宣言として認識し、値はセミコロン・波かっこ・改行にぶつかった時点で止まります。このルールのせいで、特定の状況では変数がまったく拾われなかったり、値が途中で切れて出てきたりします。
| 状況 | 結果 | 理由 |
|---|---|---|
| 値がセミコロンの前に改行されている | 最初の行までしか抽出されない | 正規表現が改行のところで値のマッチングを止める |
| 値(文字列など)の中にセミコロンが含まれている | セミコロンより前の部分だけが抽出される | セミコロンを値の終わりだと判断する |
コメント内の--名前: 値;というテキスト | そのまま抽出される | コメントかどうかを区別せず、テキスト全体を走査する |
同じ名前が:rootと.darkなどに重複して宣言されている | それぞれ別の行として表示される | セレクタを区別せず、順番にマッチングする |
var(--名前)のように値の位置で参照しているだけ | 抽出されない | 名前の後にコロンが来ないと宣言として認識しない |
とくに、文字列値の中のセミコロンとコメント内の宣言は、実際によく引っかかるポイントです。抽出結果が想定と違うときは、元のCSSでその変数の周辺にセミコロンやコメントがないかをまず確認するのが早道です。
まとめ
- CSSカスタムプロパティは、
:root、クラス、メディアクエリなど宣言の位置に関係なく、--名前: 値のパターンだけで認識・抽出されます。 - 値はセミコロン・波かっこ・改行にぶつかると途切れるため、値が複数行にまたがっていたりセミコロンを含んでいたりすると、切れて出てくることがあります。
- コメント内の宣言もテキストとして認識されてそのまま抽出され、同じ名前が重複して宣言されていれば、すべて別の行として表示されます。
- 検索ボックスに名前や値の一部を入力するとリストがリアルタイムで絞り込まれ、コピーボタンは値ではなく
var(--名前)の形式をコピーします。 - ツールがなくても同じ原理の正規表現で自分で探せますが、ファイルが長くなるほど、表で一度に見たほうが速く済みます。
貼り付けたCSSテキストから--変数の宣言をすべて見つけて表に整理し、値はvar(--名前)の形式でそのままコピーできます。
よくある質問
:rootの外にある変数も抽出されますか?
はい。正規表現はセレクタを区別せず、テキスト全体から--名前: 値のパターンだけを探します。クラスセレクタや@mediaクエリの中で宣言された変数も、:rootと同じように表に表示されます。
検索ボックスには何を入力すればいいですか?
変数名や値の一部の文字列を入力してください。大文字と小文字は区別せず、名前と値の両方から一致する項目をリアルタイムで絞り込んで表示します。
コピーボタンを押すと値がそのままコピーされますか?
いいえ。コピーされるのは元の値ではなく、var(--名前)形式の文字列です。他のCSSルールの中にそのまま貼り付けて、その変数を参照する用途を想定しています。
SCSSの$変数やLESSの@変数も抽出されますか?
抽出されません。正規表現が探すパターンは、--で始まるCSSネイティブのカスタムプロパティだけです。$や@で始まるプリプロセッサの変数は対象外です。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む