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ñosmin-ymax-. - Tablas con
colspanyrowspan, 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-columnscon longitudes,fr,autoyrepeat(), además degap). position: relativeyabsolute,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; }@pagedefine 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-afterybreak-insidecontrolan dónde puede terminar una página. Usabreak-inside: avoidpara 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
:hovery todo lo demás que solo tiene sentido en una pantalla. @font-facey@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.
Sigue leyendo
Primeros pasos
HTML a PDF: ¿biblioteca, navegador headless o API? Cómo elegir
Tres formas de convertir HTML en PDF, qué pide cada una que ejecutes y mantengas, qué HTML y CSS obtienes, y una lista corta de preguntas que deciden.
4 min de lectura
Primeros pasos
Cómo generar una factura en PDF con una API
Crea una plantilla de factura con líneas en bucle, moneda y fecha por país, y genera el PDF con una petición. Ejemplo completo en HTML y curl.
2 min de lectura
Primeros pasos
Cómo generar un PDF desde HTML con una sola petición
Envía HTML y datos en un POST y recibe el PDF. Ejemplo con curl y Node.js, y qué saber sobre imágenes, límites y créditos.
2 min de lectura
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura