実用ガイド

CSS 変数抽出ツール — 使い方ガイドと技術原理

CSS コードからすべての CSS カスタムプロパティ(変数)を抽出します。変数リストとドキュメントを生成します。

ツールを開く

概要

CSS 変数抽出は、CSS コードからすべての CSS カスタムプロパティ(--variable-name)を識別してリスト化するプロセスです。CSS 変数は動的テーマ設定、保守の容易さ、優れたコード組織化を可能にします。抽出ツールは CSS コードを解析して変数宣言を見つけ、その名前と値を抽出し、ドキュメントを生成します。これは、デザインシステムの管理、テーマの一貫性の維持、CSS アーキテクチャの理解に不可欠です。抽出された変数は、ドキュメント、テーマ管理ツール、またはデザインシステムの保守のためにエクスポートできます。

主な概念

CSS カスタムプロパティ

CSS カスタムプロパティ(CSS 変数)は、CSS 作成者によって定義されたエンティティで、文書全体で再利用される特定の値を含みます。構文 --variable-name: value; に従い、var(--variable-name) を使用してアクセスします。CSS 変数は動的テーマ設定、保守の容易さ、優れたコード組織化を可能にします。これらは通常の CSS プロパティと同様にカスケードおよび継承されるため、デザインシステムとテーマ管理の作成に強力です。

変数抽出

CSS 変数の抽出には、CSS コードを解析してすべての --variable-name: value; 宣言を見つけることが含まれます。正規表現はパターン --[\w-]+:\s*[^;]+; に一致して変数を識別できます。抽出ツールは変数名、値、およびコード内の位置を提供します。これは、ドキュメント、テーマ管理、CSS アーキテクチャの理解に役立ちます。抽出された変数は、JSON、CSV、またはその他の形式でエクスポートして、さらに処理できます。

デザインシステム

CSS 変数は現代のデザインシステムの基礎です。これらは、アプリケーション全体での一貫したテーマ設定、動的カラースキーム、レスポンシブデザインの調整を可能にします。デザイントークン(色、間隔、タイポグラフィ)は、多くの場合 CSS 変数として保存されます。抽出ツールは、定義されたすべての変数、その値、使用パターンの可視性を提供することで、デザインシステムの保守を支援します。これは、デザインシステムのドキュメントと保守をサポートします。

機能

自動検出

CSS コード内のすべての CSS 変数(--variable-name 形式)を自動検出

変数リスト

変数名、値、行番号を含む包括的なリストを生成

JSON エクスポート

他のツールとの統合を容易にするために、変数を JSON としてエクスポート

行番号

各変数が定義されている行番号を表示して、参照を容易に

よくある質問

このツールはどの CSS カスタムプロパティを抽出しますか?

--brand-color や --spacing-md などのカスタムプロパティ宣言と、セレクター、:root ブロック、メディアクエリ、コンポーネントのスコープ内で定義されたテーマトークンを CSS コードから検索します。

デザイントークンの監査に使えますか?

はい。抽出した変数一覧を使って、デザインシステムに取り込む前に、命名、重複値、ドキュメントの不足、トークンの使用の不統一を確認できます。

CSS は変更されますか?

いいえ。貼り付けた CSS を解析し、見つかった変数とその値、位置を表示するだけです。元のスタイルシートは変更されません。

関連ドキュメント

CSS 変数抽出ツール

ツールを開いて機能をお試しください。

ツールを開く