CSSFontPaletteValuesRule

Baseline 2022

Newly available

Since November 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die CSSFontPaletteValuesRule-Schnittstelle repräsentiert eine @font-palette-values At-Regel.

CSSRule CSSFontPaletteValuesRule

Instanz-Eigenschaften

Erbt Eigenschaften von ihrem Vorfahren CSSRule.

CSSFontPaletteValuesRule.name Nur lesbar

Ein String mit dem Namen der Schriftartpalette.

CSSFontPaletteValuesRule.fontFamily Nur lesbar

Ein String, der die Schriftarten angibt, auf die die Regel angewendet werden muss.

CSSFontPaletteValuesRule.basePalette Nur lesbar

Ein String, der die mit der Regel assoziierte Basis-Palette angibt.

CSSFontPaletteValuesRule.overrideColors Nur lesbar

Ein String, der die Farben der Basis-Palette angibt, die überschrieben werden und die neuen Farben.

Instanz-Methoden

Erbt Methoden von ihrem Vorfahren CSSRule.

Beispiele

Zugehörige Schriftartfamilie mit CSSOM lesen

Dieses Beispiel definiert zuerst eine @import und eine @font-palette-values At-Regel. Dann wird die @font-palette-values Regel gelesen und ihr Name angezeigt. Da diese Regeln im letzten ins Dokument hinzugefügten Stylesheet leben, ist die Palette die zweite CSSRule, die vom letzten Stylesheet im Dokument zurückgegeben wird (document.styleSheets[document.styleSheets.length-1].cssRules). Daher gibt rules[1] ein CSSFontPaletteValuesRule-Objekt zurück, aus dem wir auf fontFamily zugreifen können.

HTML

html
<pre id="log">The @font-palette-values at-rule font families:</pre>

CSS

css
@import url(https://fonts.googleapis.com/css2?family=Bungee+Spice);

@font-palette-values --Alternate {
  font-family: "Bungee Spice";
  override-colors:
    0 #00ffbb,
    1 #007744;
}

.alternate {
  font-palette: --Alternate;
}

JavaScript

js
const log = document.getElementById("log");

const rules = document.styleSheets[document.styleSheets.length - 1].cssRules;
const fontPaletteValuesRule = rules[1]; // aA CSSFontPaletteValuesRule interface
log.textContent += ` ${fontPaletteValuesRule.fontFamily}`;

Ergebnis

Spezifikationen

Specification
CSS Fonts Module Level 4
# om-fontpalettevalues

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch