カスタム・プロパティ (--*)

--example-name のように 頭に -- 接頭辞がつけられたプロパティはカスタム・プロパティと呼び、(var) 関数を使用してドキュメント全体で再利用できる値を持ちます。

カスタム・プロパティはカスケードに関連しています。これらのプロパティは複数回表示させることが可能で、変数の値は、カスケードのアルゴリズムによって決められたカスタム・プロパティで定義された値とマッチします。

構文

--somekeyword: left;
--somecolor: #0000ff;
--somecomplexvalue: 3px 6px rgb(20, 32, 54);

<declaration-value>

シーケンスが許可されていないトークンを含んでいない限り、この値は 1 つ以上のトークンのシーケンスにマッチします。つまり、有効な宣言がその値として保持できるものすべてを意味します。

基本構文

<declaration-value>

例

HTML

<p id="firstParagraph">この段落は青色の背景で黄色のテキストとなります。</p>
<p id="secondParagraph">この段落は黄色の背景で青色のテキストとなります。</p>
<div id="container">
  <p id="thirdParagraph">この段落は緑色の背景で黄色のテキストとなります。</p>
</div>

CSS

:root {
  --first-color: #488cff;
  --second-color: #ffff8c;
}

#firstParagraph {
  background-color: var(--first-color);
  color: var(--second-color);
}

#secondParagraph {
  background-color: var(--second-color);
  color: var(--first-color);
}

#container {
  --first-color: #48ff32;
}

#thirdParagraph {
  background-color: var(--first-color);
  color: var(--second-color);
}

結果

仕様書

ブラウザ対応状況

関連項目

• Using CSS variables