rustedf.cloud
Menú

HTML y CSS para PDF: qué funciona y cómo comprobarlo

Publicado el 3 min de lectura

Una página hecha para el navegador se desplaza sin fin. Un PDF no: tiene un tamaño de papel fijo, márgenes, saltos de página, y un encabezado y un pie que se repiten. Por eso el mismo HTML puede verse bien en pantalla y mal en papel, y por eso conviene saber qué admite un generador de PDF antes de diseñar para él.

Esto es lo que admite el generador de rustedf.cloud, con las trampas que lo acompañan.

Diseño que funciona

  • El modelo de cajas de CSS, incluidos box-sizing, los márgenes y los tamaños min- y max-.
  • Tablas con colspan y rowspan, y filas de encabezado que se repiten en cada página que ocupa la tabla. Eso es lo que mantiene legible una factura o un extracto largo.
  • Flexbox y un subconjunto de grid (grid-template-columns con longitudes, fr, auto y repeat(), además de gap).
  • position: relative y absolute, z-index, texto en columnas y listas.

Medios paginados

Esta es la parte que la mayoría de las páginas web nunca usa, y es lo que un documento necesita.

@page {
size: A4;
margin: 20mm;
@bottom-center { content: "Página " counter(page) " de " counter(pages); }
}
.firma { break-inside: avoid; }
h2 { break-after: avoid; }
  • @page define el tamaño, la orientación y los márgenes, y las cajas de margen superiores e inferiores guardan encabezados y pies, con el número de página y el total de páginas.
  • break-before, break-after y break-inside controlan dónde puede terminar una página. Usa break-inside: avoid para que un bloque de firma o un total nunca quede partido entre dos páginas.
  • Los títulos pasan a ser el índice del PDF, y los enlaces <a href> siguen siendo pulsables.

Pintura

Colores, fondos, linear-gradient(), bordes sólidos, discontinuos y de puntos, border-radius, box-shadow, opacity y overflow: hidden funcionan. Las transformaciones 2D, como rotate() y scale(), también, pero una transformación solo mueve la pintura de un elemento: él conserva el espacio que tenía. Las transformaciones 3D se ignoran.

Las imágenes son PNG y JPEG, subidas a tu cuenta (asset:<id>) o incrustadas como URL data:. Las formas SVG simples (rect, circle, line) se dibujan como vectores.

Qué dejar fuera

  • JavaScript.
  • Animaciones y transiciones.
  • Pseudoclases como :hover y todo lo demás que solo tiene sentido en una pantalla.
  • @font-face y @import. No los necesitas: nombra una familia de fuentes en tu CSS y el servicio la pone a tu disposición. Mira la guía de Fuentes.
  • Imágenes que apuntan a una dirección web. El servicio nunca descarga una dirección que venga de una plantilla.

Nada de esto rompe la generación por defecto. Una función no admitida se ignora y se informa.

Comprueba antes de enviar

Leer una lista no es lo mismo que saber que tu documento está limpio. POST /v1/validate recibe el mismo cuerpo que una generación y construye el documento, pero devuelve un informe en lugar de un PDF, y no gasta crédito.

{
"ok": false,
"pages": 1,
"diagnostics": [
{
"kind": "UnsupportedProperty",
"text": "filter",
"context": "inside <p class=\"note\">",
"count": 2
}
]
}

ok es true cuando no hay nada que informar. Cada aviso indica el tipo de problema, la propiedad o la etiqueta implicada, dónde estaba y cuántas veces ocurrió. Entre los tipos están UnsupportedTag, UnsupportedProperty, UnsupportedSelector, ImageLoadFailed y LayoutOverflow, que señala una caja más alta o más ancha que la página.

En las pruebas, añade "strict": true a una generación. Los mismos avisos hacen entonces que la petición falle con un 422, y no se gasta ningún crédito. Una plantilla que se mantiene limpia en tu batería de pruebas se mantiene limpia en producción.

Consulta la lista completa en HTML y CSS admitidos y en Validar un documento.

← Todos los artículos