En poques paraules
Un catàleg de llavors de quatre pàgines amb full de comanda. Imprès, té caselles per escriure; obert en un lector de PDF, hi escrius el nombre de sobres i els totals se sumen sols.
Què compondràs
Long Furrow Heritage Seeds és la llista de llavors de la primavera del 2027, quatre pàgines de 210 × 270 mm d'una casa de llavors inventada que ven vint-i-cinc varietats reals de pol·linització oberta. Una pintura de la collita ocupa la meitat superior de la coberta. La llista de preus és una sola taula repartida entre les pàgines 2 i 3, amb una casella de quantitat i el total de la línia a cada fila i un subtotal al final de cada grup. Les dades del client i el pagament van a la pàgina 4. Impresa, és un full de comanda corrent que s'emplena amb bolígraf. Cada casella és també un xip amb l'atribut field, de manera que el PDF que escriu renderToPdf és un AcroForm: escrius el nombre de sobres al lector de PDF i els totals es calculen sols, en dòlars en anglès i en euros en castellà.
Aquesta recepta respon a
- Com faig un formulari PDF que el lector pugui emplenar i que sumi els totals tot sol?
La resposta curta
// 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(', ')})"}`;
Ingredients
- Funcions
- Camps de formulari emplenables al PDFChips en líniaExportació a PDFFonts incrustades al PDFTaules a partir de dadesEstil de taulesTabuladors i farcimentsEstils de paràgrafEstils de títolAtributs de títolObertures dissenyadesImatges als dissenys de pàginaCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsPaleta de color semàntica
- També fa servir
- Columnes en un requadre o al textCites en un estil de citaFigures just aquíFigura i Taula en la teva llenguaTipus de recurs propisFigures i taules com a recursosCapçaleres per seccióCapítols sense número
- Tipografia
- Libre Caslon Text, Libre Caslon Display, Barlow Semi Condensed (SIL OFL 1.1)
- Recursos
seed-table-1440.jpg- The still life of heirloom vegetables on the first page, a painting (Generated With Diffusion Models, original)
Elaboració
#1 · Un estil de xip per a cada mena de casella
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
];
L'estil dona al camp l'aspecte i l'amplada mínima, i el PDF posa el giny del camp exactament sobre la caixa que pinta el xip. Les caselles que emplena el lector són blanques amb vora grisa; les que calcula el formulari són de color kraft i sense vora, perquè es vegi quines s'escriuen a mà. Les línies de l'adreça són xips amb només un filet inferior, de 145,5 mm per al nom i de 64 o 59,5 mm per a les mitges línies, i així els extrems coincideixen amb els tabuladors de l'estil de paràgraf field. La casella de marcar conserva l'amplada mínima de 3,9 mm sense farciment, i al PDF el camp és una casella de verificació.
#2 · El TSV d'un full de càlcul, amb les caselles afegides pel guió
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 varietats arriben com un full: un codi, el nom amb la nota, les llavors del sobre i el preu. priceList() afegeix a cada fila els dos xips de camp i, al final de cada grup, una fila de subtotal. La cel·la del preu imprimeix formatFieldNumber(price, 'currency', style), la mateixa funció que dona format als totals, de manera que el preu imprès i el total calculat fan servir els mateixos separadors. La fila que obre cada grup és una sola cel·la que travessa les sis columnes, i quan la taula es parteix mai no queda sola al peu d'una pàgina. La taula de la pàgina 3 pren les cinc files del Markdown de content.summary.en.md, amb els xips escrits a les cel·les.
#3 · La coberta: primer la pintura, després el títol
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'element d'imatge s'ancora a la pàgina, a 210 × 134 mm, i sang per tres costats. L'avanttítol queda a 120 mm de l'inici del contenidor, i el títol i l'entradeta en pengen. L'alçada mínima de l'estil, 164 mm, deixa la introducció a dues columnes per sota del títol, sigui quina sigui la seva llargada.
#4 · Capçaleres que no toquen la coberta
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 pàgina parella porta el nom de la casa de llavors i la senar la secció, cadascun al costat del foli. L'estil de títol de la coberta té la capçalera i el peu buits, així que la pàgina 1 no porta capçalera.
#5 · Una paleta amb un color per als imports calculats
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' } },
];
El verd fulla marca el que és de la casa: la fila de capçalera, els avanttítols, les vores dels subtotals i la casella massissa del total a pagar. El kraft es reserva per a les caselles que calcula el PDF, de manera que en paper es llegeixen com les caselles que deixes en blanc.
La recepta completa
// ═══ 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 = 'es'; // @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),
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Demana les despeses d'enviament com a camp
Converteix l'enviament imprès en un camp que escriu el lector i suma'l al total en lloc de l'import fix.
-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)"}Errors freqüents
Les pàgines capturades mostren les caselles buides, perquè les paraules d'un camp en són el valor inicial i aquí tots comencen en blanc. L'enviament és text imprès en un xip sense field, i el total el suma com el nombre 4.50 dins el càlcul, així que el lector no el pot canviar.
Els totals són scripts (AFSimple_Calculate i expressions breus) que executen Acrobat, Foxit, Chrome i Firefox. La Previsualització del macOS mostra els camps i desa el que hi escrius, però no executa scripts, així que allà els totals queden buits.
La casella del cercle porta on="1", el valor que llegeix un càlcul quan està marcada. Amb el valor per defecte, Yes, product(order.circle, 12) donaria sempre 0, i postext-pdf n'avisa.
La recepta importa https://esm.sh/postext-pdf?bundle. La compilació per defecte de pdf-lib a esm.sh deixa les classes d'anotació en un mòdul a part, i llavors pdf-lib rebutja el widget de cada camp: el PDF conserva les caselles, però sense format de nombre, sense totals i sense camps de només lectura, amb un avís formField a la consola. ?bundle compila pdf-lib en un sol mòdul i deixa postext fora, compartit amb la resta de la pàgina.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The seed list, its notes on each variety and the order form · Ignacio Ferro · CC BY 4.0
- Imatges
- The still life of heirloom vegetables on the first page, a painting · Generated With Diffusion Models · original
- Fonts
- Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Barlow Semi Condensed (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


