CSSのfont-paletteで、カラーフォントの色を変える方法

​​CSS​fonttools,Playwright,フォント

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から数えます。

css
@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 と同じ名前)を書きます。

Neko という文字を、Nabla の base-palette 0 から 6 で並べた画面。0 は黄とオレンジ、1 はピンクと紫、2 は水色と青、3 は濃い灰色、4 は薄い紫がかった灰色、5 は黄と緑と水色、6 は紫と赤
base-palette に 0〜6 を指定した @font-palette-values を、それぞれ font-palette で指定した画面(Chromium 153)

base-palette: 0 を指定した画面は、何も指定しない画面と同じでした。CSS Fonts 4 の仕様にも、COLR と CPAL を使うフォントでは、font-palette: normal(初期値)はふつうは0番のパレットで描くと書かれています。

font-palette は継承されるプロパティです。親の要素に書けば、中の要素にも同じパレットが使われます。

一部の色だけをブランドカラーに差し替える

override-colors には、色の番号と色を組にして、カンマで区切って並べます。番号はパレットの中の何番目の色か(0から数える)で、書いた番号の色だけが差し替わり、ほかの色は base-palette のパレットのままです。base-palette を書かないときは、0番のパレットの色をもとにします。

css
@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番を変えると側面が水色になりました。

Neko という文字を3段で並べた画面。1段目は指定なしで黄とオレンジ。2段目は override-colors で 6 と 7 を水色にしたもので、正面が水色、側面はオレンジのまま。3段目はさらに 0、1、3 を濃い水色にしたもので、正面と側面が水色の配色になり、上面には薄い黄色が残っている
override-colors で差し替える番号を増やしていった画面(Chromium 153)

番号を探すときは、まず 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 を変えます。

css
@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"> の中身を書き換えます。

js
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 ではパレットの色が少しずつ変わりました。

css
@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;
}
Neko という文字の下に、黄、ピンク、青、黄と緑の4つのボタンがある。ボタンを順に押すと、文字の配色が少しずつ次のパレットに変わる。下の欄に font-palette の計算値が出ていて、切り替えの途中は palette-mix(in oklab, --p0 80%, --p1 20%) のような値になる
ボタンを押すと、要素の style の font-palette を、ボタンに割り当てたパレット(–p0、–p1、–p2、–p5)に書き換える。transition は 0.8s linear。上の「クリック n回目/4回」、カーソルの丸、計算値の欄のピンクは録画のために足したもの

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 から対応しています。

​Posted by 86