rustedf.cloud
Menú

Saltos de página en PDF con CSS: bloques y tablas sin cortes

Publicado el 2 min de lectura

Una página de navegador se desplaza, así que nadie nota dónde termina un bloque. En un PDF, la página termina donde acaba el papel, y lo habitual es cortar donde caiga el contenido. Así una firma acaba sola en la página tres, o un total queda lejos de su tabla. CSS tiene propiedades para esto, y el generador de rustedf.cloud las admite.

Empezar algo en una página nueva

.condiciones { break-before: page; }
.portada { break-after: page; }

break-before y break-after fuerzan un salto antes o después de un elemento. Los nombres más antiguos, page-break-before: always y page-break-after: always, también funcionan. Úsalos para una portada, o para unas condiciones que deban abrir siempre una página nueva.

Mantener un bloque entero

.firma,
.totales,
.tarjeta { break-inside: avoid; }

break-inside: avoid pide al generador que lleve un bloque a la página siguiente en lugar de partirlo. Es la herramienta adecuada para un bloque de firma, una caja de totales o una tarjeta.

Para mantener un título junto al párrafo que le sigue, envuelve ambos en un solo elemento y pon break-inside: avoid en ese envoltorio, para que un título no quede solo al final de una página.

Una tabla pequeña se puede mantener entera del mismo modo, con break-inside: avoid en la propia tabla.

Tablas largas

Una tabla larga tiene que partirse. El generador la continúa en la página siguiente y repite la fila de encabezado en cada página que ocupa la tabla, de modo que el lector no tenga que volver atrás para recordar qué significa una columna. Pon los títulos de las columnas en un <thead>:

<table>
<thead>
<tr><th>Concepto</th><th>Cant.</th><th>Importe</th></tr>
</thead>
<tbody>
{% for line in lines %}
<tr><td>{{ line.name }}</td><td>{{ line.qty }}</td><td>{{ line.amount }}</td></tr>
{% endfor %}
</tbody>
</table>

Líneas en el borde de la página

Dos propiedades más controlan líneas sueltas de un párrafo. orphans es el mínimo de líneas que quedan al final de una página, y widows el mínimo que pasa a la siguiente.

p { orphans: 3; widows: 3; }

El generador aplica el control de viudas y huérfanas, para que un párrafo no deje una línea solitaria arriba o abajo de una página.

Cuando un bloque no se puede partir

break-inside: avoid no ayuda a un bloque más alto que la página. Una caja con una altura fija mayor que el papel, o contenido pintado fuera de él, se informa como LayoutOverflow en la validación. Deja que un bloque así crezca con su contenido en lugar de fijar la altura.

Comprueba el resultado

El número de páginas de una generación está en la cabecera de respuesta X-Pages, y POST /v1/validate lo devuelve como pages sin gastar crédito. Genera un documento con los datos más largos que tengan sentido, porque ahí es donde aparecen los saltos.

Consulta HTML y CSS admitidos y Validar un documento.

← Todos los artículos