CSSのfont-paletteで、カラーフォントの色を変える方法
CSS の font-palette と @font-palette-values を使うと、カラーフォント(1つの文字に複数の色が入ったフォント)の色を、フォントが持つ別の配色に切り替えたり、一部の色だけを好きな色に差し替えたりできます。見出しやロゴに使う装飾的なカラーフォントを、サイトのブランドカラーやダークモードの配色に合わせたいときに、画像を作らずに CSS だけで色を変えられます。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。カラーフォントは Nabla(OFL-1.1)の TTF を使い、フォントの中の色の表(CPAL)は fonttools 4.68.0 で読みました。色が変わったかどうかは、スクリーンショットの画素を比べて判断しています。Firefox と Safari、パレットに明るい背景用・暗い背景用の情報が入ったフォント、スマートフォンの実機は試していません。
カラーフォントの色は color では変わらない
Nabla は、文字の形と色を COLR という表で持つカラーフォントです。fonttools で中を見ると、色の表(CPAL)に10色ずつのパレットが7つ入っていました。1つ目(0番)のパレットは黄色からオレンジの配色です。
カラーフォントの文字には color が効きません。Nabla の文字に color: red を書いても、color: red !important を書いても、画面は何も指定しないときと見分けのつく違いがありませんでした(色の違う画素は 0.00%)。MDN の font-palette のページにも、!important を付けても color ではフォントのパレットを上書きできないと書かれています。
色を変えるには、@font-palette-values でパレットを定義し、そのパレットを font-palette で指定します。
フォントが持つ別のパレットに切り替える
フォントが持つパレットを使うときは、base-palette にパレットの番号を書きます。番号は0から数えます。
@font-face {
font-family: "Nabla";
src: url("/fonts/Nabla.ttf") format("truetype");
}
@font-palette-values --blue {
font-family: "Nabla";
base-palette: 2;
}
h1 {
font-family: "Nabla", fantasy;
font-palette: --blue;
}
--blue のような名前は、-- で始まる好きな名前を付けます。カスタムプロパティと見た目は似ていますが、var() で囲まずにそのまま font-palette に書きます。@font-palette-values の font-family には、パレットを使うフォントの名前(@font-face の font-family と同じ名前)を書きます。

base-palette: 0 を指定した画面は、何も指定しない画面と同じでした。CSS Fonts 4 の仕様にも、COLR と CPAL を使うフォントでは、font-palette: normal(初期値)はふつうは0番のパレットで描くと書かれています。
font-palette は継承されるプロパティです。親の要素に書けば、中の要素にも同じパレットが使われます。
一部の色だけをブランドカラーに差し替える
override-colors には、色の番号と色を組にして、カンマで区切って並べます。番号はパレットの中の何番目の色か(0から数える)で、書いた番号の色だけが差し替わり、ほかの色は base-palette のパレットのままです。base-palette を書かないときは、0番のパレットの色をもとにします。
@font-palette-values --brand {
font-family: "Nabla";
override-colors:
0 #067a98,
1 #067a98,
3 #067a98,
6 #00c8e8,
7 #00c8e8;
}
どの番号の色が文字のどこに使われているかは、フォントによって違います。Nabla の Neko という文字で番号を1つずつ #ff00ff に変えると、0番・1番・3番・5〜9番では画面が変わり、2番と4番では変わりませんでした。2番と4番は、この4文字の画面には出てこない色です。下の画像のように、6番と7番を変えると文字の正面が、さらに0番・1番・3番を変えると側面が水色になりました。

番号を探すときは、まず fonttools などでパレットの色の一覧を見ておくと見当がつきます。Nabla の0番のパレットは、6番が #ffd214、7番が #ffeb6e でした。そのうえで1つずつ目立つ色に変えて、画面のどこが変わるかを見ます。
override-colors に同じ番号を2回書くと、後に書いた色が使われました。1 #ff00ff, 1 #00ff00 と書いた場合は、画面に #00ff00 だけが出ました。パレットにない番号(Nabla なら 99)を書いた組は無視され、画面は何も指定しないときと同じでした。
パレットが効かないときに確かめること
次の書き方では、検証環境ではどれも、何も指定しないとき(0番のパレット)と同じ画面になりました。
@font-palette-valuesのfont-familyが、文字に使っているフォントの名前と違う("Other"と書いた)@font-palette-valuesにfont-familyを書いていないfont-paletteに、どこにも定義していない名前(--nothing)を書いたbase-paletteに、フォントにない番号(99)を書いた
font-family を書かなかったルールは、Chromium 153 では CSSOM には残っていました(CSSFontPaletteValuesRule の fontFamily が空の文字列)。ただ、画面には効きません。仕様では、font-family のない @font-palette-values は無効で、ルールごと無視されます。
カラーフォントでも、色の付け方によっては font-palette が効きません。検証環境の Ubuntu に入っていた Noto Color Emoji は、色の情報を CBDT という形式の表で持つフォントで、COLR と CPAL の表がありませんでした。このフォントの絵文字に override-colors を書いても、画面は変わりませんでした。
font-palette: light と dark は、フォントの中で「明るい背景用」「暗い背景用」とされたパレットを選ぶ値です。Nabla では、light も dark も何も指定しないときと同じ画面でした(Nabla の CPAL はバージョン0です)。仕様では、この情報を持つパレットがないフォントでは、どちらも normal と同じになると決められています。
override-colors に var() や currentcolor は書けなかった
override-colors の色に CSS 変数の値を使おうと var() を書いても、検証環境では効きませんでした。
| override-colors に書いた値 | CSSOM の overrideColors |
画面 |
|---|---|---|
6 #ff00ff, 7 rgb(0 128 255) |
6 rgb(255, 0, 255), 7 rgb(0, 128, 255) |
変わる |
6 var(--brand) |
空の文字列 | 変わらない |
6 currentcolor |
空の文字列 | 変わらない |
var() と currentcolor を書いた override-colors は、読み込んだ時点で捨てられていました。var() は、:root に --brand を定義した場合も、要素に --brand を書いた場合も、画面が変わりませんでした。light-dark() を書いた場合も、CSSOM の値は空の文字列でした。
仕様の override-colors の項は、色は絶対色でなければならず、そうでなければ無効だとしています。絶対色は、color の値で変わる currentcolor や、配色のモードで変わる light-dark() などを除いた色のことです。一方で仕様は @font-palette-values の中に var() を書けるとしていますが、Chromium 153 では使えませんでした。
ダークモードやテーマの色に合わせる
ダークモードのときだけ別のパレットにするなら、@media (prefers-color-scheme: dark) の中で font-palette を変えます。
@font-palette-values --gray {
font-family: "Nabla";
base-palette: 3;
}
@media (prefers-color-scheme: dark) {
h1 {
font-palette: --gray;
}
}
Playwright で prefers-color-scheme を light にしたときは0番のパレット、dark にしたときは3番のパレットと同じ画面になりました。
ユーザーが選んだテーマの色など、決まった値でない色を使いたいときは、var() が使えないので JavaScript でルールの文字列を作ります。次のコードは、:root の --brand の値を読んで、<style id="palette"> の中身を書き換えます。
const brand = getComputedStyle(document.documentElement)
.getPropertyValue('--brand')
.trim();
document.getElementById('palette').textContent =
`@font-palette-values --brand { font-family: "Nabla"; override-colors: 6 ${brand}, 7 ${brand}; }`;
文字には前もって font-palette: --brand を指定しておきます。検証環境では、--brand が #ff00ff のときは文字の正面が #ff00ff になりました。--brand を #00ff00 に変えてからこのコードを実行し直すと、#ff00ff の画素がなくなり、#00ff00 に変わりました。
あらかじめ定義したパレットを切り替えるだけなら、element.style.fontPalette = '--blue' のように font-palette を書き換えるだけで済みます。document.styleSheets[0].insertRule() で @font-palette-values のルールをあとから足し、その名前を指定した場合も、そのパレットで描かれました。
パレットの切り替えをなめらかにする
font-palette に transition を付けると、Chromium 153 ではパレットの色が少しずつ変わりました。
@font-palette-values --p0 {
font-family: "Nabla";
base-palette: 0;
}
@font-palette-values --p2 {
font-family: "Nabla";
base-palette: 2;
}
h1 {
font-palette: --p0;
transition: font-palette 1s linear;
}
h1.on {
font-palette: --p2;
}

h1 に on クラスを付け、transition の途中(0.5秒の時点)で getComputedStyle() の fontPalette を読むと、palette-mix(in oklab, --p0, --p2) でした。1秒の時点では --p2 でした。palette-mix() は、2つのパレットの同じ番号の色どうしを混ぜたパレットを作る関数です。font-palette に直接書くこともでき、palette-mix(in srgb, --p0, --p2) は0番と2番のあいだの配色になりました。--p0 100%, --p2 0% と書くと、0番のパレットと同じ画面でした。
ただし、@mdn/browser-compat-data(8.1.8)では、palette-mix() と、font-palette を少しずつ変えるアニメーションに対応しているのは Chrome と Edge の 121 からで、Firefox と Safari は対応していないとされています。どちらも、互換性データでは実験的な機能とされています。MDN の font-palette のページには、少しずつ変えるアニメーションに対応していないブラウザーでは、2つのパレットが途中なしで切り替わると書かれています。
font-palette と @font-palette-values(base-palette、override-colors を含む)は、同じデータで Chrome 101、Edge 101、Firefox 107、Safari 15.4 から対応しています。





