@font-face CSS schreiben: src-Reihenfolge mit WOFF2, WOFF, TTF

Inhalt
Um eine Webfont auf Ihrer Website einzusetzen, müssen Sie eine @font-face-Regel schreiben. Dabei sorgen zwei Dinge regelmäßig für Verwirrung: in welcher Reihenfolge WOFF2, WOFF und TTF in src stehen sollten und warum font-family Anführungszeichen braucht. Reihenfolge und Syntax sind keine willkürliche Konvention, sondern ergeben sich daraus, wie der Browser CSS liest. Dieser Artikel erklärt die Funktionsweise Schritt für Schritt anhand der Codestruktur.
Zusammenfassung ① Der Browser liest die
src-Liste von oben nach unten und hält beim ersten unterstützten Format an. Deshalb ist die Reihenfolge woff2 → woff → truetype festgelegt. ② Den Namen infont-familysetzt man am besten in Anführungszeichen, um Konflikte mit Leerzeichen und reservierten Wörtern zu vermeiden. ③font-display: swapzeigt den Text zuerst in einer Ersatzschrift an, bevor die Schrift geladen ist, und tauscht sie nach dem Laden gegen die angegebene Schrift aus.
Drei Webfont-Dateien heruntergeladen: und dann?
Wenn Sie eine Schriftdatei mit einem Konverter oder Download-Tool für das Web umwandeln, erhalten Sie meist drei Dateien: .woff2, .woff und .ttf. Da die Browser unterschiedliche Formate unterstützen, binden Sie nicht nur eine, sondern alle drei in das CSS ein.
Ab hier wird es schwierig. Jedes Beispiel, das man per Suche findet, ordnet die Einträge in src anders an, und manche Quellen setzen sogar ttf an die erste Stelle. Auch wenn Sie die Reihenfolge ändern, gibt der Browser keinen Fehler aus und lädt die Schrift stillschweigend. Was falsch ist, lässt sich deshalb mit bloßem Auge kaum erkennen.
Ähnlich unklar ist, ob font-family in Anführungszeichen stehen muss und ob font-weight von der tatsächlichen Datei abweichen darf. Am Ende steht meist ein Bild, bei dem man nicht sicher ist, ob die neue Schrift greift oder doch die ursprüngliche angezeigt wird.
@font-face-Code ohne Tool selbst schreiben
Eine @font-face-Regel deklariert einen Schriftnamen und ordnet ihm eine Liste von Dateien (src) sowie Angaben zu Schriftstärke und Schriftstil zu. Die Grundform sieht so aus:
@font-face {
font-family: "Pretendard";
src: url("/fonts/pretendard.woff2") format("woff2"),
url("/fonts/pretendard.woff") format("woff"),
url("/fonts/pretendard.ttf") format("truetype");
font-weight: 400;
font-style: normal;
font-display: swap;
}
Im Folgenden sehen wir uns Schritt für Schritt an, warum Reihenfolge und Syntax so aussehen müssen.
Warum die src-Reihenfolge woff2 → woff → truetype feststehen muss
Die Eigenschaft src kann mehrere, durch Kommas getrennte Paare aus url() und format() enthalten. Der Browser liest diese Liste von oben nach unten. Sobald er das erste Format findet, das er unterstützt, lädt er nur diese Datei herunter und ignoriert den Rest.
Die Reihenfolge ist also zugleich die Priorität. WOFF2 komprimiert stärker und hat die kleinste Dateigröße. WOFF ist älter, wird aber breiter unterstützt, und TTF (TrueType) ist das älteste Fallback-Format. Steht woff2 ganz oben, laden Browser, die es unterstützen, die leichteste Datei. Nur Umgebungen ohne WOFF2-Unterstützung gehen zur nächsten Zeile über und laden woff, und wenn auch das nicht geht, ttf.
Setzen Sie die Reihenfolge umgekehrt und ttf an die erste Stelle, bleibt der Browser schon in der ersten Zeile hängen, denn ttf unterstützen ebenfalls fast alle Browser. Die Folge: Selbst moderne Browser mit WOFF2-Unterstützung laden die größere ttf-Datei. Aus Sicht des Browsers ist das kein Fehler, sondern genau die vorgegebene Reihenfolge, daher erscheint auch keine Warnung in der Konsole.
Warum font-family in Anführungszeichen steht
Den Wert von font-family können Sie in CSS auf zwei Arten schreiben: ohne Anführungszeichen als Bezeichner (Identifier) oder in Anführungszeichen als Zeichenkette (String).
Als Bezeichner geschrieben, besteht bei Namen mit Leerzeichen die Gefahr, dass sie als mehrere Wörter interpretiert werden. Namen, die mit einer Ziffer beginnen oder mit reservierten CSS-Wörtern wie sans-serif oder inherit übereinstimmen, können zu Parsing-Fehlern führen. In Anführungszeichen wird der gesamte Name dagegen ohne solche Probleme als eine einzige Zeichenkette übergeben.
Daher ist es sicherer, Anführungszeichen auch dann zu setzen, wenn der Schriftname kein Leerzeichen enthält. Aus diesem Grund steht auch "Pretendard" im obigen Beispiel in Anführungszeichen.
Was font-display: swap beim Rendern tatsächlich bewirkt
font-display legt fest, wie der Browser Text darstellt, solange die Webfont-Datei noch nicht heruntergeladen ist. Mit dem Wert swap wartet der Browser nicht auf die Schrift, sondern zeichnet den Text sofort in einer Ersatzschrift (Fallback-Schrift).
Sobald die angegebene Webfont-Datei geladen ist, ersetzt der Browser den bereits gezeichneten Text durch diese Schrift. Ohne font-display kann es je nach Standardverhalten des Browsers eine Wartephase geben, in der der Text unsichtbar bleibt, bis die Schrift geladen ist. swap beseitigt diese Wartephase praktisch und sorgt dafür, dass der Text immer zuerst sichtbar ist.
Unterscheiden sich Fallback-Schrift und tatsächliche Schrift in der Zeichenbreite, kann es beim Austausch zu leichten Verschiebungen bei Zeilenumbrüchen oder im Layout kommen. swap eignet sich, wenn sofort sichtbarer Text wichtiger ist als ein spätes Erscheinen.
Auch wenn Sie die Struktur von src-Reihenfolge, Anführungszeichen und font-display kennen, ist es mühsam, Schriftnamen und drei Dateipfade jedes Mal von Hand zusammenzusetzen. Mit dem @font-face-CSS-Generator können Sie das direkt ausprobieren.
Geben Sie nur Schriftname und Dateipfad ein, und der @font-face-Code in der richtigen Reihenfolge entsteht in Echtzeit. Die Verarbeitung erfolgt ohne Serverübertragung allein im Browser.

Drei typische Fehler, wenn die Schrift nicht erscheint
Wenn der Code fehlerfrei aussieht und die Schrift trotzdem nicht angewendet wird, steckt meist einer der folgenden drei Fehler dahinter.
| Fehler | Was passiert |
|---|---|
src-Reihenfolge umgekehrt (ttf ganz oben) | Auch moderne Browser bleiben in der ersten Zeile hängen und laden die größere ttf-Datei |
format()-Name stimmt nicht mit der tatsächlichen Dateiendung überein | Der Browser beurteilt das Format allein anhand des Hinweises und überspringt die Zeile oder kann die Datei nicht lesen |
font-weight/font-style weichen von der tatsächlichen Datei ab | Bei der Suche nach der deklarierten Stärke bzw. dem Stil wird diese Schrift nicht zugeordnet, stattdessen kommen die Fallback-Schrift oder ein synthetisches Fett zum Einsatz |
Der format()-Name ist ein Hinweis, den der Browser prüft, bevor er die Datei öffnet. Handelt es sich tatsächlich um eine .woff2-Datei, Sie schreiben aber format("woff"), stuft der Browser diese Zeile als nicht unterstütztes Format ein und springt möglicherweise zur nächsten. Die Datei selbst ist in Ordnung, wird aber nicht geladen, weil die Kennzeichnung im Code falsch ist.
Bei font-weight ist es ähnlich. Der Browser öffnet die Datei nicht, um die tatsächliche Stärke zu prüfen, sondern vertraut der Zahl im CSS. Wenn Sie eine Bold-Datei hochladen, aber font-weight: 400 deklarieren, wird diese Schrift für Text mit font-weight: 700 nicht verwendet. Stattdessen greifen die Fallback-Schrift oder ein vom Browser künstlich erzeugtes Fett.
Fazit
- Die
src-Reihenfolge ist keine Konvention, sondern ergibt sich daraus, dass der Browser beim ersten unterstützten Format anhält. Deshalb gilt woff2 → woff → truetype. font-familysetzt man am besten in Anführungszeichen, um Konflikte mit Leerzeichen und reservierten Wörtern zu vermeiden.font-display: swapwartet nicht auf das Laden der Schrift, sondern zeigt den Text zuerst in einer Ersatzschrift an und tauscht sie danach aus.- Der
format()-Wert muss exakt zur tatsächlichen Dateiendung passen,font-weightundfont-stylezur tatsächlichen Stärke und zum Stil der Datei, damit die Schrift richtig eingebunden wird. - Wenn Sie diese vier Punkte beachten, können Sie auch ohne zusätzliches Tool korrekten @font-face-Code selbst schreiben.
Geben Sie nur Schriftname und Dateipfad ein, und der @font-face-Code in der richtigen Reihenfolge entsteht in Echtzeit. Die Verarbeitung erfolgt ohne Serverübertragung allein im Browser.
Häufig gestellte Fragen
Reicht es, nur eine WOFF2-Datei einzubinden?
Wenn Sie die Unterstützung auf aktuelle Browser beschränken, ja. Berücksichtigen Sie auch ältere Browser, ist es sicherer, zusätzlich WOFF als Fallback anzugeben. TTF ergänzen Sie nur, wenn Sie auch sehr alte Umgebungen unterstützen müssen.
Muss der Wert in format() dem Dateinamen entsprechen?
Nein. In format() stehen die Werte, die die CSS-Spezifikation vorgibt (woff2, woff, truetype, opentype usw.). Der Wert muss allerdings zum tatsächlichen Format der Datei passen. Bei einer .ttf-Datei verwenden Sie format("truetype"), bei einer .otf-Datei format("opentype").
Wie deklariere ich mehrere Schriftdateien mit unterschiedlichen Schriftstärken?
Sie deklarieren für jede Datei mit anderer Schriftstärke eine eigene @font-face-Regel, jeweils mit demselben font-family-Namen. Wenn Sie die Regular-Datei mit font-weight: 400 und die Bold-Datei mit font-weight: 700 deklarieren, wählt der Browser anhand des tatsächlich verwendeten font-weight-Werts die passende Regel aus.
Gibt es bei font-display neben swap noch andere Werte?
Ja, es gibt fünf Werte: auto, block, swap, fallback und optional. Bei block wartet der Browser kurz auf die Schrift, bevor er den Text darstellt. Bei swap wartet er nicht, zeigt den Text zunächst in einer Ersatzschrift an und tauscht sie danach aus. Soll der Text so schnell wie möglich erscheinen, ist swap die richtige Wahl. Möchten Sie dagegen den plötzlichen Wechsel nach dem Laden der Schrift möglichst vermeiden, sollten Sie block in Betracht ziehen.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen