--- title: 'カスタムプロパティ (--*): CSS 変数' slug: Web/CSS/--* tags: - CSS - CSS カスタムプロパティ - Reference translation_of: Web/CSS/--* ---
{{CSSRef}}

--example-name のように、頭に -- 接頭辞がつけられたプロパティはカスタムプロパティを表し、 {{cssxref("var")}} 関数を使用して他の宣言の中で使用することができる値を持ちます。

カスタムプロパティは宣言された要素のスコープになり、カスケードに関連します。そのようなカスタムプロパティの値は、カスケードのアルゴリズムによって決められた宣言から取られます。

{{CSSInfo}}

構文

--somekeyword: left;
--somecolor: #0000ff;
--somecomplexvalue: 3px 6px rgb(20, 32, 54);
<declaration-value>
シーケンスが許可されていないトークンを含んでいない限り、この値は 1 つ以上のトークンのシーケンスに一致します。つまり、有効な宣言がその値として保持できるものすべてを意味します。

形式文法

{{CSSSyntax}}

例

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);
}

結果

{{EmbedLiveSample('Example', 500, 130)}}

仕様書

仕様書 状態 備考
{{SpecName("CSS3 Variables", "#defining-variables", "--*")}} {{Spec2("CSS3 Variables")}} 初回定義

ブラウザーの互換性

{{Compat("css.properties.custom-property")}}

関連情報