override-colors

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2022.

Der override-colors CSS-Deskriptor wird verwendet, um Farben in der gewählten base-palette für eine Farbfont zu überschreiben.

Syntax

css
/* basic syntax */
override-colors: <index of color> <color>;

/* using color names */
override-colors: 0 red;

/* using hex-color */
override-colors: 0 #f00;

/* using rgb */
override-colors: 0 rgb(255 0 0);

/* overriding multiple colors */
override-colors:
  0 #f00,
  1 #0f0,
  2 #00f;

/* overriding multiple colors with readability */
override-colors:
  0 #f00,
  1 #0f0,
  2 #00f;

Der override-colors Deskriptor akzeptiert eine durch Kommas getrennte Liste aus Farbindex und neuem Farbwert.

Der Farbindex ist nullbasiert und jeder Farbwert kann verwendet werden.

Für jedes Schlüssel-Wert-Paar aus Index und Farbe wird die Farbe mit dem Index in der angegebenen base-palette überschrieben. Wenn die Farbfont keine Farbe am angegebenen Index hat, wird sie ignoriert.

Werte

[ <integer [0,∞]> <absolute-color-base> ]

Gibt den Index einer Farbe in einer base-palette und die zu überschreibende Farbe an.

Formale Definition

Zugehörige @-Regel@font-palette-values
Anfangswertn/a (required)
Berechneter Wertwie angegeben

Formale Syntax

override-colors = 
  [ <integer [0,∞]> <color> ]#

Beispiele

Farben von Emojis ändern

Dieses Beispiel zeigt, wie Sie Farben in der Noto Color Emoji Farbfont überschreiben können, um sie an die Marke Ihrer Website anzupassen.

HTML

html
<section class="hats">
  <div class="hat">
    <h2>Original Hat</h2>
    <div class="emoji">🎩</div>
  </div>
  <div class="hat">
    <h2>Red Hat</h2>
    <div class="emoji red-hat">🎩</div>
  </div>
</section>

CSS

css
@font-face {
  font-family: "Noto Color Emoji";
  font-style: normal;
  font-weight: 400;
  src: url(https://fonts.gstatic.com/l/font?kit=Yq6P-KqIXTD0t4D9z1ESnKM3-HpFabts6diywYkdG3gjD0U&skey=a373f7129eaba270&v=v24)
    format("woff2");
}

.emoji {
  font-family: "Noto Color Emoji", emoji;
  font-size: 3rem;
}
@font-palette-values --red {
  font-family: "Noto Color Emoji";
  override-colors:
    0 rgb(74 11 0),
    1 rgb(149 22 1),
    2 rgb(183 27 1),
    3 rgb(193 28 1),
    4 rgb(230 34 1);
}
.red-hat {
  font-palette: --red;
}

Ergebnis

Eine Farbe in einer alternativen base-palette ändern

Anhand der Rocher Color Font zeigt dieses Beispiel, wie eine Farbe in der Schriftart überschrieben wird.

HTML

html
<h2 class="normal-palette">Normal Palette</h2>
<h2 class="override-palette">Override Palette</h2>

CSS

css
@font-face {
  font-family: "Rocher";
  src: url("[path-to-font]/RocherColorGX.woff2") format("woff2");
}
h2 {
  font-family: "Rocher", fantasy;
}
@font-palette-values --override-palette {
  font-family: "Rocher";
  base-palette: 3;
}
@font-palette-values --override-palette {
  font-family: "Rocher";
  base-palette: 3;
  override-colors: 0 rebeccapurple;
}
.normal-palette {
  font-palette: --normal-palette;
}
.override-palette {
  font-palette: --override-palette;
}

Ergebnis

Dieses Beispiel zeigt, dass in der base-palette 3 die Farbe an Index 0 mit rebeccapurple überschrieben wird.

Beispiel, das die base-palette und die base-palette mit 1 überschriebenen Farbe zeigt

Spezifikationen

Specification
CSS Fonts Module Level 4
# override-color

Browser-Kompatibilität

Siehe auch