Imagina un capítulo a dos columnas que pone una referencia de nota al pie en la penúltima línea de la columna izquierda. Una nota de una línea necesita unos 14 puntos al pie de esa columna, y solo quedan 9. Las dos salidas obvias están mal: dibujar la nota igualmente hace que se imprima sobre el texto del cuerpo, o empujar solo la nota hace que acabe bajo la columna derecha, al lado de un texto con el que no tiene nada que ver. Un navegador nunca tiene que tomar esa decisión, porque una página web no tiene borde inferior. Flexbox y CSS Grid se diseñaron bajo la misma suposición, así que en cuanto el HTML de un informe tiene que caer en páginas de tamaño fijo, cada uno necesita una regla para lo que pasa cuando la caja se queda sin altura
Una fila de dashboard flex en una caja de ancho fijo
PDF Library for Delphi trata cualquier elemento con estilo display: flex o display: inline-flex como un contenedor flex de verdad, así que una fila de tarjetas se queda siendo una fila en lugar de colapsar en bloques apilados. La dibujas con DrawHTMLTextBox(Left, Top, Width, Height, HTMLText), que devuelve un WideString: vacío cuando todo cupo, si no, la parte que todavía hay que dibujar en otro sitio
En la dirección de fila cada elemento recibe una base, se suman los valores de base y los gaps entre elementos, y lo que sobre en la línea se reparte. El espacio positivo se reparte por flex-grow. El espacio negativo se recupera por flex-shrink multiplicado por la base del elemento, que es la regla de CSS y tiene un efecto secundario agradable que se muestra enseguida. Con flex-wrap activado, los elementos pasan a una línea nueva en cuanto la siguiente base ya no cabe, y cada línea reparte su propio espacio libre. justify-content, align-items, align-content, gap y las direcciones -reverse después solo mueven cajas ya medidas
uses
SysUtils, PDFlibrary;
var
Lib: TPDFlib;
Html, Remainder: WideString;
begin
Lib := TPDFlib.Create;
try
Lib.SetOrigin(1); // origen arriba-izquierda: Top crece hacia abajo por la página
Lib.SetPageSize('A4');
// Las bases porcentuales mantienen la proporción 2:1:1 exacta, gap incluido
Html :=
'<div style="display:flex; gap:12px;">' +
'<div style="flex:0 1 50%; background:#f4f6f8; padding:8px;">' +
'<b>Revenue</b><br/>EUR 4,182,300</div>' +
'<div style="flex:0 1 25%; background:#f4f6f8; padding:8px;">' +
'<b>Margin</b><br/>18.4%</div>' +
'<div style="flex:0 1 25%; background:#f4f6f8; padding:8px;">' +
'<b>Backlog</b><br/>92 days</div>' +
'</div>';
Remainder := Lib.DrawHTMLTextBox(40, 40, 515, 120, Html);
if Remainder <> '' then
raise Exception.Create('Dashboard row needs more than 120 pt');
Lib.SaveToFile('dashboard.pdf');
finally
Lib.Free;
end;
end;
Haz los números para la caja de 515 puntos. El gap de 12px equivale a 9 puntos, así que dos gaps cuestan 18. Las bases suman los 515 enteros, que se pasan exactamente por esos 18 puntos. El shrink se pondera por la base, así que la tarjeta del 50% devuelve 9 puntos y cada tarjeta del 25% devuelve 4.5, quedando 248.5, 124.25 y 124.25. La proporción sigue siendo exactamente 2:1:1, y el código nunca tuvo que restar los gaps a mano
¿Por qué elementos con flex: 1 iguales salen desiguales?
Porque su base es el ancho de su contenido. El renderizador toma la base de flex-basis, de una longitud dentro del atajo flex (un valor con pt, px, em o %), o de width. Cuando ninguno de esos produce una longitud positiva, el ancho del contenido medido del elemento se convierte en su base. Un flex: 1 pelado y el modismo de navegador flex: 1 1 0 acaban ahí los dos, ya que un 0 sin unidad no se lee como longitud. Factores de grow iguales añaden entonces cantidades iguales de espacio libre sobre anchos iniciales desiguales
Escribe el mismo dashboard con flex: 1 en cada tarjeta y la tarjeta de Revenue, cuya cifra de siete dígitos hace que su contenido sea el más ancho de las tres, empieza más ancha que la de Margin y se queda más ancha por exactamente esa cantidad después del crecimiento, porque cada tarjeta recibe el mismo tercio del espacio libre que quede. Para barras de herramientas, listas de etiquetas y filas de botones ese suele ser el look que quieres de todos modos. Para un dashboard, no. Todo lo que tenga que alinearse con una tabla por encima o por debajo merece bases explícitas en porcentaje o puntos con grow a 0, que es nuestra recomendación y exactamente lo que hace el ejemplo: las tres tarjetas caen entonces en 248.5, 124.25 y 124.25 puntos en cada página, digan lo que digan las cifras que llevan dentro
La dirección de columna sigue la misma lógica en el eje vertical. La base sale de flex-basis o de height, si no, de la altura de contenido medida, y el espacio libre solo existe cuando el contenedor declara una height. Sin ella, el contenedor es exactamente tan alto como sus elementos y justify-content no tiene nada que repartir
Pistas de grid, colocación y spans
Para display: grid, PDF Library for Delphi lee grid-template-columns y grid-template-rows como longitudes fijas, porcentajes, unidades fr, repeat(n, track) y minmax(a, b). Las pistas fijas y los gaps se restan del ancho disponible, y el resto se reparte por peso de fr. Una pista minmax() se dimensiona por su segundo argumento, así que minmax(120px, 1fr) se comporta como 1fr, y las pistas auto, min-content y max-content se llevan cada una una parte del espacio libre
La colocación es determinista. Los elementos auto-colocados recorren el grid fila a fila (o columna a columna con grid-auto-flow: column) y se saltan las celdas ya ocupadas. Un elemento al que solo se le da una fila busca en esa fila una columna libre; uno al que solo se le da una columna busca hacia abajo por esa columna. Los elementos con ambas coordenadas van exactamente donde dicen, incluso encima de otro elemento, que es cómo una insignia acaba superpuesta a una tarjeta
Los spans necesitan un hábito. El renderizador lee un span de la parte tras la barra, como en grid-row: 1 / span 2, o de grid-row-end: span 2 y grid-column-end: span 2. El grid-row: span 2 pelado que los navegadores aceptan como valor completo no está entre esas grafías, así que conserva la línea de inicio y la barra
// Hoja de inspección: columna de etiquetas fija, dos columnas flexibles
Html :=
'<div style="display:grid; ' +
'grid-template-columns:120pt repeat(2, 1fr); gap:6pt;">' +
'<div style="grid-row:1 / span 2; background:#eef2ff;">' +
'Site plan</div>' +
'<div>Inspector</div>' +
'<div>Date</div>' +
'<div style="grid-column:2 / span 2;">Findings summary</div>' +
'</div>';
Remainder := Lib.DrawHTMLTextBox(40, 180, 515, 260, Html);
En esa caja de 515 puntos la columna de etiquetas ocupa 120 puntos, los dos gaps se llevan 12, y cada columna 1fr recibe 191.5. La celda Site plan tiene fila pero no columna, así que cae en la columna 1 y cubre las filas 1 y 2. Inspector y Date llenan el resto de la fila 1. El resumen tiene columna pero no fila, así que la colocación busca hacia abajo por la columna 2, encuentra la fila 1 ocupada y se instala en la fila 2 a lo ancho de las dos columnas flexibles
Las alturas de fila salen del contenido. Como un elemento que abarca divide su altura medida en partes iguales entre las filas que cubre, y cada fila se queda luego con la mayor parte que cualquier elemento dentro pida, la altura extra de una celda alta se reparte por todas las filas que toca en lugar de descargarse en la primera. Una celda Site plan alta levanta por tanto las dos filas un poco en lugar de estirar solo la primera y dejar el Findings summary flotando en un hueco
Los contenedores pasan entre cajas enteros
Un contenedor flex o grid nunca se parte entre dos cajas. Nunca. Cuando el contenedor entero no cabe en el espacio que queda, el contenedor y todo lo que va detrás entran en el remainder devuelto, y como ese remainder es exactamente lo que le pasas a la siguiente caja o a la siguiente página, la fila de tarjetas simplemente abre el cuadro siguiente con su geometría medida intacta. Medio tile de KPI al pie de la página 3 y la otra mitad en la página 4 es peor que un hueco, y ese es el compromiso que esta regla hace. Un contenedor más alto que una caja entera vacía es la excepción: se dibuja arriba de esa caja igualmente y se pasa de su borde inferior, porque ninguna caja posterior sería más grande
La consecuencia práctica es que conviene conocer la altura de un contenedor antes de comprometerlo a una página. GetHTMLTextHeight(Width, HTMLText) mide sin dibujar, flex y grid incluidos
// GridHtml, Y y PageBottom pertenecen a tu código de informe
Needed := Lib.GetHTMLTextHeight(515, GridHtml);
if Y + Needed > PageBottom then
begin
Lib.NewPage;
Lib.SetPageSize('A4');
Y := 40;
end;
Lib.DrawHTMLTextBox(40, Y, 515, Needed, GridHtml);
Y := Y + Needed + 12;
La medición está acotada a propósito, algo que importa cuando los clientes editan plantillas. Un contenedor flex o grid toma sus primeros 256 hijos directos, la colocación de grid funciona dentro de 64 filas, y una lista de pistas lleva como mucho 64 pistas, con los recuentos de repeat() limitados en consecuencia. Un contenedor flex con cientos de hijos es casi siempre una tabla de datos disfrazada, y la vía de tabla, con su propia medición de columnas y soporte de rowspan, la dispone mejor de todos modos
¿Cómo se mantienen las notas al pie junto a su referencia?
PDF Library for Delphi mide cada nota en el momento en que se encuentra con la referencia y resta esa altura del presupuesto de cuerpo de la caja actual. Una nota se escribe como <aside style="float:footnote">, <aside role="doc-footnote"> o un elemento <footnote>. La referencia se convierte en un número en superíndice a dos tercios del tamaño de fuente circundante, y el texto de la nota se compone a 8 puntos con interlineado de 10 puntos, precedido del mismo número
Si el cuerpo acumulado más la nota nueva ya no caben, el marcador y todo lo que va detrás se pasan juntos al remainder. Nota y referencia viajan en pareja. Esa es la respuesta al escenario del arranque: la línea de la referencia y su nota abren la columna siguiente, y ni la superposición ni la nota huérfana pueden ocurrir. En una caja acotada el área de notas se fija abajo bajo una fina línea gris de un cuarto del ancho de la caja. En medición sin acotar, como GetHTMLTextHeight, no hay borde inferior donde fijarse, así que las notas siguen al cuerpo directamente
La numeración empieza en 1 para cada cadena HTML nueva. El número siguiente se guarda dentro de la propia cadena remainder, así que las cadenas de DrawHTMLTextBox y DrawHTMLStory mantienen una única secuencia en marcha entre columnas y páginas, siempre que el remainder se devuelva exactamente como se retornó. Reconstruir la continuación desde tu propio texto fuente reinicia el recuento
Chapter :=
'<p>The bearing stayed within tolerance for the full six hours' +
'<aside style="float:footnote">Ambient temperature held at ' +
'21 °C throughout the run.</aside> of the load test.</p>' +
MoreChapterHtml; // el resto de tu capítulo
// 2 columnas, canal de 16 pt, como mucho 20 páginas; la historia añade páginas ella sola
Rest := Lib.DrawHTMLStory(40, 40, 515, 760, 2, 16, 20, Chapter);
Err := Lib.LastErrorCode; // leer una vez: leerlo lo resetea
if Err = PDFLIB_ERROR_HTML_STORY_INVALID then
// geometría mala: Columns 1..64, MaxPages 1..10000, canales más estrechos que Width
else if Err = PDFLIB_ERROR_HTML_STORY then
// dos marcos seguidos sin avance
else if Rest <> '' then
// 20 páginas usadas y queda texto: continúa luego con Rest
;
DrawHTMLStory(Left, Top, Width, Height, Columns, Gutter, MaxPages, HTMLText) empieza en la página actual, llena las columnas de izquierda a derecha y añade páginas con las mismas dimensiones hasta que el texto se agota o se llega a MaxPages. Distinguir esos tres desenlaces es la razón para leer LastErrorCode antes de comprobar la cadena devuelta. Los argumentos inválidos devuelven la entrada sin cambios, lo que si no se parece mucho a una historia que se quedó sin páginas
Alimentar la disposición desde contenido real
Para texto de cuerpo a varias columnas, el comportamiento de columnas y guionado descrito en el guionado y las columnas de texto equilibradas rige el aspecto del flujo dentro de cada columna. Cuando el marcado sale de datos en lugar de plantillas escritas a mano, el motor de informes basado en dataset es la vía que lo genera antes de que flex y grid lo dispongan en la página. El contenido que después tiene que salir otra vez del PDF pasa por exportar PDF a Markdown y DOCX
La disposición HTML con flex, grid y notas al pie, la generación de informes y la exportación semántica vienen en una misma biblioteca para Delphi, C++Builder y Free Pascal. La página de producto de PDF Library for Delphi lista el resto del renderizador HTML y la API de dibujo