Imaginez un chapitre à deux colonnes qui place une référence de note de bas de page sur l'avant-dernière ligne de la colonne de gauche. Une note d'une ligne demande environ 14 points au pied de cette colonne, et il n'en reste que 9. Les deux issues évidentes sont fausses : dessiner la note quand même et elle s'imprime sur le texte du corps, ou pousser seulement la note et elle se retrouve sous la colonne de droite, à côté d'un texte qui ne la concerne pas. Un navigateur n'a jamais à faire ce choix, parce qu'une page web n'a pas de bord inférieur. Flexbox et CSS Grid ont été conçus sous la même hypothèse, donc dès que du HTML de rapport doit atterrir sur des pages de taille fixe, chacun d'eux a besoin d'une règle pour ce qui se passe quand la boîte n'a plus de hauteur
Une ligne flex de tableau de bord dans une boîte à largeur fixe
PDF Library for Delphi traite tout élément stylé display: flex ou display: inline-flex comme un vrai conteneur flex, si bien qu'une rangée de cartes reste une rangée au lieu de s'effondrer en blocs empilés. Vous la dessinez avec DrawHTMLTextBox(Left, Top, Width, Height, HTMLText), qui renvoie un WideString : vide quand tout est entré, sinon la partie qui doit encore être dessinée ailleurs
Dans la direction de la rangée, chaque élément reçoit une base, les bases et les gouttières entre éléments sont sommées, et ce qui reste sur la ligne est distribué. L'espace positif part selon flex-grow. L'espace négatif est repris par flex-shrink multiplié par la base de l'élément, ce qui est la règle CSS et a un effet de bord agréable montré dans un instant. Avec flex-wrap positionné, les éléments passent à une nouvelle ligne dès que la base suivante n'entre plus, et chaque ligne distribue son propre espace libre. justify-content, align-items, align-content, gap et les directions -reverse ne déplacent ensuite que des boîtes déjà mesurées
uses
SysUtils, PDFlibrary;
var
Lib: TPDFlib;
Html, Remainder: WideString;
begin
Lib := TPDFlib.Create;
try
Lib.SetOrigin(1); // origine en haut à gauche : Top grandit vers le bas de la page
Lib.SetPageSize('A4');
// Des bases en pourcentage gardent le ratio 2:1:1 exact, gouttière incluse
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;
Faites les calculs pour la boîte de 515 points. La gouttière de 12px convertit en 9 points, donc deux gouttières coûtent 18. Les bases s'additionnent aux 515 complets, ce qui dépasse d'exactement ces 18 points. Le shrink est pondéré par la base, donc la carte de 50 % rend 9 points et chaque carte de 25 % rend 4.5, laissant 248.5, 124.25 et 124.25. Le ratio reste exactement 2:1:1, et le code n'a jamais eu à soustraire les gouttières à la main
Pourquoi des éléments flex: 1 égaux sortent-ils inégaux ?
Parce que leur base est la largeur de leur contenu. Le moteur de rendu prend une base depuis flex-basis, depuis une longueur à l'intérieur du raccourci flex (une valeur avec pt, px, em ou %), ou depuis width. Quand aucune de celles-ci ne produit une longueur positive, la largeur de contenu mesurée de l'élément devient sa base. Un flex: 1 nu et l'idiome de navigateur flex: 1 1 0 aboutissent tous deux là, puisque un 0 sans unité n'est pas lu comme une longueur. Des facteurs de grow égaux ajoutent alors des quantités égales d'espace libre au-dessus de largeurs de départ inégales
Écrivez le même tableau de bord avec flex: 1 sur chaque carte et la carte Revenue, dont le chiffre à sept chiffres rend son contenu le plus large des trois, démarre plus large que la carte Margin et reste plus large d'exactement cet écart après croissance, parce que chaque carte reçoit le même tiers de l'espace libre restant. Pour des barres d'outils, des listes d'étiquettes et des rangées de boutons, c'est souvent le look que vous voulez de toute façon. Pas pour un tableau de bord. Tout ce qui doit s'aligner avec un tableau au-dessus ou en dessous mérite des bases explicites en pourcentage ou en points avec grow à 0, ce qui est notre recommandation et exactement ce que fait l'exemple : les trois cartes atterrissent alors à 248.5, 124.25 et 124.25 points sur chaque page, quoi qu'en disent les chiffres à l'intérieur
La direction colonne suit la même logique sur l'axe vertical. La base vient de flex-basis ou de height, sinon de la hauteur de contenu mesurée, et l'espace libre n'existe que quand le conteneur déclare une height. Sans elle, le conteneur est exactement aussi haut que ses éléments et justify-content n'a rien à distribuer
Pistes de grille, placement et étendues
Pour display: grid, PDF Library for Delphi lit grid-template-columns et grid-template-rows comme longueurs fixes, pourcentages, unités fr, repeat(n, track) et minmax(a, b). Les pistes fixes et les gouttières sont soustraites de la largeur disponible, et le reste est partagé selon le poids fr. Une piste minmax() est dimensionnée par son second argument, donc minmax(120px, 1fr) se comporte comme 1fr, et les pistes auto, min-content et max-content prennent chacune une part de l'espace libre
Le placement est déterministe. Les éléments auto-placés parcourent la grille rangée par rangée (ou colonne par colonne avec grid-auto-flow: column) et sautent les cellules déjà prises. Un élément avec seulement une rangée donnée cherche dans cette rangée une colonne libre ; un élément avec seulement une colonne donnée descend cette colonne. Les éléments avec les deux coordonnées vont exactement où ils le disent, même par-dessus un autre élément, et c'est ainsi qu'un badge se superpose à une carte
Les étendues demandent une habitude. Le moteur de rendu lit une étendue depuis la partie après la barre oblique, comme dans grid-row: 1 / span 2, ou depuis grid-row-end: span 2 et grid-column-end: span 2. Le grid-row: span 2 nu que les navigateurs acceptent comme valeur entière n'est pas une de ces orthographes, donc gardez la ligne de départ et la barre oblique
// Feuille d'inspection : colonne d'étiquettes fixe, deux colonnes 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);
Dans cette boîte de 515 points, la colonne d'étiquettes fait 120 points, les deux gouttières prennent 12, et chaque colonne 1fr obtient 191.5. La cellule Site plan a une rangée mais pas de colonne, donc elle atterrit en colonne 1 et couvre les rangées 1 et 2. Inspector et Date remplissent le reste de la rangée 1. Le résumé a une colonne mais pas de rangée, donc le placement descend la colonne 2, trouve la rangée 1 occupée, et s'installe en rangée 2 sur les deux colonnes flexibles
Les hauteurs de rangées viennent du contenu. Comme un élément étendu divise sa hauteur mesurée également entre les rangées qu'il couvre, et que chaque rangée prend ensuite la plus grande part demandée par un élément qu'elle contient, la hauteur supplémentaire d'une cellule haute se répartit sur chaque rangée qu'elle touche au lieu de s'abattre sur la première. Une cellule Site plan haute fait donc monter les deux rangées un peu au lieu d'étirer seulement la première et de laisser Findings summary flotter dans un vide
Les conteneurs passent d'une boîte à l'autre en un seul morceau
Un conteneur flex ou grid n'est jamais scindé entre deux boîtes. Jamais. Quand le conteneur entier ne tient pas dans l'espace restant, le conteneur et tout ce qui le suit partent dans le reste renvoyé, et comme ce reste est exactement ce que vous passez à la boîte suivante ou à la page suivante, la rangée de cartes ouvre simplement le cadre suivant avec sa géométrie mesurée intacte. Un demi-tuile KPI au bas de la page 3 et l'autre moitié en page 4 est pire qu'un vide, et c'est le compromis que fait cette règle. Un conteneur plus haut qu'une boîte entière vide est l'exception : il est dessiné en haut de cette boîte quand même et dépasse son bord inférieur, parce qu'aucune boîte ultérieure ne serait plus grande
La conséquence pratique est que vous devriez connaître la hauteur d'un conteneur avant de l'engager sur une page. GetHTMLTextHeight(Width, HTMLText) mesure sans dessiner, flex et grid compris
// GridHtml, Y et PageBottom appartiennent à votre code de rapport
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 mesure est bornée exprès, ce qui compte quand les clients éditent les modèles. Un conteneur flex ou grid prend ses 256 premiers enfants directs, le placement de grille marche dans 64 rangées, et une liste de pistes contient au plus 64 pistes, avec des compteurs repeat() plafonnés pour coller. Un conteneur flex avec des centaines d'enfants est presque toujours un tableau de données déguisé, et le chemin tableau, avec sa propre mesure de colonnes et son support de rowspan, le met en page mieux de toute façon
Comment les notes de bas de page restent-elles avec leur référence ?
PDF Library for Delphi mesure chaque note au moment où elle rencontre la référence et soustrait cette hauteur du budget de corps de la boîte courante. Une note s'écrit <aside style="float:footnote">, <aside role="doc-footnote"> ou un élément <footnote>. La référence devient un numéro en exposant aux deux tiers de la taille de police environnante, et le texte de la note est composé en 8 points sur un interligne de 10 points, préfixé du même numéro
Si le corps jusque-là plus la nouvelle note ne tiennent plus, le marqueur et tout ce qui le suit partent ensemble dans le reste. Note et référence voyagent en paire. C'est la réponse au scénario d'ouverture : la ligne de référence et sa note ouvrent la colonne suivante, et ni le surimprimé ni la note orpheline ne peuvent arriver. Dans une boîte bornée, la zone de notes est fixée en bas sous un mince filet gris d'un quart de la largeur de la boîte. En mesure non bornée, comme GetHTMLTextHeight, il n'y a pas de bas où se fixer, donc les notes suivent le corps directement
La numérotation repart à 1 pour chaque chaîne HTML fraîche. Le numéro suivant est stocké à l'intérieur de la chaîne de reste elle-même, donc les chaînes de DrawHTMLTextBox et DrawHTMLStory gardent une séquence courante à travers les colonnes et les pages, à condition que le reste soit repassé exactement tel qu'il a été renvoyé. Reconstruire la continuation depuis votre propre texte source recommence le compte
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; // le reste de votre chapitre
// 2 colonnes, gouttière de 16 pt, au plus 20 pages ; le récit ajoute les pages lui-même
Rest := Lib.DrawHTMLStory(40, 40, 515, 760, 2, 16, 20, Chapter);
Err := Lib.LastErrorCode; // lire une fois : la lecture le remet à zéro
if Err = PDFLIB_ERROR_HTML_STORY_INVALID then
// géométrie mauvaise : Columns 1..64, MaxPages 1..10000, gouttières plus étroites que Width
else if Err = PDFLIB_ERROR_HTML_STORY then
// deux boîtes d'affilée sans aucun progrès
else if Rest <> '' then
// 20 pages utilisées et du texte reste : continuez plus tard avec Rest
;
DrawHTMLStory(Left, Top, Width, Height, Columns, Gutter, MaxPages, HTMLText) démarre sur la page courante, remplit les colonnes de gauche à droite, et ajoute des pages avec les mêmes dimensions jusqu'à épuisement du texte ou atteinte de MaxPages. Distinguer ces trois issues est la raison de lire LastErrorCode avant de tester la chaîne renvoyée. Des arguments invalides renvoient l'entrée inchangée, ce qui sinon ressemble exactement à un récit à court de pages
Nourrir la mise en page depuis le contenu réel
Pour le texte du corps multi-colonnes, le comportement de colonnes et de césure décrit dans la césure et les colonnes de texte équilibrées régit l'apparence du flux à l'intérieur de chaque colonne. Quand le balisage vient de données plutôt que de modèles écrits à la main, le moteur de rapports par jeu de données est la voie qui le génère avant que flex et grid ne l'arrangent sur la page. Le contenu qui doit ensuite ressortir du PDF passe par l'export de PDF vers Markdown et DOCX
La mise en page HTML avec flex, grid et notes de bas de page, la génération de rapports et l'export sémantique partent dans une seule bibliothèque pour Delphi, C++Builder et Free Pascal. La page produit PDF Library for Delphi liste le reste du moteur de rendu HTML et l'API de dessin