CSS変数(カスタムプロパティ)の使い方|var()・継承・calc()を実例で解説
サイトのメインカラーを決めて、見出し・枠線・ボタンに同じ色を書いたとします。あとで「やっぱり緑にしたい」となったら、CSS の中の #3a70cc を全部探して書き換えることになります。こうした手間をなくすのが CSS 変数(正式な名前は「カスタムプロパティ」)です。
この記事では、自分の PC で小さな HTML ファイルを作り、ブラウザで実際に効いた色や大きさを確かめながら CSS 変数の使い方を学びます。記事中の結果は、Windows 11 の Microsoft Edge 156(156.0.4314.42)で確かめたものです(2026 年 10 月 26 日に確認)。
:rootに--main-colorを定義し、var(--main-color)で使う基本の書き方- 変数が子孫に引き継がれる仕組みと、一部だけ上書きしてテーマを切り替える方法
- 未定義の変数・単位なしの数値でハマる理由と、
calc()・メディアクエリ・JavaScript との組み合わせ
CSS 変数(カスタムプロパティ)とは?
CSS 変数は、W3C(Web の標準を決める団体)の仕様「CSS Custom Properties for Cascading Variables Module Level 1」で定められた仕組みです。--main-color: #3a70cc; のように -- で始まる名前のプロパティに値を入れておき、使う場所で var(--main-color) と書くと、その値に置き換わります。
仕様では、これを「カスタムプロパティ(自分で作るプロパティ)」と呼び、var() と組み合わせて「変数」として使う、と説明しています。color や margin と同じ「プロパティ」の一種なので、親から子へ引き継がれたり、あとから上書きしたりできます。ここが、プログラミング言語の変数とも、Sass などの変数とも違う大事な点です。
練習用の HTML ファイルを作る
- デスクトップなどに作業用のフォルダーを作ります。
- VS Code などのテキストエディターで新しいファイルを開き、下のコードを貼り付けます。
- 文字コードを UTF-8 にして、
variables.htmlという名前で作業用フォルダーに保存します。 - 保存した
variables.htmlをダブルクリックすると、ブラウザで開きます。
<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
<title>CSS 変数の練習</title>
<style>
body { margin: 0; font-family: sans-serif; }
:root {
--main-color: #3a70cc;
}
.title { color: var(--main-color); }
.box {
border: 2px solid var(--main-color);
padding: 8px;
}
.btn {
background: var(--main-color);
color: #fff;
border: none;
padding: 8px 16px;
}
</style>
</head>
<body>
<h1 class="title">CSS 変数の練習</h1>
<div class="box">
<p class="text">枠線の色も変数で指定しています。</p>
<button class="btn">送信</button>
</div>
</body>
</html>
見出しの文字・枠線・ボタンの背景の 3 か所が、どれも青(#3a70cc)になります。以降の節では、<style> の中の最後(</style> の直前)に数行を書き足して保存し、ブラウザで F5 キーを押して再読み込みする、という流れで試します。前の節で足した行は消してから次を試してください。
基本の書き方::root で定義して var() で使う
練習用ファイルの CSS は、次の 2 つの部分でできています。
- 定義:
:root { --main-color: #3a70cc; }。:rootは文書のいちばん外側の要素(HTML ではhtml要素)を選ぶ疑似クラスです - 使う:
color: var(--main-color);。var()の中に変数の名前を書くと、その値に置き換わります
実際に効いた色は、開発者ツールで確かめられます。F12 キーを押して「Console(コンソール)」タブを開き、次のコードを貼り付けて Enter キーを押します。
getComputedStyle(document.querySelector(".btn")).backgroundColor
"rgb(58, 112, 204)" と表示されれば、ボタンの背景に変数の値が入っています(初めて貼り付けるときは、確認の文字の入力を求められることがあります。詐欺を防ぐ仕組みなので、知らない人に教えられたコードは貼り付けないでください)。#3a70cc と rgb(58, 112, 204) は同じ色の別の書き方で、「カラーコード変換ツール」で相互に変換できます。
次に、:root の #3a70cc を #2e8c56(緑)に書き換えて再読み込みしてみてください。見出し・枠線・ボタンの 3 か所が、すべて rgb(46, 140, 86) の緑に変わりました。1 か所を直すだけで全体の色が変わるのが、CSS 変数を使ういちばんの理由です。
MDN(Mozilla の Web 技術の解説サイト)でも、:root に定義するのがよくあるやり方だと紹介されています。ただし決まりではなく、範囲を絞って定義することもできます。
名前は — で始まり、大文字と小文字を区別する
変数の名前は、必ずハイフン 2 つ(--)で始めます。color や COLOR のような普通のプロパティ名は大文字と小文字を区別しませんが、W3C の仕様では、カスタムプロパティの名前はまったく同じ文字のときだけ同じものとされ、--foo と --FOO は別のプロパティだと書かれています。
試しに、練習用ファイルの :root の中の --main-color を --Main-color(M だけ大文字)に変えて保存してみてください。使う側は var(--main-color) のままです。
| 場所 | 結果(Edge で確認) |
|---|---|
| 見出しの文字色 | rgb(0, 0, 0)(黒) |
| 枠線の色 | rgb(0, 0, 0)(黒) |
| ボタンの背景 | rgba(0, 0, 0, 0)(透明) |
--main-color という変数はどこにも定義されていない扱いになり、青はどこにも付きませんでした。エラーは何も表示されないので、名前はすべて小文字・単語の区切りはハイフンのように、自分のルールを決めてそろえておくのがおすすめです。結果が黒や透明になる理由は、「未定義の変数を使うとどうなる?」の節で説明します。
変数は子孫に引き継がれる(継承)
W3C の仕様では、カスタムプロパティは「継承する(Inherited: yes)」プロパティです。親の要素で定義した変数は、子や孫の要素でもそのまま使えます。:root に書いた変数がページ中で使えるのは、すべての要素が html 要素の子孫だからです。
途中の要素で同じ名前の変数を定義し直すと、その要素とその中だけ値が変わります。練習用ファイルに次の 1 行を足してみましょう。
.box { --main-color: #2e8c56; }
.box の枠線とボタンの背景は緑(rgb(46, 140, 86))に、.box の外にある見出しは青(rgb(58, 112, 204))のままになりました。コンソールで getComputedStyle(document.querySelector(".text")).getPropertyValue("--main-color") を実行すると、.box の中の段落では "#2e8c56"、body では "#3a70cc" が返ります。

反対に、親子の関係にない要素には値は届きません。たとえば .title { --accent: #c83c3c; } と書いて、見出しの兄弟にあたる .box の中の .text で var(--accent) を使っても、赤にはなりませんでした(黒のまま)。「変数を定義したのに効かない」ときは、使う要素が定義した要素の中にあるかを確かめてください。
一部の場所だけ上書きしてテーマを切り替える
継承と上書きを使うと、「この部分だけ暗い配色にする」といったテーマの切り替えが、変数の値を差し替えるだけでできます。練習用ファイルの <style> の中の :root から .btn の終わりまでを、次の CSS に置き換えてください。
:root {
--main-color: #3a70cc;
--bg: #ffffff;
--text: #222222;
}
.title { color: var(--main-color); }
.box {
background: var(--bg);
color: var(--text);
border: 2px solid var(--main-color);
padding: 8px;
}
.btn { background: var(--main-color); color: #fff; border: none; padding: 8px 16px; }
.dark {
--main-color: #8ab4f8;
--bg: #1e1e1e;
--text: #eeeeee;
}
このままでは何も変わりません。HTML の <div class="box"> を <div class="box dark"> に変えると、.box の背景が rgb(30, 30, 30)、文字が rgb(238, 238, 238)、ボタンが rgb(138, 180, 248)(明るい青)になり、外の見出しは元の青のままでした。.box や .btn のルールは 1 行も書き換えていない点に注目してください。
HTML を書き換えずに、コンソールから class を付け外しして試すこともできます。実行するたびに暗い配色と明るい配色が切り替わります。
document.querySelector(".box").classList.toggle("dark")
ボタンの色とその上の文字の色の組み合わせが読みやすいかは、「カラーコード変換ツール」のコントラスト比の判定で確かめられます。テーマを作るときは、明るい配色と暗い配色の両方で確かめておきましょう。
var() の第 2 引数で代わりの値を決める
var() には、カンマのあとに代わりの値(フォールバック)を書けます。変数が定義されていないときに使われる値です。
.text { color: var(--accent, #c83c3c); }
--accent はどこにも定義していないので、段落の文字は代わりの値の赤(rgb(200, 60, 60))になりました。:root に --accent: #c49614; を足すと、今度は変数の値の黄土色(rgb(196, 150, 20))が使われます。
MDN と W3C の仕様では、最初のカンマから閉じかっこまでのすべてが代わりの値になる、と説明されています。そのため、カンマを含む値もそのまま書けます。
.text { font-family: var(--font, Meiryo, sans-serif); }
このとき段落の font-family は Meiryo, sans-serif になりました。逆に、代わりの値として別の変数を使いたいときは、var(--a, var(--b, pink)) のように var() を入れ子にします。var(--a, --b, pink) と書くと、「--b, pink」という文字がそのまま代わりの値になってしまい、意図どおりに動きません(MDN の例より)。
未定義の変数を使うとどうなる?
代わりの値を書かずに、定義されていない変数を使うとどうなるでしょうか。練習用ファイルを最初の状態に戻して、次の CSS を足してみてください。
.box { color: #2e8c56; }
.text {
color: red;
background-color: yellow;
}
.text {
color: var(--text-color);
background-color: var(--bg-color);
}
| プロパティ | 前に書いた値 | 実際の値(Edge で確認) |
|---|---|---|
color | red | rgb(46, 140, 86)(親の .box の緑) |
background-color | yellow | rgba(0, 0, 0, 0)(透明) |
赤にも黄色にもなりませんでした。W3C の仕様では、未定義の変数を参照した宣言は「計算値の時点で無効(invalid at computed-value time)」になり、その値は unset と書いたのと同じになると定められています。つまり、
colorのように継承するプロパティは、親の値(ここでは緑)になるbackground-colorのように継承しないプロパティは、初期値(background-colorならtransparent=透明)になる
名前を --Main-color に変えたとき、枠線が黒になったのも同じ理由です。border-color は継承せず、初期値は文字の色(currentcolor)なので、body から引き継いだ黒になりました。
変数が定義されていても、値の種類が合わないときも同じです。仕様にある例と同じく、:root { --not-a-color: 20px; } を定義して background-color: red; のあとに background-color: var(--not-a-color); を書くと、背景は赤ではなく透明になりました。ブラウザーは変数を定義した時点では使われる場所を知らないので、20px もいったん正しい値として受け取り、使う時点で初めて「色ではない」と分かるためです。
一方、var() を書き忘れて color: --main-color; と書いた場合は、CSS を読み込む時点で文法の間違いとして捨てられるので、前に書いた color: red; が残り、赤になりました。「前の値が残る」のはこちらの場合だけです。
calc() と組み合わせる
余白の大きさを変数にしておき、calc()(計算する関数)で倍数を作ると、余白のルールをそろえやすくなります。
:root { --gap: 8px; }
.box { padding: calc(var(--gap) * 2); margin-top: var(--gap); }
.box の padding は 16px、margin-top は 8px になりました。--gap を 10px に変えれば、20px と 10px にまとめて変わります。
変数の値の中で別の変数を使うこともできます。:root { --gap: 8px; --gap-l: calc(var(--gap) * 3); } として padding: var(--gap-l); と書くと、24px になりました。なお、コンソールで --gap-l の値を読むと、"24px" ではなく "calc(8px * 3)" という文字が返りました。普通のカスタムプロパティは、変数を置き換えるだけで計算まではせず、計算は使われた場所(ここでは padding)で行われるためです。
単位なしの数値と組み合わせるときの注意
「数値だけを変数にして、使うときに px を付けたい」と考えて、次のように書くのはよくある間違いです。
:root { --size: 300; }
.box { width: var(--size)px; }
.box の幅は 300px にならず、width を書かないときと同じく親の幅いっぱいに広がりました。var() の置き換えは文字をつなげる処理ではないので、「300」という数と「px」という語が別々に並んだ形になり、width の値として正しくないためです(未定義の変数と同じく、計算値の時点で無効になります)。単位を付けるには calc() で 1px を掛けます。
.box { width: calc(var(--size) * 1px); }
これで幅は 300px になりました。最初から --size: 300px; と単位付きで定義しておくのも確実な方法です。
| 書き方 | 結果(Edge で確認) |
|---|---|
--size: 300; と width: var(--size)px; | 無効(親の幅いっぱいになる) |
--size: 300; と width: calc(var(--size) * 1px); | 300px |
--gap: 8; と padding: var(--gap); | 無効(padding の初期値 0px になる) |
--ratio: 1.5; と line-height: var(--ratio); | 有効(文字の大きさ 16px のとき 24px) |
line-height や opacity のように、もともと単位なしの数値を受け付けるプロパティなら、単位なしの変数をそのまま使えます。padding や width のように長さが必要なプロパティでは、単位なしの数値は無効です。
メディアクエリやダークモードで値を切り替える
W3C の仕様には、カスタムプロパティは普通のプロパティなので「@media などの条件付きのルールの中で切り替えられる」と書かれています。画面の幅に応じて余白を変える例です。
:root { --gap: 8px; }
@media (min-width: 600px) {
:root { --gap: 24px; }
}
.box { padding: var(--gap); }
ウィンドウの中の幅(innerWidth)が 976px のときは .box の padding が 24px、492px のときは 8px になりました。.box のルールは 1 つのまま、変数の値だけを画面の幅で切り替えられます。
ただし、メディアクエリの条件の中では var() は使えません。MDN の var() のページには「プロパティの値以外(プロパティ名やセレクターなど)では使えない」と書かれています。実際に :root { --bp: 600px; } として @media (min-width: var(--bp)) { … } と書くと、幅 976px でも中のルールは効きませんでした。切り替える幅は、数値で直接書いてください。
OS のダークモード設定に合わせるには、prefers-color-scheme というメディア特性を使います。色をすべて変数にしておけば、@media の中では変数の値を差し替えるだけで済みます。
:root {
--bg: #ffffff;
--text: #222222;
--main-color: #3a70cc;
}
@media (prefers-color-scheme: dark) {
:root {
--bg: #1e1e1e;
--text: #eeeeee;
--main-color: #8ab4f8;
}
}
body { background: var(--bg); color: var(--text); }
ダークモードの状態を再現するオプション(--force-dark-mode)を付けて起動した Edge では、body の背景が rgb(30, 30, 30)、文字が rgb(238, 238, 238)、見出しが rgb(138, 180, 248) になり、付けないときは白い背景と rgb(34, 34, 34) の文字のままでした。いまのブラウザーがダークモード扱いかどうかは、コンソールで matchMedia("(prefers-color-scheme: dark)").matches を実行すると true か false で分かります(Windows やブラウザーの設定画面で切り替える手順は、この記事では確かめていません)。
JavaScript から変数を読み書きする
CSS 変数は、JavaScript から読んだり書き換えたりできます。練習用ファイルを最初の状態に戻し、コンソールで試してみましょう。まずは読み出しです。
getComputedStyle(document.documentElement).getPropertyValue("--main-color")
"#3a70cc" が返ります。document.documentElement は html 要素(:root で選ばれる要素)です。document.documentElement.style.getPropertyValue("--main-color") のように style から読むと、空の文字 "" が返りました。style は HTML の style 属性に書いた値だけを読むので、CSS ファイルや <style> の中の値は getComputedStyle() で読みます。
書き換えるには setProperty() を使います。
document.documentElement.style.setProperty("--main-color", "#c83c3c")
見出し・枠線・ボタンが一度に赤(rgb(200, 60, 60))になりました。このとき html 要素には style="--main-color: #c83c3c;" という属性が付いています。document.querySelector(".box").style.setProperty(...) のように特定の要素に書けば、その要素の中だけが変わります。元に戻すには document.documentElement.style.removeProperty("--main-color") を実行します。
読み出した値を画面に表示するときは、textContent に入れます(HTML として解釈されないので安全です。理由は「JavaScriptのDOM操作入門」で解説しています)。
document.querySelector(".text").textContent = "今の色:" + getComputedStyle(document.documentElement).getPropertyValue("--main-color")
段落の文字が「今の色:#3a70cc」に変わりました。注意したいのは、getPropertyValue() が返すのはいつも文字列だという点です。--n: 3; を読んで + 1 すると、4 ではなく "31" になりました。数として計算するときは Number(…) で変換してください(変換すると 4 になりました)。
Sass などの変数との違い
CSS を書きやすくするツール Sass にも、$main-color のような変数があります。Sass の公式ドキュメントでは、違いを次のように説明しています。
- Sass の変数は、Sass が CSS に変換するときに値に置き換えられて消える。CSS 変数は、変換後の CSS にそのまま残る
- CSS 変数は要素ごとに違う値を持てるが、Sass の変数はその時点で 1 つの値しか持たない
つまり CSS 変数はブラウザーの中で動くので、この記事で試したように、要素ごとの上書き・メディアクエリ・JavaScript で表示したあとから値を変えられます。Sass の変数は値に置き換わったあとの CSS がブラウザーに届くので、そうした切り替えはできません。
発展:@property で変数に型を付ける
@property を使うと、変数に「色」「長さ」などの型、継承するかどうか、初期値を決められます(MDN の説明より)。
@property --main-color {
syntax: "<color>";
inherits: true;
initial-value: #3a70cc;
}
こう書いておくと、どこかで --main-color: 20px; のように色ではない値を入れても、その指定は無視され、親から引き継いだ青が使われました(Edge 156 で確認)。また、型を付けた変数では calc(var(--gap) * 3) が "24px" のように計算済みの値で読めます。まずは普通の CSS 変数に慣れてから使えば十分です。
よくある間違いと直し方
| 症状 | よくある原因 | 直し方 |
|---|---|---|
| 色が付かず黒や透明になる | 名前の大文字・小文字やつづりの違い | 定義と var() の名前を 1 文字ずつ見比べる |
| 一部の要素だけ効かない | 定義した要素の外(兄弟など)で使っている | 共通の親か :root で定義する |
| 前に書いた値に戻らない | 未定義の変数で unset と同じになった | var(--x, 代わりの値) を書く |
| 大きさが指定どおりにならない | 単位なしの数値に px を続けて書いた | calc(var(--x) * 1px) にする |
| メディアクエリが効かない | 条件の中で var() を使った | 幅は数値で直接書く |
| JavaScript の計算がおかしい | 読み出した値が文字列 | Number() で数に変換する |
まずコンソールで getComputedStyle(要素).getPropertyValue("--名前") を実行し、使っている要素から変数が見えているか(空の文字 "" が返らないか)を確かめると、原因を絞り込めます。
よくある質問
:root と html は何が違いますか?
HTML のページでは、どちらも同じ html 要素を選びます。違うのは優先順位(詳細度)で、:root は疑似クラスなので class と同じ (0, 1, 0)、html は要素なので (0, 0, 1) です。:root { --c: #3a70cc; } と html { --c: #c83c3c; } を両方書くと、後に書いた html ではなく :root の青が使われました。詳細度は「CSSのセレクターと詳細度入門」で解説しています。
どんな値を変数にするとよいですか?
何か所にも出てくる値と、あとで変えたくなる値です。メインカラー・文字色・背景色、余白の基本の大きさ、角の丸み、フォントの指定などがよく変数にされます。1 か所でしか使わない値まで変数にすると、かえって読みにくくなります。
まとめ
CSS 変数は、-- で始まる名前に値を入れ、var() で使う仕組みです。名前は大文字と小文字を区別し、値は子孫に引き継がれ、途中で上書きするとその中だけ変わります。未定義なら unset と同じになるので代わりの値を書き、単位なしの数値には calc() で単位を掛けます。練習用ファイルで値を変えながら、動きを確かめてみてください。
関連する記事・ツール
- カラーコード変換ツール
- CSSのセレクターと詳細度入門|優先順位の決まり方とCSSが効かないときの直し方
- CSSのメディアクエリでレスポンシブにする|@mediaの書き方とviewportの設定
- CSSのボックスモデル入門|margin・padding・box-sizingの違い
- CSSのFlexbox入門|要素を横に並べる方法と中央寄せ・flex:1の使い方
- CSS Gridでレイアウトを作る|frの使い方とgrid-template-areas入門
- JavaScriptのDOM操作入門|textContentとinnerHTMLの違い