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 | woff2Em @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