Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

@font-face — definire una sorgente di caratteri

La regola @font-face registra un volto e i relativi descrittori affinché il browser scelga e carichi la risorsa corretta.

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

Sintassi

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

@font-face descrive un singolo volto tipografico. I descrittori font-family e src gli assegnano nome ed elenco ordinato delle sorgenti; font-style, font-weight, unicode-range e font-display limitano corrispondenza e caricamento. Sono descrittori della regola, non proprietà ereditate dagli elementi.

L’esempio espone local("Arial") come LocalProbe, lo applica al testo e richiede il volto corrispondente tramite FontFaceSet. Il risultato conferma un font caricato, un oggetto CSSFontFaceRule e metriche diverse da monospace, quindi verifica selezione e uso oltre al parser.

Le voci di src vengono provate in ordine; formato non supportato, errore CORS o download fallito porta alla sorgente successiva. unicode-range può dividere la famiglia in sottoinsiemi e, senza un volto corrispondente a stile o peso, può comparire una variante sintetica. font-display modifica i tempi di blocco e scambio ma non ripara un file indisponibile.

All’interno di src, format() è un suggerimento di formato facoltativo associato a una sorgente url(). Se il formato indicato non è supportato, lo user agent salta quella sorgente senza scaricarla; senza suggerimento deve recuperare la risorsa. La grammatica attuale di CSS Fonts livelli 4/5 preferisce una parola chiave come format(woff2), mentre la forma stringa di CSS Fonts 3, format("woff2"), resta accettata per compatibilità. Il suggerimento non controlla i byte del font e non garantisce il caricamento: è una funzione nel descrittore src, non un descrittore autonomo né la distinta condizione di supporto font-format().

Esempi

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));

Risultato

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

La regola @font-face registra un volto e i relativi descrittori affinché il browser scelga e carichi la risorsa corretta.

Fonti