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

公開ツールCSS変数抽出器

目次
  1. CSS変数があちこちに散らばる理由
  2. ツールを使わずに自分で探す方法
  3. よく混乱しやすいマッチングルール
  4. まとめ
  5. よくある質問

長い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変数抽出器

貼り付けたCSSテキストから--変数の宣言をすべて見つけて表に整理し、値はvar(--名前)の形式でそのままコピーできます。

よく混乱しやすいマッチングルール

正規表現は、--名前のすぐ後ろにコロンが来るパターンだけを宣言として認識し、値はセミコロン・波かっこ・改行にぶつかった時点で止まります。このルールのせいで、特定の状況では変数がまったく拾われなかったり、値が途中で切れて出てきたりします。

状況結果理由
値がセミコロンの前に改行されている最初の行までしか抽出されない正規表現が改行のところで値のマッチングを止める
値(文字列など)の中にセミコロンが含まれているセミコロンより前の部分だけが抽出されるセミコロンを値の終わりだと判断する
コメント内の--名前: 値;というテキストそのまま抽出されるコメントかどうかを区別せず、テキスト全体を走査する
同じ名前が:rootと.darkなどに重複して宣言されているそれぞれ別の行として表示されるセレクタを区別せず、順番にマッチングする
var(--名前)のように値の位置で参照しているだけ抽出されない名前の後にコロンが来ないと宣言として認識しない

とくに、文字列値の中のセミコロンとコメント内の宣言は、実際によく引っかかるポイントです。抽出結果が想定と違うときは、元のCSSでその変数の周辺にセミコロンやコメントがないかをまず確認するのが早道です。

まとめ

  • CSSカスタムプロパティは、:root、クラス、メディアクエリなど宣言の位置に関係なく、--名前: 値のパターンだけで認識・抽出されます。
  • 値はセミコロン・波かっこ・改行にぶつかると途切れるため、値が複数行にまたがっていたりセミコロンを含んでいたりすると、切れて出てくることがあります。
  • コメント内の宣言もテキストとして認識されてそのまま抽出され、同じ名前が重複して宣言されていれば、すべて別の行として表示されます。
  • 検索ボックスに名前や値の一部を入力するとリストがリアルタイムで絞り込まれ、コピーボタンは値ではなくvar(--名前)の形式をコピーします。
  • ツールがなくても同じ原理の正規表現で自分で探せますが、ファイルが長くなるほど、表で一度に見たほうが速く済みます。
CSS変数抽出器

貼り付けたCSSテキストから--変数の宣言をすべて見つけて表に整理し、値はvar(--名前)の形式でそのままコピーできます。

よくある質問

:rootの外にある変数も抽出されますか?

はい。正規表現はセレクタを区別せず、テキスト全体から--名前: 値のパターンだけを探します。クラスセレクタや@mediaクエリの中で宣言された変数も、:rootと同じように表に表示されます。

検索ボックスには何を入力すればいいですか?

変数名や値の一部の文字列を入力してください。大文字と小文字は区別せず、名前と値の両方から一致する項目をリアルタイムで絞り込んで表示します。

コピーボタンを押すと値がそのままコピーされますか?

いいえ。コピーされるのは元の値ではなく、var(--名前)形式の文字列です。他のCSSルールの中にそのまま貼り付けて、その変数を参照する用途を想定しています。

SCSSの$変数やLESSの@変数も抽出されますか?

抽出されません。正規表現が探すパターンは、--で始まるCSSネイティブのカスタムプロパティだけです。$や@で始まるプリプロセッサの変数は対象外です。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. マークダウンのリンク抽出方法|表とURL一覧で確認するマークダウンの[テキスト](URL)と画像リンクを正規表現で見分ける仕組み、参照スタイルや括弧を含むURLで取りこぼす理由、表・URL一覧・JSONの読み方を解説します。
  2. URLリンク自動変換の仕組み|正規表現とtarget/rel属性テキスト内のhttp・httpsアドレスを正規表現で検出し、aタグに変換する仕組みを解説。target=_blank、rel=noopener noreferrer、省略表示、classが出力HTMLに反映される様子も見られます。
  3. チェックサム比較のやり方: ハッシュ値でファイル同一性を確認ダウンロードしたファイルが原本と同じかは、ハッシュ値(チェックサム)の照合で確かめられます。MD5・SHA-1・SHA-256の違いと、公開値と比べる手順、よくある間違いを整理しました。
  4. font-display swapの違いを表で解説font-displayのauto・block・swap・fallback・optionalがblock期間とswap期間でどう違うかを表とタイムラインで整理。swap期間が無限(∞)の意味も解説します。
  5. @font-faceの書き方|woff2・woff・ttfの順番Webフォントを@font-faceで読み込むときのsrcの順番、font-familyの引用符、font-display: swapの書き方をコード構造から解説します。
  6. 自分の位置の緯度経度を確認する方法ブラウザのGeolocation APIで現在位置の緯度・経度を取得する手順と、accuracy・altitude・speedの値が何を意味するかを整理して解説します。

関連ツール