Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

format() en el descriptor src de @font-face

`format()` indica el formato esperado de una fuente tipográfica concreta, de modo que el navegador puede omitir una fuente no compatible sin descargar sus datos.

Versión: Current CSS specifications; browser support varies by feature

Sintaxis

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

En @font-face, el descriptor src enumera los orígenes de la fuente tipográfica por orden de preferencia, separados por comas. La indicación opcional format() va después de url() y solo se aplica a esa URL. No se añade a local(), que identifica una variante tipográfica disponible localmente.

format() recibe un solo argumento. La especificación prefiere palabras clave como format(woff2), pero también acepta cadenas antiguas equivalentes, como format("woff2"), por compatibilidad con versiones anteriores. La compatibilidad con la sintaxis puede variar según el navegador. tech() indica por separado una tecnología tipográfica necesaria; si se usan ambas funciones, tech() va después de format().

Si el navegador acepta la lista src, la especificación establece que debe omitir los orígenes cuyo formato indicado sea desconocido o no compatible, sin descargar sus datos. Algunos navegadores pueden rechazar en cambio todo el descriptor src al encontrar una indicación que no reconocen. Poder decodificar WOFF2 no garantiza que el navegador llegue a un origen WOFF2 situado más adelante en la lista. Sin esa indicación, examina los datos cuando le toca probar ese origen. La indicación no convierte el archivo ni garantiza que los datos sean válidos o que se puedan descargar, por ejemplo, si CORS bloquea la descarga.

Coloca el origen preferido al principio de un único descriptor src. Si no se puede usar, el navegador pasa al siguiente origen que pueda probar. Especifica por separado una familia de reserva en la propiedad font-family por si no funciona ningún origen.

Ejemplos

<!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.

Ambas URL `data:` contienen datos inválidos a propósito. La declaración `src` anterior mantiene disponible la URL WOFF2 si el navegador rechaza la lista posterior al analizar la sintaxis. `CktisFormatDemo` no se carga y el texto de `.demo` se muestra con `monospace`. Este resultado no indica qué orígenes intentó descargar el navegador.

Lecciones relacionadas

  • CSS · Lección 14 · Avanzado · Versión: 2
  • CSS · Lección 15 · Avanzado · Versión: 2

Fuentes