Angenommen, ein zweispaltiges Kapitel setzt eine Fußnotenreferenz auf die vorletzte Zeile der linken Spalte. Eine einzeilige Notiz braucht an der Unterseite dieser Spalte rund 14 Punkt, und übrig sind nur 9. Beide naheliegenden Ausgänge sind falsch: Die Notiz trotzdem zeichnen und sie druckt über den Fließtext, oder nur die Notiz weiterreichen und sie landet unter der rechten Spalte, neben Text, mit dem sie nichts zu tun hat. Ein Browser muss diese Entscheidung nie treffen, denn eine Webseite hat keine Unterkante. Flexbox und CSS Grid wurden unter derselben Annahme entworfen, also braucht jedes von ihnen eine Regel dafür, was passiert, wenn der Box die Höhe ausgeht, sobald Berichts-HTML auf feste Seitengrößen muss
Eine Flex-Dashboard-Zeile in einer Box fester Breite
PDF Library for Delphi behandelt jedes Element mit display: flex oder display: inline-flex als echten Flex-Container, also bleibt eine Kartenreihe eine Reihe, statt zu gestapelten Blöcken zu kollabieren. Gezeichnet wird sie mit DrawHTMLTextBox(Left, Top, Width, Height, HTMLText), das einen WideString zurückgibt: leer, wenn alles gepasst hat, sonst der Teil, der noch irgendwoanders gezeichnet werden muss
In Zeilenrichtung bekommt jedes Element eine Basis, die Basiswerte und die Abstände zwischen den Elementen werden summiert, und was auf der Zeile übrig bleibt, wird verteilt. Positiver Raum geht nach flex-grow. Negativer Raum wird über flex-shrink multipliziert mit der Basis des Elements zurückgeholt, was die CSS-Regel ist und gleich einen angenehmen Nebeneffekt zeigt. Mit gesetztem flex-wrap rücken Elemente auf eine neue Zeile, sobald die nächste Basis nicht mehr passt, und jede Zeile verteilt ihren eigenen freien Raum. justify-content, align-items, align-content, gap und die -reverse-Richtungen verschieben dann nur noch Boxen, die bereits vermessen sind
uses
SysUtils, PDFlibrary;
var
Lib: TPDFlib;
Html, Remainder: WideString;
begin
Lib := TPDFlib.Create;
try
Lib.SetOrigin(1); // Ursprung oben links: Top wächst die Seite hinunter
Lib.SetPageSize('A4');
// Prozentuale Basen halten das Verhältnis 2:1:1 exakt, Gap inklusive
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;
Rechnen wir die 515-Punkt-Box nach. Der Gap von 12px wird zu 9 Punkt, also kosten zwei Gaps 18. Die Basen summieren sich zu vollen 515, was um genau diese 18 Punkte hinausgeht. Shrink wird mit der Basis gewichtet, also gibt die 50-%-Karte 9 Punkte zurück und jede 25-%-Karte 4,5, übrig bleiben 248,5, 124,25 und 124,25. Das Verhältnis ist weiterhin exakt 2:1:1, und der Code musste die Gaps nie von Hand abziehen
Warum fallen gleiche flex: 1-Elemente unterschiedlich aus?
Weil ihre Basis die Breite ihres Inhalts ist. Der Renderer nimmt eine Basis aus flex-basis, aus einer Länge innerhalb des flex-Kürzels (ein Wert mit pt, px, em oder %) oder aus width. Wenn keine dieser Angaben eine positive Länge liefert, wird die gemessene Content-Breite des Elements zu seiner Basis. Ein nacktes flex: 1 und das Browser-Idiom flex: 1 1 0 landen beide dort, denn ein einheitsloses 0 wird nicht als Länge gelesen. Gleiche Grow-Faktoren legen dann gleiche Anteile freien Raums auf ungleiche Startbreiten
Schreibt man dasselbe Dashboard mit flex: 1 auf jeder Karte, startet die Revenue-Karte, deren siebenstellige Zahl ihren Inhalt zum breitesten der drei macht, breiter als die Margin-Karte und bleibt nach dem Wachstum genau um diesen Betrag breiter, denn jede Karte bekommt dasselbe Drittel des verbliebenen freien Raums. Für Toolbars, Tag-Listen und Button-Reihen ist das oft ohnehin der gewünschte Look. Für ein Dashboard nicht. Alles, was mit einer Tabelle darüber oder darunter fluchten muss, verdient explizite prozentuale oder Punkt-Basen mit Grow auf 0, das ist unsere Empfehlung und genau das, was das Beispiel tut: Die drei Karten landen dann auf jeder Seite bei 248,5, 124,25 und 124,25 Punkten, ganz gleich, was die Zahlen darin sagen
Die Spaltenrichtung folgt derselben Logik auf der vertikalen Achse. Die Basis kommt aus flex-basis oder height, sonst aus der gemessenen Content-Höhe, und freien Raum gibt es nur, wenn der Container eine height deklariert. Ohne eine ist der Container exakt so hoch wie seine Elemente, und justify-content hat nichts zu verteilen
Grid-Spuren, Platzierung und Spans
Für display: grid liest PDF Library for Delphi grid-template-columns und grid-template-rows als feste Längen, Prozentwerte, fr-Einheiten, repeat(n, track) und minmax(a, b). Feste Spuren und Gaps werden von der verfügbaren Breite abgezogen, der Rest wird nach fr-Gewicht aufgeteilt. Eine minmax()-Spur wird über ihr zweites Argument bemessen, also verhält sich minmax(120px, 1fr) wie 1fr, und auto-, min-content- und max-content-Spuren bekommen jeweils einen Anteil des freien Raums
Die Platzierung ist deterministisch. Automatisch platzierte Elemente laufen die Grid-Zeile für Zeile ab (oder Spalte für Spalte bei grid-auto-flow: column) und überspringen belegte Zellen. Ein Element, dem nur eine Zeile gegeben ist, durchsucht diese Zeile nach einer freien Spalte; eines, dem nur eine Spalte gegeben ist, durchsucht diese Spalte nach unten. Elemente mit beiden Koordinaten landen exakt dort, wo sie es sagen, auch auf einem anderen Element – so kommt ein Badge über eine Karte zu liegen
Spans brauchen eine Gewohnheit. Der Renderer liest einen Span aus dem Teil hinter dem Schrägstrich, wie in grid-row: 1 / span 2, oder aus grid-row-end: span 2 und grid-column-end: span 2. Das nackte grid-row: span 2, das Browser als ganzen Wert akzeptieren, gehört nicht zu diesen Schreibweisen, also Startlinie und Schrägstrich behalten
// Prüfprotokoll: feste Beschriftungsspalte, zwei flexible Spalten
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);
In dieser 515-Punkt-Box ist die Beschriftungsspalte 120 Punkte breit, die beiden Gaps nehmen 12, und jede 1fr-Spalte bekommt 191,5. Die Site-plan-Zelle hat eine Zeile, aber keine Spalte, also landet sie in Spalte 1 und deckt die Zeilen 1 und 2 ab. Inspector und Date füllen den Rest der Zeile 1. Die Zusammenfassung hat eine Spalte, aber keine Zeile, also durchsucht die Platzierung Spalte 2 nach unten, findet Zeile 1 belegt und richtet sich in Zeile 2 über beide flexiblen Spalten ein
Zeilenhöhen kommen aus dem Inhalt. Weil ein überspannendes Element seine gemessene Höhe gleichmäßig auf die Zeilen verteilt, die es abdeckt, und jede Zeile dann den größten Anteil nimmt, den irgendein Element in ihr verlangt, wird die zusätzliche Höhe einer hohen Zelle über jede Zeile verteilt, die sie berührt, statt auf der ersten abgeladen. Eine hohe Site-plan-Zelle hebt also beide Zeilen ein wenig an, statt nur die erste zu dehnen und Findings summary in einer Lücke schweben zu lassen
Container wechseln Boxen im Ganzen
Ein Flex- oder Grid-Container wird nie über zwei Boxen zerteilt. Nie. Passt der ganze Container nicht in den verbliebenen Raum, gehen Container und alles danach in die zurückgegebene Restmenge, und da diese Restmenge genau das ist, was man an die nächste Box oder nächste Seite übergibt, öffnet die Kartenreihe schlicht den folgenden Rahmen mit ihrer vermessenen Geometrie unversehrt. Eine halbe KPI-Kachel unten auf Seite 3 und die andere Hälfte auf Seite 4 ist schlimmer als eine Lücke, und das ist der Kompromiss, den diese Regel eingeht. Ein Container, der höher ist als eine ganze leere Box, ist die Ausnahme: Er wird trotzdem oben in dieser Box gezeichnet und läuft über ihre Unterkante hinaus, denn keine spätere Box wäre größer
Die praktische Folge: Man sollte die Höhe eines Containers kennen, bevor man ihn einer Seite übergibt. GetHTMLTextHeight(Width, HTMLText) vermisst, ohne zu zeichnen, Flex und Grid eingeschlossen
// GridHtml, Y und PageBottom gehören zu Ihrem Berichtscode
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;
Die Vermessung ist bewusst begrenzt, was wichtig ist, wenn Kunden Vorlagen bearbeiten. Ein Flex- oder Grid-Container nimmt seine ersten 256 direkten Kinder, die Grid-Platzierung funktioniert innerhalb von 64 Zeilen, und eine Spurliste fasst höchstens 64 Spuren, mit auf dasselbe Limit gekappten repeat()-Zählern. Ein Flex-Container mit hunderten Kindern ist fast immer eine Datenbanktabelle in Verkleidung, und der Tabellenpfad mit seiner eigenen Spaltenvermessung und rowspan-Unterstützung bringt sie ohnehin besser unter
Wie bleiben Fußnoten bei ihrer Referenz?
PDF Library for Delphi vermisst jede Notiz in dem Moment, in dem sie auf die Referenz trifft, und zieht diese Höhe vom Fließtextbudget der aktuellen Box ab. Eine Notiz wird als <aside style="float:footnote">, <aside role="doc-footnote"> oder als <footnote>-Element geschrieben. Die Referenz wird zu einer hochgestellten Zahl in zwei Dritteln der umgebenden Schriftgröße, und der Notiztext wird mit 8 Punkt auf 10 Punkt Durchschuss gesetzt, mit derselben Zahl vorangestellt
Passt der bisherige Fließtext zusammen mit der neuen Notiz nicht mehr, wandern Marker und alles danach zusammen in die Restmenge. Notiz und Referenz reisen als Paar. Das ist die Antwort auf das Eingangsszenario: Die Referenzzeile und ihre Notiz eröffnen die nächste Spalte, und weder das Überdrucken noch die verwaiste Notiz kann passieren. In einer begrenzten Box ist die Notizfläche an der Unterkante unter einer dünnen grauen Linie fixiert, ein Viertel der Boxbreite lang. Bei unbegrenzter Vermessung, etwa GetHTMLTextHeight, gibt es keine Unterkante zum Fixieren, also folgen die Notizen direkt dem Fließtext
Die Nummerierung beginnt bei 1 für jede frische HTML-Zeichenkette. Die nächste Nummer wird in der Restzeichenkette selbst gespeichert, also halten DrawHTMLTextBox-Ketten und DrawHTMLStory eine durchlaufende Sequenz über Spalten und Seiten, sofern die Restmenge exakt so zurückgegeben wird, wie sie geliefert wurde. Die Fortsetzung aus eigenem Quelltext neu aufzubauen startet die Zählung neu
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; // der Rest Ihres Kapitels
// 2 Spalten, 16 pt Gutter, höchstens 20 Seiten; die Story fügt Seiten selbst hinzu
Rest := Lib.DrawHTMLStory(40, 40, 515, 760, 2, 16, 20, Chapter);
Err := Lib.LastErrorCode; // einmal lesen: das Lesen setzt ihn zurück
if Err = PDFLIB_ERROR_HTML_STORY_INVALID then
// schlechte Geometrie: Columns 1..64, MaxPages 1..10000, Gutters schmaler als Width
else if Err = PDFLIB_ERROR_HTML_STORY then
// zwei Rahmen hintereinander ohne Fortschritt
else if Rest <> '' then
// 20 Seiten verbraucht und Text bleibt: später mit Rest weitermachen
;
DrawHTMLStory(Left, Top, Width, Height, Columns, Gutter, MaxPages, HTMLText) beginnt auf der aktuellen Seite, füllt die Spalten von links nach rechts und fügt Seiten derselben Abmessungen hinzu, bis der Text aus ist oder MaxPages erreicht ist. Diese drei Ausgänge auseinanderzuhalten ist der Grund, LastErrorCode zu lesen, bevor man die zurückgegebene Zeichenkette prüft. Ungültige Argumente geben die Eingabe unverändert zurück, was sonst genau wie eine Story aussieht, deren Seiten aufgebraucht sind
Das Layout aus echtem Inhalt speisen
Für mehrspaltigen Fließtext bestimmt das in Silbentrennung und ausgewogene Textspalten beschriebene Spalten- und Silbentrennungsverhalten, wie der Fluss innerhalb jeder Spalte aussieht. Stammt das Markup aus Daten statt aus handgeschriebenen Vorlagen, ist die Dataset-Report-Engine der Weg, der es erzeugt, bevor Flex und Grid es auf der Seite anordnen. Inhalte, die das PDF später wieder verlassen müssen, laufen über PDF nach Markdown und DOCX exportieren
HTML-Layout mit Flex, Grid und Fußnoten, Berichtserzeugung und semantischer Export kommen in einer Bibliothek für Delphi, C++Builder und Free Pascal. Die Produktseite der PDF Library for Delphi listet den Rest des HTML-Renderers und der Zeichnungs-API auf