カードには余白三単位、通知には二単位。普通の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の仕事は値を一つ返すところまでだ。