Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@font-face — definir uma fonte tipográfica

A regra @font-face regista uma face e os seus descritores para o navegador selecionar e carregar o recurso adequado.

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

Sintaxe

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

@font-face descreve uma face tipográfica. Os descritores font-family e src dão-lhe nome e uma lista ordenada de fontes; font-style, font-weight, unicode-range e font-display limitam a correspondência e o carregamento. São descritores da regra, não propriedades herdadas pelos elementos.

O exemplo expõe local("Arial") como LocalProbe, aplica-o ao texto e pede a face correspondente através de FontFaceSet. O resultado confirma uma fonte carregada, um objeto CSSFontFaceRule e uma métrica diferente de monospace, verificando seleção e utilização além do analisador.

As entradas de src são tentadas pela ordem; formato não suportado, falha CORS ou transferência mal sucedida avança para a fonte seguinte. unicode-range pode dividir uma família em subconjuntos e pode surgir uma face sintética quando nenhuma corresponde ao estilo ou peso pedido. font-display altera os períodos de bloqueio e troca, mas não corrige um ficheiro indisponível.

Dentro de src, format() é uma indicação opcional de formato associada a uma fonte url(). Se o formato indicado não for suportado, o agente do utilizador ignora essa fonte sem a transferir; sem a indicação, deve obter o recurso. A gramática atual de CSS Fonts níveis 4/5 prefere uma palavra-chave como format(woff2), enquanto a forma de cadeia de CSS Fonts 3, format("woff2"), continua aceite por compatibilidade. A indicação não verifica os bytes do tipo de letra nem garante o carregamento: é uma função dentro do descritor src, não um descritor autónomo nem a condição de suporte distinta font-format().

Exemplos

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

Resultado

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

A regra @font-face regista uma face e os seus descritores para o navegador selecionar e carregar o recurso adequado.

Fontes