CSSFontFaceDescriptors
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das CSSFontFaceDescriptors-Interface repräsentiert einen CSS-Deklarationsblock für eine @font-face-@-Regel.
Jeder Deskriptor im Körper der entsprechenden @font-face-@-Regel kann entweder über seinen Kebab-Case-Eigenschaftsnamen in der Bracket-Notation oder die Camel-Case-Version des Eigenschaftsnamens in der Dot-Notation zugegriffen werden. Zum Beispiel können Sie auf den font-family-CSS-Deskriptor als style["font-family"] oder style.fontFamily zugreifen, wobei style eine Instanz von CSSFontFaceDescriptors ist.
Hinweis:
Die CSSFontFaceRule-Schnittstelle repräsentiert eine @font-face-@-Regel, und die CSSFontFaceRule.style-Eigenschaft ist eine Instanz dieses Objekts.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Vorfahren CSSStyleDeclaration.
Die folgenden Eigenschaftsnamen in Kebab-Case (zugänglich über die Bracket-Notation) und Camel-Case (zugänglich über die Dot-Notation) stellen jeweils den Wert eines Deskriptors in der entsprechenden @font-face-@-Regel dar:
font-displayoderfontDisplayExperimentell-
Ein String, der den Wert des
font-display-Deskriptors repräsentiert. font-familyoderfontFamilyExperimentell-
Ein String, der den Wert des
font-family-Deskriptors repräsentiert. font-feature-settingsoderfontFeatureSettingsExperimentell-
Ein String, der den Wert des
font-feature-settings-Deskriptors repräsentiert. font-stretchoderfontStretchExperimentell-
Ein String, der den Wert des
font-stretch-Deskriptors repräsentiert. font-styleoderfontStyleExperimentell-
Ein String, der den Wert des
font-style-Deskriptors repräsentiert. font-weightoderfontWeightExperimentell-
Ein String, der den Wert des
font-weight-Deskriptors repräsentiert. font-widthoderfontWidthExperimentell-
Ein String, der den Wert des
font-width-Deskriptors repräsentiert. size-adjustodersizeAdjustExperimentell-
Ein String, der den Wert des
size-adjust-Deskriptors repräsentiert. srcExperimentell-
Ein String, der den Wert des
src-Deskriptors repräsentiert. unicode-rangeoderunicodeRangeExperimentell-
Ein String, der den Wert des
unicode-range-Deskriptors repräsentiert.
Instanz-Methoden
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 auszulesen.
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
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
| Specification |
|---|
| CSS Fonts Module Level 4> # om-fontface> |