Cómo escribir @font-face en CSS: orden woff2, woff y ttf

PublicadoHerramientaGenerador de CSS @font-face

Contenido
  1. Cuando ya tienes los tres archivos de fuente web, aquí es donde te atascas
  2. Cómo escribir el código @font-face a mano, sin herramientas
  3. Tres errores que hacen que la fuente no se vea
  4. En resumen
  5. Preguntas frecuentes

Para descargar un archivo de fuente web y aplicarlo a tu sitio tienes que escribir una regla @font-face, y justo ahí aparecen las dudas de siempre: en qué orden hay que listar woff2, woff y ttf dentro de src, y por qué font-family necesita comillas. Ese orden y esa sintaxis no son convenciones arbitrarias: son reglas que salen de cómo lee el CSS el propio navegador. Vamos a repasar ese funcionamiento paso a paso, centrándonos en la estructura del código.

Resumen ① La lista de src va fija en woff2 → woff → truetype porque el navegador la lee de arriba abajo y se detiene en el primer formato que admite. ② En font-family, envolver el nombre entre comillas es más seguro para evitar conflictos con espacios y palabras reservadas. ③ font-display: swap muestra primero el texto con una fuente sustituta mientras la fuente carga y, al terminar, lo cambia por la que has indicado.

Cuando ya tienes los tres archivos de fuente web, aquí es donde te atascas

Si usas un sitio o una herramienta que convierte fuentes para la web, normalmente obtienes tres archivos a la vez: .woff2, .woff y .ttf. Como cada navegador admite formatos distintos, no basta con incluir uno: hay que enlazar los tres en el CSS.

El problema empieza justo ahí. En cada ejemplo que sale al buscar, el orden dentro de src es distinto, y algunos ponen el ttf arriba del todo. Si cambias el orden, el navegador no muestra ningún error: carga la fuente en silencio, así que a simple vista cuesta ver qué está mal.

Con las comillas de font-family pasa lo mismo, y también con si puedes poner en font-weight un valor distinto al del archivo real. El resultado suele ser una pantalla ambigua en la que «parece que se aplicó, pero también parece la fuente de siempre».

Cómo escribir el código @font-face a mano, sin herramientas

La regla @font-face declara un nombre de fuente y le asocia una lista de archivos (src) y la información de grosor y estilo. Su forma básica es esta.

@font-face {
  font-family: "Pretendard";
  src: url("/fonts/pretendard.woff2") format("woff2"),
       url("/fonts/pretendard.woff") format("woff"),
       url("/fonts/pretendard.ttf") format("truetype");
  font-weight: 400;
  font-style: normal;
  font-display: swap;
}

Veamos uno por uno por qué el orden y la sintaxis tienen que ser así dentro de esta estructura.

Por qué el orden de src queda fijo en woff2 → woff → truetype

En la propiedad src puedes listar varios pares url() y format() separados por comas. El navegador recorre esa lista de arriba abajo y, en cuanto encuentra el primer formato que admite, descarga solo ese archivo e ignora el resto.

Así que el orden de la lista es el orden de prioridad. WOFF2 comprime mejor y por eso pesa menos, WOFF es más antiguo pero está más extendido y TTF (TrueType) es el formato de respaldo más viejo. Si pones woff2 arriba, los navegadores que lo admiten descargan el archivo más ligero, y solo los entornos que no lo admiten pasan a la línea siguiente, a woff, y si tampoco pueden, a ttf.

Si inviertes el orden y pones el ttf arriba, como casi todos los navegadores admiten ttf, la lista se detiene en la primera línea. El resultado es que incluso los navegadores modernos, que ya admiten woff2, acaban descargando el ttf más pesado. Para el navegador no es un error: ha seguido al pie de la letra el orden indicado, así que ni siquiera aparece un aviso en la consola.

Por qué se usan comillas en font-family

El valor de font-family se puede escribir de dos maneras en CSS: sin comillas, como identificador, o entre comillas, como cadena de texto (string).

Si lo escribes como identificador, un nombre con espacios puede interpretarse dividido en varias palabras, y un nombre que empieza por un número o que coincide con una palabra reservada de CSS como sans-serif o inherit puede acabar en un error de análisis. Entre comillas, el nombre completo llega como una sola cadena de texto, sin esos problemas.

Por eso es buena costumbre poner comillas aunque el nombre de la fuente no tenga espacios. Es también la razón de las comillas en «Pretendard» del ejemplo anterior.

Qué hace realmente font-display: swap en el renderizado

font-display es la propiedad que decide cómo muestra el navegador el texto durante el breve tiempo en que el archivo de fuente web aún no se ha descargado. Con el valor swap, el navegador no espera a la fuente: dibuja el texto de inmediato con una fuente sustituta (la fuente de respaldo).

Después, cuando el archivo de fuente web indicado termina de cargar, reemplaza el texto ya dibujado por esa fuente. Si no indicas font-display, según el comportamiento por defecto del navegador puede aparecer un periodo de espera en el que el texto no se ve hasta que la fuente carga; swap elimina prácticamente esa espera y hace que el texto se vea siempre primero.

Eso sí, si el ancho de los caracteres de la fuente de respaldo y el de la fuente real no coinciden, al hacer el cambio puedes ver un pequeño movimiento en los saltos de línea o en la disposición. swap se usa cuando prefieres que el texto aparezca de inmediato antes que verlo aparecer tarde.

Aunque ya conozcas la estructura —el orden de src, las comillas, font-display—, escribir a mano cada vez el nombre de la fuente y las tres rutas de archivo es un fastidio. Puedes comprobar todo este proceso directamente con nuestro Generador de CSS @font-face, que genera al momento el código @font-face para WOFF2, WOFF y TTF indicando familia, grosor y rutas.

Generador de CSS @font-face

Solo tienes que indicar el nombre de la fuente y las rutas de los archivos: el código @font-face con el orden correcto se genera al momento. Todo se procesa en tu navegador, sin enviar nada al servidor.

Tres errores que hacen que la fuente no se vea

Aunque el código parezca funcionar sin errores de sintaxis, cuando la fuente no se aplica casi siempre es por uno de estos tres motivos.

ErrorQué ocurre
Escribir el orden de src al revés (ttf arriba del todo)Incluso los navegadores modernos se detienen en la primera línea y descargan el ttf, que pesa más
Que el nombre de format() no coincida con la extensión real del archivoEl navegador se guía solo por la pista y se salta esa línea o no consigue leer el archivo
Que font-weight y font-style no coincidan con el archivo realAl buscar el texto con el grosor y el estilo declarados, esta fuente no coincide y se usa en su lugar la fuente de respaldo o una negrita sintetizada

El nombre de format() es una pista que el navegador consulta antes de abrir el archivo. Si el archivo es en realidad .woff2 y escribes format("woff"), el navegador puede interpretar esa línea como un formato que no admite, saltársela y pasar a la siguiente. Es el caso de un archivo perfectamente válido que no se carga porque la etiqueta del código está equivocada.

Con font-weight pasa lo mismo. El navegador no abre el archivo para comprobar su grosor real: se cree el número que pone en el CSS. Si subes un archivo Bold y lo declaras con font-weight: 400, el texto que pide font-weight: 700 no se conectará a esta fuente y se usará en su lugar la fuente de respaldo o una negrita que el navegador sintetice por su cuenta.

En resumen

  • El orden de src no es una convención: queda fijo en woff2 → woff → truetype por el principio de funcionamiento de detenerse en el primer formato que el navegador admite.
  • En font-family, envolver el nombre entre comillas es más seguro para evitar conflictos con espacios y palabras reservadas.
  • font-display: swap consiste en mostrar primero el texto con una fuente sustituta y cambiarla después, sin esperar a que cargue la fuente.
  • El valor de format() debe coincidir exactamente con la extensión real del archivo, y font-weight y font-style con el grosor y el estilo reales, para que la fuente se conecte bien.
  • Si respetas estas cuatro cosas, puedes escribir tú mismo un código @font-face correcto sin ninguna herramienta adicional.
Generador de CSS @font-face

Solo tienes que indicar el nombre de la fuente y las rutas de los archivos: el código @font-face con el orden correcto se genera al momento. Todo se procesa en tu navegador, sin enviar nada al servidor.

Preguntas frecuentes

¿Puedo incluir solo un archivo woff2?

Sí, siempre que limites la compatibilidad a los navegadores más recientes. Pero si quieres cubrir también navegadores antiguos, lo más seguro es añadir woff como respaldo, y ttf es un formato que solo conviene sumar cuando necesitas dar soporte a entornos muy antiguos.

¿Tengo que escribir el nombre del archivo tal cual dentro de format()?

No. En format() se usan los valores definidos por la especificación de CSS (woff2, woff, truetype, opentype, etc.). Eso sí, el valor debe coincidir con el formato real del archivo: si es un archivo .ttf, se usa format("truetype"), y si es un archivo .otf, format("opentype").

¿Cómo declaro varios archivos de fuente con grosores distintos?

Con el mismo nombre de font-family, declara una regla @font-face aparte para cada archivo con grosor diferente. Si declaras el archivo Regular con font-weight: 400 y el archivo Bold con font-weight: 700, el navegador elegirá la regla que coincida con el valor de font-weight que realmente se esté usando.

¿Hay otros valores para font-display además de swap?

Existen cinco valores: auto, block, swap, fallback y optional. Con block el navegador espera un momento breve a la fuente y luego pinta el texto; con swap no espera y pinta primero con una fuente sustituta para después cambiarla. Si quieres mostrar el texto cuanto antes, usa swap; si prefieres reducir ese efecto de cambio repentino cuando la fuente termina de cargar, valora block.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Latitud y longitud de mi ubicación con su precisiónAprende cómo el navegador calcula tu latitud y longitud, qué significan accuracy, altitude y speed y por qué necesita HTTPS.
  2. Cómo leer un hex dump: offset, hexadecimal y ASCIIAprende qué son el offset, los bytes hexadecimales y la columna ASCII de un hex dump, y por qué el offset cambia según la base y aparecen puntos.
  3. Verificar una firma HMAC-SHA256: comparar los valoresCompara el valor HMAC-SHA256 que recibes con el que calculas: espacios, mayúsculas, codificación hex o Base64 y algoritmo son las causas habituales.
  4. Previsualización de email HTML en móvil, tablet y PCComprueba en el navegador cómo se ve tu código de email HTML en móvil, tablet y PC, y por qué conviene usar tablas y estilos en línea.
  5. Convertir entidades HTML: 5 reglas de codificaciónCómo se convierten <, >, & y las comillas en entidades HTML, en qué orden, y cómo devolver entidades numéricas y con nombre a su carácter original.
  6. Caracteres especiales HTML: escapar, desescapar y tabla 1:1Por qué &, <, >, " y ' se escapan en HTML, la tabla de conversión 1:1, el orden correcto al sustituir y cómo comprobar el resultado.

Herramientas relacionadas