CSSカスタムプロパティ抽出器
ガイド
CSSカスタムプロパティ抽出器
任意のCSSまたはSCSSスタイルシートを貼り付け、すぐにクリーンで並べ替え、重複を削除したすべての --custom-property が宣言されていること、およびその宣言が行われた選択範囲を表示します。抽出器は、どこにも宣言されていない変数を表面化し、これは大規模なデザインシステムでのスタイルの破損を引き起こすよくある原因です。 var(--name) が参照されているが、どこにも宣言されていない変数を表面化します。
使用方法
- スタイルシートを CSS / SCSS 入力 ボックスに貼り付け(または 例を試してみてください。 をクリックしてサンプルを読み込みます)。
- を選択してください 出力フォーマットプレーンテキストテーブル、JSONオブジェクト、または貼り付ける準備ができている
:root { }ブロック。 - を使用して、よく使用されるヘッダーをデフォルト値とともに挿入します。認証セクションで認証タイプと認証情報を設定し、カスタムヘッダーを手動で追加します。curl、Postman、またはコードで使用するための完全なヘッダーセットをコピーします。 フィルター 変数名、値、または範囲で結果を絞り込むためのフィールド。
- トグル 選択範囲を含める 各変数がどこで宣言されたかを表示するかどうかを制御します。
- 確認する 未定義変数 パネルで、宣言に一致しない参照を確認します。
var(--name)出力パネルにあるボタンを使って抽出リストをコピーまたはダウンロードします。 - ブレースを認識するパーサー
機能
- – スタイルシートを1文字ずつ読み進めて、ネストされた選択子、メディアクエリ、および引用された値を正しく処理します。 範囲追跡
- – 各変数は宣言された選択子またはアットルールとペアで、トークンとコンポーネントスコープオーバーライドを区別できます。 – レビュー用のプレーンテキストテーブル、プログラム用のJSON、およびスタイルシートに貼り付ける準備ができている
:rootブロック。 - 3つの出力フォーマット 未定義変数検出
:root { }– どこにも宣言されていない変数をフラグ付けします。 - リアルタイムフィルター – 変数名、値、または選択範囲で結果を絞り込むためにタイプします。
var(--name)重複と並べ替え - – 同一範囲内の重複した宣言は収縮され、リストはアルファベット順に並べ替えられて迅速にスキャンできます。 – 何らかのデータがアップロードされません。プライベートまたは未完成のスタイルシートでも動作します。
- デザインシステムスタイルシートをアудィットして、トークンのマスターリストを作成する。 SCSS変数をネイティブCSSカスタムプロパティに移行する。
- ブラウザ内で完全に動作 誤った
このツールを使用するタイミング
- 参照によって引き起こされた破損スタイルを特定する。
- 第三者テーマからスタートブロックを生成する。
- トークンをドキュメントサイトまたはStorybookエントリで使用するためのJSONとしてエクスポートする。
var()CSSカスタムプロパティとは何ですか? - CSSカスタムプロパティ(また、CSS変数とも呼ばれます)は、2つのダッシュで前接された識別子(たとえば、--color-primary)であり、var()関数を通じてスタイルシートのどこかで再利用可能です。プリプロセッサ変数とは異なり、カスタムプロパティはブラウザで実行時に解決され、他のCSSプロパティと同様にカスケードし、継承され、JavaScriptで動的に更新できます。
:root { }選択範囲がカスタムプロパティにどのように影響しますか? - カスタムプロパティは、宣言された要素のサブツリーにのみ存在します。:rootに宣言することで、html要素にマッチするため、効果的にグローバルになります。一方、.cardのようなコンポーネント選択子に宣言することで、そのコンポーネントとその子孫にのみ値が制限されます。同じ名前が異なるスコープで異なる値を持つことが可能で、これはテーマ、ダークモード切り替え、コンポーネントレベルオーバーライドのメカニズムです。
よくある質問
-
CSSがvar()が未定義のカスタムプロパティを指す場合にエラーを出さないのはなぜですか?
CSSカスタムプロパティ仕様では、参照された変数が宣言されていない場合にブラウザが静かにフォールバックする必要があります。var()にフォールバック引数がない場合、プロパティ全体がunsetとして扱われ、多くの場合、要素は初期または継承されたスタイルを持ちます。コンソールにエラーが報告されないため、未宣言の参照は容易に見過ごされ、事前に表面化することで、微妙な視覚的変化を防ぐことができます。
-
SCSS変数とCSSカスタムプロパティは同じものですか?
同じ役割を持っていますが、パイプラインの異なる段階に存在しています。SCSS変数(たとえば、$color-primary)は、SCSSがCSSにコンパイルされるときに解決され、最終出力から消えます。CSSカスタムプロパティは2つのダッシュで前接され、コンパイル後はブラウザでレンダリング時に評価され、これはリアルタイムテーマやJavaScript駆動の更新を可能にします。
-
カスタムプロパティを再宣言できますか?それならどうなりますか?
はい。同じ要素に対して同じカスタムプロパティが複数宣言された場合、通常のCSSカスケードがどの宣言が優先されるかを決定し、特定性、ソース順序、重要性を考慮します。1つのルール内では、最後の宣言が前にある宣言を上書きし、これは他のCSSプロパティと同じコンフリクト解決行動です。
-
CSSまたはSCSSスタイルシートをここに貼り付けます
変数名または値でフィルター
-
CSSカスタムプロパティ抽出ツール1
CSSカスタムプロパティ抽出ツール
恵 スコアボードが到着しました!
スコアボード ゲームを追跡する楽しい方法です。すべてのデータはブラウザに保存されます。さらに多くの機能がまもなく登場します!
