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

CKTIS / CSS

`local()` e `format()` no descritor `src` de `@font-face`

Ordena as origens dos dados da fonte em `src` e distingue a procura de uma variante instalada com `local()` da indicação de formato em `format()`.

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

Sintaxe

Common @font-face form with a local source and a URL fallback:
@font-face {
  font-family: "Example Family";
  src: local("Example Regular"), url("example.woff2") format("woff2");
}

src grammar:
<font-src-list> = <font-src>#
<font-src> = <url> [ format(<font-format>) ]? [ tech(<font-tech>#) ]? | local(<font-family-name>)
`#` means one or more comma-separated items; `?` marks an optional part. The formal name `<font-family-name>` in `local()` does not change the lookup: it identifies an individual face, not a whole family.

@font-face disponibiliza ao documento uma variante de uma fonte. A regra exige dois descritores: font-family atribui o nome a usar na propriedade font-family de um elemento, e src indica as origens dos dados da fonte. Quando precisa dessa variante, o navegador experimenta as origens separadas por vírgulas da esquerda para a direita e usa a primeira que consegue ativar.

local() procura uma variante instalada específica, não uma família inteira. Para fontes OpenType e TrueType, usa o nome completo da variante ou o respetivo nome PostScript. Podes indicar ambos em entradas local() separadas, pois a correspondência varia com a plataforma e a fonte. Os navegadores podem restringir o acesso a fontes locais para reduzir a identificação do dispositivo por impressão digital.

url() aponta para um recurso de fonte. A indicação opcional format() vem depois de url() na mesma entrada, nunca depois de local(). Por exemplo, format("woff2") indica que se espera WOFF2, pelo que o navegador pode evitar a transferência se não suportar esse formato. A indicação não converte o ficheiro nem garante que os dados sejam válidos.

Se a variante local não existir ou os dados de uma origem não puderem ser usados, o navegador passa à origem seguinte. Se nenhuma funcionar, o texto pode usar a família seguinte na propriedade font-family, como sans-serif. Esse recurso à família seguinte é distinto da lista src. Alguns navegadores podem rejeitar todo o descritor src se uma entrada contiver sintaxe CSS inválida.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Font source demo</title>
  <style>
    @font-face {
      font-family: "CKTIS Demo";
      src: local("Arial"),
           local("ArialMT"),
           url("data:font/woff2;base64,AA==") format("woff2");
    }

    body {
      font-family: "CKTIS Demo", sans-serif;
    }
  </style>
</head>
<body>Font source demo</body>
</html>

Resultado

The page displays “Font source demo”. If the browser can use a matching local Arial face, it renders the text with that face. Otherwise it uses the browser’s sans-serif fallback: the embedded data are deliberately not a valid WOFF2 font. The exact appearance depends on the browser and system.

Não é necessário um ficheiro de fonte externo. Remove as duas entradas `local()` e as vírgulas que se seguem para forçar a utilização de `sans-serif`. O URL `data:` contém propositadamente dados WOFF2 inválidos.

Lições relacionadas

  • CSS · Lição 11 · Intermédio · Versão: 2

Fontes