Aller au contenu principal
Recette numéro 181

Recettes · Chapitre 10 · Sortie et intégration

Un bon de commande imprimé qui est aussi un PDF à remplir

Une liste de semences dont les cases de quantité sont des champs PDF : totaux de ligne, sous-totaux et montant à payer se calculent dans le lecteur.

  • Exemple en anglais : pas encore d’édition française
  • Format 210 × 270 mm
  • 1 colonne
  • Libre Caslon Text 9,5/13,5
  • Barlow Semi Condensed
  • Libre Caslon Display
  • 4 pages
  • Niveau
  • Postext 1.73.0
  • Mis en page en 171 ms
  • 180 lignes de code

En bref

Un catalogue de semences de quatre pages avec son bon de commande. Imprimé, il a des cases où écrire ; ouvert dans un lecteur PDF, on tape le nombre de sachets et les totaux s'additionnent seuls.

Ce que vous allez composer

Long Furrow Heritage Seeds est la liste de semences du printemps 2027 : quatre pages de 210 × 270 mm d'une maison de semences inventée, qui vend vingt-cinq variétés réelles à pollinisation libre. Une peinture de la récolte occupe la moitié haute de la couverture. La liste de prix est un seul tableau sur les pages 2 et 3, avec une case de quantité et le total de la ligne à chaque rangée, et un sous-total à la fin de chaque groupe. Les coordonnées du client et le paiement sont en page 4. Imprimée, la feuille se remplit au stylo comme n'importe quel bon de commande. Chaque case est aussi une puce munie de l'attribut field : le PDF qu'écrit renderToPdf est donc un AcroForm. On tape le nombre de sachets dans le lecteur PDF et les totaux se calculent, en dollars en anglais et en euros en espagnol.

Cette recette répond à

  • Comment créer un formulaire PDF que le lecteur peut remplir et qui calcule lui-même ses totaux ?

La réponse courte

script.js · lignes 34–44dans le code complet
// The currency and its side; the separators follow the document's language (1,234.50 in
// English, 1.234,50 in Spanish). The canvas and the PDF take the same object.
const FORMS = t({ en: { currency: '$' }, es: { currency: '€', currencyBefore: false } });
// A row of the list: a quantity the reader types, and a total the PDF reader computes as
// quantity × price. The price is a number in the calculation, so it needs no field.
const qty = (code) => `:chip[ ]{style="qty" field="${code}.qty" kind="number" format="integer"}`;
const lineTotal = (code, price) => `:chip[ ]{style="amount" field="${code}.total" `
  + `format="currency" calc="product(${code}.qty, ${price})"}`;
// A subtotal sums its group's line totals (AFSimple_Calculate); a computed field is read-only.
const subtotal = (group, codes) => `:chip[ ]{style="sum" field="sub.${group}" format="currency" `
  + `calc="sum(${codes.map((code) => `${code}.total`).join(', ')})"}`;

Ingrédients

Typographie
Libre Caslon Text, Libre Caslon Display, Barlow Semi Condensed (SIL OFL 1.1)
Ressources
  • seed-table-1440.jpg
  • The still life of heirloom vegetables on the first page, a painting (Generated With Diffusion Models, original)

Préparation

#1 · Un style de puce par sorte de case

script.js · lignes 48–63dans le code complet
const box = { fontFamily: SANS, fontSize: pt(9), color: col('ink'), borderRadius: pt(1.2),
  paddingX: mm(1.4), paddingTop: pt(1.4), paddingBottom: pt(0.6), gap: mm(1), minWidth: mm(16) };
const fill = { ...box, background: col('paper'), borderColor: col('muted'), borderWidth: pt(0.6) };
const computed = { ...box, background: col('tint'), borderWidth: pt(0) };
const line = (id, width) => ({ id, fontFamily: SANS, fontSize: pt(10), color: col('ink'),
  backgroundEnabled: false, underline: 'solid', borderColor: col('muted'), borderWidth: pt(0.5),
  paddingX: mm(0.6), minWidth: mm(width) });
const chipStyles = [
  { id: 'qty', ...fill, minWidth: mm(11) }, // a packet count
  { id: 'entry', ...fill }, // an amount the reader types
  { id: 'amount', ...computed }, // an amount the form computes
  { id: 'sum', ...computed, borderColor: col('accent'), borderWidth: pt(0.6), bold: true },
  { id: 'total', ...computed, background: col('accent'), color: col('paper'), bold: true },
  line('line', 145.5), line('mid', 64), line('short', 59.5), // name, address, town…
  { id: 'tick', ...fill, paddingX: pt(0), minWidth: mm(3.9) }, // a check box: a square
];

Le style donne au champ son aspect et sa largeur minimale, et le PDF pose le widget du champ exactement sur la boîte que peint la puce. Les cases que le lecteur remplit sont blanches avec un filet gris ; celles que le formulaire calcule sont couleur kraft, sans filet, pour qu'on voie lesquelles se remplissent à la main. Les lignes de l'adresse sont des puces qui n'ont qu'un filet en pied, de 145,5 mm pour le nom et de 64 ou 59,5 mm pour les demi-lignes, si bien que leurs extrémités tombent sur les taquets du style de paragraphe field. La case à cocher garde sa largeur minimale de 3,9 mm sans marge intérieure, et le champ devient une case à cocher dans le PDF.

#2 · Le TSV d'un tableur, les cases ajoutées par le script

script.js · lignes 67–102dans le code complet
const style = formNumberStyle(FORMS, t({ en: 'en-us', es: 'es' })), right = { align: 'right' };
const money = (price) => formatFieldNumber(price, 'currency', style); // "$ 3.75", "3,40 €"
// A cell across `span` columns; the cells it covers stay in the grid, marked hiddenBy.
const across = (row, content, extra, span = 6) => [{ content, colSpan: span, ...extra },
  ...Array.from({ length: span - 1 }, () => ({ content: '', hiddenBy: { row, col: 0 } }))];
const table = (id, altText, model) => ({ id, typeId: 'list', kind: 'table', createdAt: 0,
  updatedAt: 0, placement: { position: 'here' }, altText, table: { model } });
// The sheet: a header row, then '= group<TAB>name<TAB>subtotal label' before each group's
// varieties (code, name, note, seeds in a packet, price). The pen adds the boxes.
function priceList(tsv) {
  const [head, ...lines] = tsv.trim().split('\n').map((l) => l.split('\t'));
  const rows = [head.map((content, c) => ({ content, isHeader: true, ...(c > 1 && right) }))];
  let group;
  lines.forEach((cells, i) => {
    if (cells[0].startsWith('=')) {
      // A row of one cell heads its group; a split never leaves it alone at a page foot.
      rows.push(across(rows.length, `**${cells[1]}**`, { background: col('leaf') }));
      group = { id: cells[0].slice(1).trim(), label: cells[2], codes: [] };
      return;
    }
    const [code, variety, note, packet, price] = cells;
    group.codes.push(code);
    rows.push([{ content: code }, { content: `**${variety}** ${note}` },
      { content: packet, ...right }, { content: money(price), ...right },
      { content: qty(code), align: 'center' }, { content: lineTotal(code, price), ...right }]);
    if (lines[i + 1]?.[0].startsWith('=') !== false) { // the group's last variety
      rows.push([...across(rows.length, group.label, right, 5),
        { content: subtotal(group.id, group.codes), ...right }]);
    }
  });
  return table('list', t({ en: 'Price list', es: 'Lista de precios' }),
    { headerRowCount: 1, columnWidths: [0.95, 7.65, 1.4, 1.2, 1.2, 1.6], rows });
}
const summaryTable = (tsv) => table('summary', t({ en: 'Order total', es: 'Total' }), {
  columnWidths: [8, 2], rows: tsv.trim().split('\n')
    .map((l) => l.split('\t').map((content, c) => ({ content, ...(c && right) }))) });

Les variétés arrivent sous forme de feuille : un code, le nom et sa note, le nombre de graines par sachet et le prix. priceList() ajoute à chaque ligne les deux puces de champ, et une ligne de sous-total à la fin de chaque groupe. La cellule du prix imprime formatFieldNumber(price, 'currency', style), la fonction qui met en forme les totaux, de sorte que prix imprimé et total calculé ont les mêmes séparateurs. La ligne qui ouvre chaque groupe est une seule cellule sur les six colonnes, et une coupure du tableau ne la laisse jamais seule en bas de page. Le tableau de la page 3 prend ses cinq lignes dans le Markdown de content.summary.en.md, avec les puces écrites dans les cellules.

#3 · La couverture : la peinture, puis le titre

script.js · lignes 106–122dans le code complet
const at = (to, edge, x, y, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, size });
const cover = { id: 'cover', numbered: false, header: { elements: [] }, footer: { elements: [] },
  advancedDesign: { enabled: true, minHeight: mm(164), slot: { elements: [
    { kind: 'image', id: 'painting', resourceId: 'seed-table', fit: 'cover',
      placement: at('page', 'top-left', 0, 0, { width: mm(210), height: mm(134) }) },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: SANS, fontWeight: 700,
      fontSize: pt(9), letterSpacing: pt(1.8), textTransform: 'uppercase', color: col('accent'),
      align: 'left', placement: at('container', 'top-left', 0, 120) },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(48),
      lineHeight: 0.98, color: col('ink'), align: 'left',
      placement: at('#kicker', 'below', 0, 3, { width: mm(110), height: 'auto' }) },
    { kind: 'text', id: 'standfirst', content: '{attr.standfirst}', fontFamily: SERIF,
      italic: true, fontSize: pt(11), lineHeight: 15 / 11, color: col('ink'), align: 'left',
      placement: at('#title', 'align-top', 116, 2, { width: mm(54), height: 'auto' }) },
  ] } },
};

L'élément image est ancré à la page, en 210 × 134 mm, et sort à fond perdu sur trois côtés. Le surtitre se place à 120 mm du haut du conteneur ; le titre et le chapeau s'accrochent à lui. La hauteur minimale du style, 164 mm, garde l'introduction sur deux colonnes sous le titre, quelle que soit sa longueur.

#4 · Des titres courants qui épargnent la couverture

script.js · lignes 126–136dans le code complet
const head = (id, content, parity, edge, x, extra = {}) => ({ kind: 'text', id, content, parity,
  fontFamily: SANS, fontSize: pt(8), fontWeight: 600, letterSpacing: pt(1.3),
  textTransform: 'uppercase', color: col('muted'), placement: at('page', edge, x, 12), ...extra });
const folio = { fontWeight: 700, color: col('accent') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
  head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
  head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(OUTER + 8)),
  head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
const footer = { elements: [] };

La page paire porte le nom de la maison de semences, la page impaire la section, chacun à côté du folio. Le style de titre de la couverture a un en-tête et un pied vides : la page 1 n'a pas de titre courant.

#5 · Une palette avec une couleur pour les montants calculés

script.js · lignes 16–27dans le code complet
const palette = {
  ink: '#22201c', paper: '#fffdf8', rule: '#cbc2ae', // warm near-black, cream, row hairlines
  accent: '#2f5a3c', // leaf green: table heads, kickers, the total
  tint: '#efe9da', // kraft paper: the boxes the form fills in by itself
  leaf: '#e1e9dc', // pale green: the rows that head each group of the list
  muted: '#6a6355', // running heads, colophon, the outlines of the boxes to fill
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];

Le vert feuille marque ce qui appartient à la maison : la ligne d'en-tête, les surtitres, les filets des sous-totaux et la case pleine du montant à payer. Le kraft est réservé aux cases que le PDF calcule ; sur papier, on les lit comme les cases à laisser vides.

La recette complète

Sandbox
// ═══ Postext Cookbook · Nº 181 · A printed order form that is also a fillable PDF ════
// https://postext.dev/en/cookbook/fillable-order-form
// Code: MIT · Text: original (CC BY 4.0) · Picture: painting made for the recipe
// Fonts: Libre Caslon, Barlow Semi Condensed (SIL OFL 1.1) · Needs postext ≥ 1.73.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
  formatFieldNumber, formNumberStyle,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf?bundle';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'fillable-order-form';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a seed-house green, a kraft tint for the computed amounts
const palette = {
  ink: '#22201c', paper: '#fffdf8', rule: '#cbc2ae', // warm near-black, cream, row hairlines
  accent: '#2f5a3c', // leaf green: table heads, kickers, the total
  tint: '#efe9da', // kraft paper: the boxes the form fills in by itself
  leaf: '#e1e9dc', // pale green: the rows that head each group of the list
  muted: '#6a6355', // running heads, colophon, the outlines of the boxes to fill
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const [SERIF, DISPLAY] = ['Libre Caslon Text', 'Libre Caslon Display'];
const SANS = 'Barlow Semi Condensed';
const [OUTER, LEAD] = [18, 13.5]; // outer margin (mm; the running heads align to it), leading (pt)

// #region answer: field chips: the quantity, the line total it computes, the subtotal
// The currency and its side; the separators follow the document's language (1,234.50 in
// English, 1.234,50 in Spanish). The canvas and the PDF take the same object.
const FORMS = t({ en: { currency: '$' }, es: { currency: '€', currencyBefore: false } });
// A row of the list: a quantity the reader types, and a total the PDF reader computes as
// quantity × price. The price is a number in the calculation, so it needs no field.
const qty = (code) => `:chip[ ]{style="qty" field="${code}.qty" kind="number" format="integer"}`;
const lineTotal = (code, price) => `:chip[ ]{style="amount" field="${code}.total" `
  + `format="currency" calc="product(${code}.qty, ${price})"}`;
// A subtotal sums its group's line totals (AFSimple_Calculate); a computed field is read-only.
const subtotal = (group, codes) => `:chip[ ]{style="sum" field="sub.${group}" format="currency" `
  + `calc="sum(${codes.map((code) => `${code}.total`).join(', ')})"}`;
// #endregion

// #region chips: one chip style per kind of box: to fill, computed, to write on, to tick
const box = { fontFamily: SANS, fontSize: pt(9), color: col('ink'), borderRadius: pt(1.2),

Le script.js composé s’exécute tel quel : collez-le dans le script de module de n’importe quelle page, ou ouvrez la recette sur CodePen. Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)

Variantes

#Demander les frais de port dans un champ

Transformez le port imprimé en champ que le lecteur remplit, et ajoutez-le au total à la place du montant fixe.

-Postage and packing, any size of order	:chip[$ 4.50]{style="amount"}
+Postage and packing, any size of order	:chip[ ]{style="entry" field="order.postage" format="currency"}
-**Total to pay**	:chip[ ]{style="total" field="order.total" format="currency" calc="sum(order.seeds, order.circleFee, 4.50, order.gift)"}
+**Total to pay**	:chip[ ]{style="total" field="order.total" format="currency" calc="sum(order.seeds, order.circleFee, order.postage, order.gift)"}

Erreurs fréquentes

Les pages capturées montrent les cases vides, car les mots d'un champ sont sa valeur par défaut et tous les champs commencent vides ici. Le port est du texte imprimé dans une puce sans field, et le total l'ajoute comme le nombre 4.50 dans son calcul : le lecteur ne peut pas le modifier.

Les totaux sont des scripts (AFSimple_Calculate et de courtes expressions), qu'exécutent Acrobat, Foxit, Chrome et Firefox. Aperçu, sur macOS, affiche les champs et enregistre ce qu'on tape, mais n'exécute aucun script : les totaux y restent vides.

La case du cercle porte on="1", la valeur que lit un calcul quand elle est cochée. Avec la valeur par défaut, Yes, product(order.circle, 12) donnerait toujours 0, et postext-pdf le signale.

La recette importe https://esm.sh/postext-pdf?bundle. La compilation par défaut de pdf-lib sur esm.sh place ses classes d'annotation dans un module à part, et pdf-lib refuse alors le widget de chaque champ : le PDF garde les cases, mais sans format de nombre, sans totaux et sans champs en lecture seule, avec un avertissement formField dans la console. ?bundle compile pdf-lib en un seul module et laisse postext à l'extérieur, partagé avec le reste de la page.

Crédits

Texte
  • The seed list, its notes on each variety and the order form · Ignacio Ferro · CC BY 4.0
Images
  • The still life of heirloom vegetables on the first page, a painting · Generated With Diffusion Models · original
Polices
Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Barlow Semi Condensed (SIL OFL 1.1)
SandboxPDF