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
// 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
- Fonctionnalités
- Champs de formulaire remplissables dans le PDFPastilles dans le texteExport PDFPolices intégrées au PDFTableaux à partir de donnéesStyle de tableauTaquets de tabulation et points de conduiteStyles de paragrapheStyles de titreAttributs de titreOuvertures composéesImages dans les maquettes de pageTitres courants et foliosTitres courants selon le rôle de la pageMarges en miroirPalette de couleurs sémantique
- Utilise aussi
- Colonnes dans un encadré ou dans le texteCitations dans un style bibliographiqueDes figures exactement iciFigure et Tableau dans votre langueTypes de ressource personnalisésFigures et tableaux comme ressourcesTitres courants par sectionChapitres non numérotés
- 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
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
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
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
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
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
// ═══ 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
- Recette
- Ignacio Ferro
- 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)
Modifier ce texte ↗ (s’ouvre dans un nouvel onglet)Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)


