メインコンテンツへスキップ

CSS変数(CSS Variables)

BootstrapのCSSカスタムプロパティを使用して、高速かつ将来を見据えた設計と開発を行う。

Bootstrapには、約20のCSSカスタムプロパティ(変数)がコンパイルされたCSSに組み込まれている。これらによりブラウザのインスペクタ、コードサンドボックス、一般的なプロトタイプで作業するときのテーマカラー、プライマリフォントスタックなどの一般的に使用される値に簡単にアクセス可能にする。

サードパーティのCSSとの競合を避けるために、すべてのカスタムプロパティの前には bs- が付く。

 

root変数(Root variables)v5.0.0-alpha3変更

ここには、BootstrapのCSSが読み込まれる任意の場所にアクセスできる変数を組み込む(:root は必須)。これらは _root.scss ファイルにあり、コンパイルされた dist ファイルに組み込まれる。

デフォルトの設定
scss/_root.scss を出力したもの:root {
  --bs-blue: #0d6efd;
  --bs-indigo: #6610f2;
  --bs-purple: #6f42c1;
  --bs-pink: #d63384;
  --bs-red: #dc3545;
  --bs-orange: #fd7e14;
  --bs-yellow: #ffc107;
  --bs-green: #28a745;
  --bs-teal: #20c997;
  --bs-cyan: #17a2b8;
  --bs-white: #fff;
  --bs-gray: #6c757d;
  --bs-gray-dark: #343a40;
  --bs-primary: #0d6efd;
  --bs-secondary: #6c757d;
  --bs-success: #28a745;
  --bs-info: #17a2b8;
  --bs-warning: #ffc107;
  --bs-danger: #dc3545;
  --bs-light: #f8f9fa;
  --bs-dark: #343a40;
  --bs-font-sans-serif: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", "Liberation Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));
}
【変更履歴】
  • 【v5.0.0-alpha1】
    • すべての変数に bs- の接頭辞を追加
    • 背景をグラデーション化する変数(--bs-gradient)が追加
    • ブレークポイント関連の変数(--breakpoint-**)は削除
  • 【v5.0.0-alpha3】(v4.6.0でバックポート)
    • --bs-font-sans-serif$font-family-sans-serif)に "Liberation Sans"(Ubuntu用sans-serif)が追加

 

コンポーネント変数(Component variables)

また、様々なコンポーネントのローカル変数としてカスタムプロパティを利用し始めた。このようにCSS変数を使用することで、コンパイルされたCSSを大幅に削減し、テーブルスタイルが継承されないようにしたり、Sassを再コンパイルせずに動的にBootstrapコンポーネントの再スタイルや拡張が可能。

CSS変数の使用方法の洞察については、テーブルの解説に記載。

 

実例(Examples)

CSS変数は、Sassの変数と同様の柔軟性を提供するが、ブラウザに提供される前にコンパイルする必要はない。実例では、CSS変数を使用してページのフォントとリンクスタイルをリセット。

Bootstrap5.xの設定例 緑背景が変更箇所
custom.cssbody {
	font: 1rem/1.5 var(--bs-font-family-sans-serif);
}
a {
	color: var(--bs-blue);
}
※Bootstrap4.xの設定例
custom.cssbody {
	font: 1rem/1.5 var(--font-family-sans-serif);
}
a {
	color: var(--blue);
}
【設定】
  • カスタムのcssにbootstrap.cssの :root 内に記載されている変数がCSSファイルで var(--bs-{変数名}) として使用可能
【変更履歴】
  • 【v5.0.0-alpha1】
    • var(--{変数名})var(--bs-{変数名})