Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

CSSFontFaceDescriptors

Die CSSFontFaceDescriptors Schnittstelle repräsentiert einen CSS-Deklarationsblock für eine @font-face At-Regel.

Jeder Deskriptor im Körper der entsprechenden @font-face At-Regel kann entweder über seinen Eigenschaftsnamen im Kebab-Case in Klammernotation oder die Camel-Case-Version des Eigenschaftsnamens in Punktnotation zugegriffen werden. Zum Beispiel kann der font-family CSS-Deskriptor als style["font-family"] oder style.fontFamily abgerufen werden, wobei style eine CSSFontFaceDescriptors-Instanz ist.

Hinweis: Die CSSFontFaceRule Schnittstelle repräsentiert eine @font-face At-Regel, und die CSSFontFaceRule.style Eigenschaft ist eine Instanz dieses Objekts.

CSSStyleDeclaration CSSFontFaceDescriptors

Instanzeigenschaften

Erbt Eigenschaften von seinem Vorfahren CSSStyleDeclaration.

Die folgenden Eigenschaftsnamen in Kebab-Case (abgerufen mit Klammernotation) und Camel-Case (abgerufen mit Punktnotation) stellen jeweils den Wert eines Deskriptors in der entsprechenden @font-face At-Regel dar:

font-display oder fontDisplay

Ein String, der den Wert des font-display Deskriptors repräsentiert.

font-family oder fontFamily

Ein String, der den Wert des font-family Deskriptors repräsentiert.

font-feature-settings oder fontFeatureSettings

Ein String, der den Wert des font-feature-settings Deskriptors repräsentiert.

font-stretch oder fontStretch

Ein String, der den Wert des font-stretch Deskriptors repräsentiert.

font-style oder fontStyle

Ein String, der den Wert des font-style Deskriptors repräsentiert.

font-weight oder fontWeight

Ein String, der den Wert des font-weight Deskriptors repräsentiert.

font-width oder fontWidth Experimentell

Ein String, der den Wert des font-width Deskriptors repräsentiert.

size-adjust oder sizeAdjust

Ein String, der den Wert des size-adjust Deskriptors repräsentiert.

src

Ein String, der den Wert des src Deskriptors repräsentiert.

unicode-range oder unicodeRange

Ein String, der den Wert des unicode-range Deskriptors repräsentiert.

Instanzmethoden

Keine spezifischen Methoden; erbt Methoden von seinem Vorfahren CSSStyleDeclaration.

Beispiele

Zugriff auf @font-face Deskriptorwerte

Dieses Beispiel definiert eine @font-face Regel und verwendet dann CSSFontFaceDescriptors, um die Deskriptorwerte wieder auszulesen.

CSS

css
@font-face {
  font-family: "MyHelvetica";
  src:
    local("Helvetica Neue Bold"),
    local("HelveticaNeue-Bold"),
    url("MgOpenModernaBold.woff2") format("woff2");
  font-weight: bold;
  font-style: normal;
  font-display: swap;
}

JavaScript

js
const myRules = document.getElementById("css-output").sheet.cssRules;
for (const rule of myRules) {
  if (rule instanceof CSSFontFaceRule) {
    const style = rule.style; // a CSSFontFaceDescriptors
    log(`font-family: ${style.fontFamily}`);
    log(`src: ${style.src}`);
    log(`font-weight: ${style["font-weight"]}`);
    log(`font-style: ${style.fontStyle}`);
    log(`font-display: ${style["font-display"]}`);
  }
}

Ergebnis

Spezifikationen

Spezifikation
CSS Fonts Module Level 4
# om-fontface

Browser-Kompatibilität

Siehe auch