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

CKTIS / CSS

format() no descritor src de @font-face

`format()` indica o formato esperado de uma origem do tipo de letra, para que o navegador possa ignorar uma origem não suportada sem descarregar os seus dados.

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

Sintaxe

src = <font-src>#
<font-src> = <url> [ format( <font-format> ) ]? [ tech( <font-tech># ) ]? | local( <font-family-name> )
<font-format> = <string> | collection | embedded-opentype | opentype | svg | truetype | woff | woff2

Em @font-face, o descritor src enumera as origens do tipo de letra por ordem de preferência, separadas por vírgulas. A indicação opcional format() segue url() e aplica-se apenas a esse URL. Não se coloca depois de local(), que identifica uma variante do tipo de letra disponível localmente.

format() aceita um único argumento. A especificação dá preferência a palavras-chave como format(woff2), mas aceita cadeias antigas equivalentes, como format("woff2"), para manter a retrocompatibilidade. O suporte da sintaxe pode variar entre navegadores. tech() indica separadamente uma tecnologia de fonte necessária; quando se usam ambas as funções, tech() surge depois de format().

Se o navegador aceitar a lista src, a especificação prevê que ignore as origens cujo formato indicado seja desconhecido ou não suportado, sem descarregar os dados. Alguns navegadores podem, em vez disso, rejeitar todo o descritor src ao encontrar uma indicação que não reconhecem. A capacidade de descodificar WOFF2 não garante, por si só, que o navegador chegue a uma origem WOFF2 mais adiante na lista. Sem indicação de formato, examina os dados quando chega a essa origem. A indicação não converte o ficheiro nem garante a validade dos dados ou o sucesso do descarregamento, por exemplo, se CORS o bloquear.

Coloca a origem preferida em primeiro lugar num único descritor src. Se não a puder usar, o navegador passa à próxima origem que possa experimentar. Indica separadamente uma família de reserva na propriedade font-family, para o caso de nenhuma origem funcionar.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Font format hint demo</title>
<style>
  @font-face {
    font-family: "CktisFormatDemo";
    /* Keep the WOFF2 URL available if the next declaration is invalid. */
    src: url("data:font/woff2,second-invalid-payload") format("woff2");
    src: url("data:font/woff2,first-invalid-payload") format("cktis-unknown-format"),
         url("data:font/woff2,second-invalid-payload") format("woff2");
  }

  .demo {
    font-family: "CktisFormatDemo", monospace;
  }
</style>
<body>
<div class="demo">Format demo</div>
<div id="result" role="status"></div>
<script type="module">
  const demo = document.querySelector('.demo');
  const result = document.querySelector('#result');
  const src = document.styleSheets[0].cssRules[0].style.getPropertyValue('src');

  const loadFailed = await document.fonts.load('16px "CktisFormatDemo"', demo.textContent)
    .then(() => false, () => true);
  await document.fonts.ready;

  const families = getComputedStyle(demo).fontFamily.split(',').map(name => name.trim());
  const fallbackIsMonospace = families.length === 2 &&
    families[0].replace(/["']/g, '') === 'CktisFormatDemo' &&
    families[1] === 'monospace';

  result.textContent = src.includes('second-invalid-payload') && loadFailed && fallbackIsMonospace
    ? 'CktisFormatDemo failed to load; using monospace.'
    : 'Unexpected result: check the src descriptor, font load, and fallback family.';
</script>
</body>
</html>

Resultado

Format demo
CktisFormatDemo failed to load; using monospace.

Ambos os URL `data:` contêm propositadamente dados inválidos. A declaração `src` anterior mantém o URL WOFF2 disponível se o navegador rejeitar a lista seguinte durante a análise sintática. O carregamento de `CktisFormatDemo` falha e o texto de `.demo` é apresentado com `monospace`. Este resultado não mostra que origens o navegador tentou descarregar.

Lições relacionadas

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

Fontes