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

CKTIS / CSS

O descritor font-display: swap em @font-face

Com `swap`, o texto fica invisível por muito pouco tempo e não há um prazo que impeça o tipo de letra web de substituir a alternativa depois de carregar.

Versão: Current CSS specifications; browser support varies by feature

Sintaxe

@font-face {
  font-family: "DemoWeb";
  src: url("demo.woff2") format("woff2");
  font-display: swap;
}

Numa regra @font-face, o descritor font-display controla como o texto é apresentado durante o carregamento de uma variante específica de um tipo de letra. Não é uma propriedade dos elementos: para escolher as famílias de um elemento, usa-se font-family. O temporizador começa quando o navegador tenta usar a variante pela primeira vez, não necessariamente quando começa a transferência.

Período block. Enquanto a variante pretendida não estiver pronta, o navegador compõe o texto com as métricas de um tipo de letra alternativo disponível, mas não desenha os glifos. O texto pode ocupar espaço sem ser visível. Se a variante pretendida carregar durante este período, o navegador usa-a. Com swap, este período é muito curto: o rascunho da especificação recomenda até 100 ms na maioria dos casos, mas não garante uma duração exata nem uma pausa percetível.

Período swap. Se a variante pretendida ainda não estiver pronta, o navegador apresenta o texto com um tipo de letra alternativo visível. Procura a primeira variante já disponível na lista font-family, sem iniciar transferências de tipos de letra alternativos nesta etapa. monospace é uma família genérica, não um tipo de letra específico. Quando a variante pretendida carrega, o navegador usa-a; métricas diferentes podem alterar as quebras de linha ou deslocar elementos.

Período failure. Se um período de substituição finito terminar antes de a variante estar pronta, o navegador trata o carregamento como falhado para efeitos de apresentação e aplica a seleção normal de tipos de letra alternativos. O valor swap não define esse prazo: uma demora por si só não impede a substituição. Porém, não evita falhas reais, como um ficheiro de tipo de letra inválido.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Font display demo</title>
  <style>
    @font-face {
      font-family: "DemoWeb";
      src: url("data:font/woff2;base64,AAAA") format("woff2");
      font-display: swap;
    }

    .demo {
      font-family: "DemoWeb", monospace;
    }
  </style>
</head>
<body>
  <p class="demo">Font display demo</p>
</body>
</html>

Resultado

Expected: “Font display demo” is ultimately rendered in the browser’s generic monospace fallback. The embedded data is not a valid font, so no swap to DemoWeb occurs. The exact fallback face and whether a brief blank interval is visible are not fixed.

Os dados incorporados em `src` são propositadamente inválidos: o exemplo sem ligação à rede mostra o recurso final a `monospace`, não uma substituição bem-sucedida. Para observar a substituição, usa um ficheiro WOFF2 válido da mesma origem e abranda o pedido com a cache desativada.

Lições relacionadas

  • CSS · Lição 15 · Avançado · Versão: 2

Fontes