Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@font-face — definiowanie źródła czcionki

Reguła @font-face rejestruje twarz czcionki i jej deskryptory, aby przeglądarka mogła dobrać oraz załadować właściwy zasób.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

@font-face { <font-face-descriptor-list> }

@font-face opisuje pojedynczą twarz czcionki. Deskryptory font-family i src nadają jej nazwę oraz uporządkowaną listę źródeł; font-style, font-weight, unicode-range i font-display zawężają dopasowanie i sterują ładowaniem. To deskryptory reguły, a nie właściwości dziedziczone przez elementy.

Przykład wskazuje lokalne źródło local("Arial") pod nazwą LocalProbe, stosuje je do tekstu, a następnie żąda dopasowanej twarzy przez FontFaceSet. Wynik potwierdza załadowany font, obiekt CSSFontFaceRule oraz zmianę metryki względem monospace, więc sprawdza dobór i użycie, nie tylko parser.

Źródła z src są próbowane w kolejności; błędny format, CORS lub nieudane pobranie przesuwa wybór do następnego źródła. unicode-range może rozdzielić rodzinę na podzbiory, a syntetyczny krój może pojawić się, gdy żaden opisany krój nie odpowiada żądanemu stylowi lub wadze. font-display zmienia okres blokady i zamiany, lecz nie naprawia niedostępnego pliku.

W deskryptorze src funkcja format() jest opcjonalną wskazówką formatu dołączoną do źródła url(). Jeżeli nazwany format nie jest obsługiwany, agent użytkownika pomija to źródło bez pobierania; bez wskazówki powinien pobrać zasób. Bieżąca gramatyka CSS Fonts poziomów 4/5 preferuje słowo kluczowe, np. format(woff2), natomiast postać z ciągiem znaków z CSS Fonts 3, format("woff2"), pozostaje akceptowana dla zgodności. Wskazówka nie sprawdza bajtów fontu ani nie gwarantuje załadowania: jest funkcją wewnątrz deskryptora src, a nie samodzielnym deskryptorem ani odrębnym warunkiem obsługi font-format().

Przykłady

const style=document.createElement('style');
style.textContent='@font-face { font-family: "LocalProbe"; src: local("Arial"); font-style: normal; font-weight: 400; unicode-range: U+0041-005A; font-display: swap; } .probe { font: 400 32px "LocalProbe", monospace; }';
document.head.append(style);
const probe=document.createElement('span'); probe.className='probe'; probe.textContent='CKTIS'; document.body.append(probe);
const loaded=await document.fonts.load('400 32px "LocalProbe"','CKTIS');
const canvas=document.createElement('canvas'); const context=canvas.getContext('2d');
context.font='400 32px "LocalProbe"'; const localWidth=context.measureText('CKTIS').width;
context.font='400 32px monospace'; const monoWidth=context.measureText('CKTIS').width;
const rule=style.sheet.cssRules[0];
console.log('rule='+rule.constructor.name+'; loaded='+loaded.length+'; status='+loaded[0].status+'; family='+rule.style.getPropertyValue('font-family')+'; metric-diff='+(Math.abs(localWidth-monoWidth)>0.01));

Wynik

rule=CSSFontFaceRule; loaded=1; status=loaded; family=LocalProbe; metric-diff=true

Reguła @font-face rejestruje twarz czcionki i jej deskryptory, aby przeglądarka mogła dobrać oraz załadować właściwy zasób.

Źródła