カードには余白三単位、通知には二単位。普通のCSSで計算できる。以下ではこのHTMLを共通に使う。
<article class="site-card">
<h2>インストールガイド</h2>
<p>プロジェクトの最初のページから始めましょう。</p>
</article>
<aside class="site-notice">
<h2>バージョンのお知らせ</h2>
<p>更新前に変更履歴を確認してください。</p>
</aside>:root {
--space-unit: 0.5rem;
}
.site-card {
padding: calc(var(--space-unit) * 3);
}
.site-notice {
padding: calc(var(--space-unit) * 2);
}ルートの文字サイズが16pxなら一単位は8pxで、内側余白は 24px、16px になる。この二つの計算だけなら、そのまま残せる。複数のコンポーネントで式を共同管理したいときに、関数として名前を付ける。
:root {
--space-unit: 0.5rem;
}
@function --space(--steps <number>: 1, --unit <length>: 0.5rem)
returns <length> {
result: calc(var(--steps) * var(--unit));
}
.site-card {
padding: --space(3, var(--space-unit));
}
.site-notice {
padding: --space(2, var(--space-unit));
}関数にしても結果は24px、16pxのままだ。変わるのは、計算に名前を付け、倍率と単位を呼び出す側から渡すことになる。以下はChrome 139から提供された@functionに対応するブラウザを前提とする。16pxは比較用の条件で、利用者の文字サイズを固定する指定ではない。複数ブラウザ向けの基準スタイルは最後に示す。
引数に書けば、依存先が見える
関数名と引数名は--で始まり、padding: --space(...)と値の位置で直接呼ぶ。@applyもvar(--space(...))も不要だ。var(--steps)は引数を読み、resultは出力、returns <length>は結果の型を指定する。関数の定義
この例では--space()が0.5rem、--space(3)が1.5rem、--space(3, 6px)が18pxになる。<length>に百分率は含まれない。型や既定値は省略可能だが、残しておくと何を渡せるかが分かる。
既定の0.5remは関数に書かれた値だ。ルートの--space-unitを0.75remに変えても自動では変わらない。tokenを使うならvar(--space-unit)を渡す。特に他の人が保守する共通関数では、依存を明示する形から始めたい。
単位を変えても24pxのままになる理由
次を先ほどのHTMLと独立して使う。カードの単位を0.25remにしても、余白は 24px のままだ。
:root {
--space-unit: 0.5rem;
--card-space: calc(var(--space-unit) * 3);
}
.site-card {
--space-unit: 0.25rem;
padding: var(--card-space);
}--card-space内のvar(--space-unit)はルートで解決され、その後に継承される。カード上の単位はルートの参照を再評価しない。カスタムプロパティの評価と継承
カード自身にcalc(var(--space-unit) * 3)を書けば、そのカードの単位を使える。計算を共同管理する必要があるなら、使用時に要素の単位を読む関数にもできる。
:root {
--space-unit: 0.5rem;
}
@function --local-space(--steps <number>: 1) returns <length> {
result: calc(var(--space-unit, 0.5rem) * var(--steps));
}
.site-card {
--space-unit: 0.25rem;
padding: --local-space(3);
}
.site-notice {
padding: --local-space(2);
}カードは 12px、通知は 16px になる。関数に--space-unitという引数やローカル変数がないため、使用要素のカスタムプロパティを読む。関数のスコープ
前の--space(3, var(--space-unit))にもカードの0.25remを明示的に渡せば、同じ12pxになる。--local-space(3)は短いが外部依存が隠れるため、利用上の約束に書いておきたい。同名の引数やローカル変数は外部値を隠す。引数が一つ少なくても、追いやすいとは限らない。
resultは途中でreturnしない
次はviewportが40rem以下のとき、余白を四分の三にする例だ。これはこの画面の選択であり、スマートフォンの共通定義ではない。
:root {
--space-unit: 0.5rem;
}
@function --responsive-space(--steps <number>: 1) returns <length> {
--density: 1;
@media (width <= 40rem) {
--density: 0.75;
}
result: calc(var(--space-unit, 0.5rem) * var(--steps) * var(--density));
}
.site-card {
padding: --responsive-space(3);
}
.site-notice {
padding: --responsive-space(2);
}ルートと既定の文字サイズがともに16pxなら、800px幅で24px、16px、600px幅で 18px、12px になる。--densityは関数内にとどまり、他のCSSが要素上で読めるtokenにはならない。
メディア条件が変えるのは、評価に参加する宣言だ。resultが途中で処理を終える命令になるわけではない。次の関数は狭い画面の条件に合っても、結果は 1rem のままになる。
@function --always-one() returns <length> {
@media (width <= 40rem) {
result: 0.75rem;
}
result: 1rem;
}後のresultが前を上書きする。JavaScriptのreturnのように最初の結果で止まらない。実行モデルと条件
基準値を先に、条件の上書きを後に置くか、前の例のようにローカル変数を使って式を一つにしたい。そもそも二つの要素が同じ幅条件を共有しないなら、メディアクエリはそれぞれの規則に残す。
前のpaddingに戻るとは限らない
次の関数には倍率の既定値がないのに、redを渡している。
@function --strict-space(--steps <number>) returns <length> {
result: calc(var(--steps) * 0.5rem);
}
.site-card {
padding: 24px;
padding: --strict-space(red);
}対応ブラウザでは<number>に合わず、計算値の段階で無効になる。paddingは初期値の 0 になり、前の24pxを選び直さない。必須引数を省く--strict-space()も無効だ。他のプロパティは継承の性質に従うので、全て0になるわけではない。計算値段階の無効化
既定値があれば挙動は異なる。前の--space()には倍率1があり、--space(red)はそれを試して 0.5rem になる。引数の評価規則が認める処理なので、誤った呼び出しでも動いて見える場合がある。
関数の型検査を通っても、使う先のプロパティの制約は残る。負数は<number>に合い、負の長さはmarginに使えるがpaddingには使えない。長さを返せるかだけでなく、呼び出す場所も確認したい。
導入時に残す基準スタイル
2026年10月30日に再確認したMDN互換性データでも、Chrome/Chrome AndroidとEdgeは139から対応、Firefoxは未対応、Safari/iOS Safariはpreviewとされている。previewを安定版で広く使えるという意味には取れない。CSSWG編集草案も変更されうる。
複数ブラウザ向けには元の計算を基準として残し、拡張部分を分けられる。次が完全なCSSだ。
:root {
--space-unit: 0.5rem;
}
.site-card {
padding: calc(var(--space-unit) * 3);
}
.site-notice {
padding: calc(var(--space-unit) * 2);
}
@supports at-rule(@function) {
@function --space(--steps <number>: 1, --unit <length>: 0.5rem)
returns <length> {
result: calc(var(--steps) * var(--unit));
}
.site-card {
padding: --space(3, var(--space-unit));
}
.site-notice {
padding: --space(2, var(--space-unit));
}
}at-rule(@function)自体にも対応が必要だ。関数を実行できてもこのクエリを知らなければ、基準スタイルにとどまる。この例はどちらも同じ外観になる代わりに、当面二つの計算を管理する。
@supports (padding: --space(3))では、関数の存在を確認できない。対応エンジンでは未定義の名前でもtrueになることがある。解析可能な宣言でも、評価が成功するとは限らない。at-rule()も各引数を検査するものではない。
例の結果と基準スタイルは、2026年10月27日にローカルのChromium、Playwright WebKit、CSSFunctionsを無効にしたChromiumで確認した。Playwright WebKitはSafari安定版ではなく、この試験からFirefoxの対応を推定することもできない。
私なら、計算を共同管理するために関数を使う。すべての演算を包みたいわけではなく、二度の乗算ならcalc()でも十分読める。複数の宣言や入れ子の規則をまとめたい場合は、次の@mixin草案の話になる。@functionの仕事は値を一つ返すところまでだ。
