font-family

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 @font-palette-values Deskriptor font-family wird verwendet, um festzulegen, auf welche Schriftarten-Palettenwerte angewendet werden sollen. Diese müssen genau den Werten entsprechen, die bei der Einstellung der CSS font-family verwendet werden.

Syntax

css

@font-palette-values --Dark-mode {
  font-family: "Bungee Spice";
  /* other palette settings follow */
}

Andere Palettenwerte, die folgen, gelten nur für die angegebene Schriftfamilie. Sie können @font-palette-values für andere Schriftfamilien erstellen, indem Sie das gleiche <dashed-ident> verwenden. Dies bedeutet, dass Sie bei mehreren Farbfonts denselben Bezeichner für jeweils verwenden können.

Werte

<family-name>: Gibt den Namen der font-family an.

Formelle Definition

Zugehörige @-Regel	`@font-palette-values`
Anfangswert	`n/a (required)`
Berechneter Wert	wie angegeben

Formale Syntax

font-family = 
  <family-name>#  

<family-name> = 
  <string>         |
  <custom-ident>+

Beispiele

Verwendung von übereinstimmenden Schriftfamiliennamen

In diesem Beispiel wird der font-family Deskriptor in der @font-palette-values At-Regel verwendet, wobei derselbe Wert wie bei der Deklaration des font-family verwendet wird.

HTML

html

<h2>This is spicy</h2>
<h2 class="extra-spicy">This is extra hot & spicy</h2>

CSS

css

@import url(https://fonts.googleapis.com/css2?family=Bungee+Spice);
@font-palette-values --bungee-extra-spicy {
  font-family: "Bungee Spice";
  override-colors:
    0 DarkRed,
    1 Red;
}

h2 {
  font-family: "Bungee Spice", fantasy;
}

h2.extra-spicy {
  font-palette: --bungee-extra-spicy;
}

Ergebnis

Verwenden desselben Palettenbezeichners für mehrere Schriftfamilien

In diesem Beispiel werden zwei @font-palette-values At-Regeln für zwei Schriftfamilien festgelegt, aber beide At-Regeln verwenden denselben dashed-ident Bezeichner, --Dark Mode. Dies hilft dabei, die font-palette Eigenschaft für mehrere Elemente gleichzeitig festzulegen, in diesem Fall h1 und h2. Dies kann nützlich sein, wenn Sie die Schriftfarben an das Branding Ihrer Website anpassen möchten.

css

@font-palette-values --Dark-Mode {
  font-family: "Bungee Spice";
  /* palette settings for Bungee Spice */
}

@font-palette-values --Dark-Mode {
  font-family: Bixa;
  /* palette settings for Bixa */
}

h1,
h2 {
  font-palette: --Dark-Mode;
}

h1 {
  font-family: "Bungee Spice", fantasy;
}

h2 {
  font-family: Bixa, fantasy;
}

Spezifikationen

Specification
CSS Fonts Module Level 4 # font-family-2-desc