En pocas palabras
Un catálogo de semillas de cuatro páginas con hoja de pedido. Impreso, tiene casillas para escribir; abierto en un lector de PDF, escribes el número de sobres y los totales se suman solos.
Lo que vas a componer
Semillas El Surco Largo es la lista de semillas de la primavera de 2027, cuatro páginas de 210 × 270 mm de una casa de semillas inventada que vende veinticinco variedades reales de polinización abierta. Una pintura de la cosecha ocupa la mitad superior de la portada. La lista de precios es una sola tabla repartida entre las páginas 2 y 3, con una casilla de cantidad y el total de la línea en cada fila y un subtotal al final de cada grupo. Los datos del cliente y el pago van en la página 4. Impresa, es una hoja de pedido corriente que se rellena a bolígrafo. Cada casilla es además un chip con el atributo field, así que el PDF que escribe renderToPdf es un AcroForm: escribes el número de sobres en el lector de PDF y los totales se calculan solos, en euros en español y en dólares en inglés.
Esta receta responde a
- ¿Cómo hago un formulario PDF que el lector pueda rellenar y que sume los totales solo?
La respuesta corta
// 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(', ')})"}`;
Ingredientes
- Funciones
- Campos de formulario rellenables en el PDFChips en líneaExportación a PDFFuentes incrustadas en el PDFTablas a partir de datosEstilo de tablasTabuladores y rellenosEstilos de párrafoEstilos de títuloAtributos de títuloAperturas diseñadasImágenes en los diseños de páginaCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosPaleta de color semántica
- También usa
- Columnas en un recuadro o en el textoCitas en un estilo de citaFiguras justo aquíFigura y Tabla en tu idiomaTipos de recurso propiosFiguras y tablas como recursosCabeceras por secciónCapítulos sin número
- Tipografía
- Libre Caslon Text, Libre Caslon Display, Barlow Semi Condensed (SIL OFL 1.1)
- Recursos
seed-table-1440.jpg- El bodegón de hortalizas tradicionales de la primera página, una pintura (Generated With Diffusion Models, original)
Elaboración
#1 · Un estilo de chip por cada clase de casilla
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
];
El estilo da al campo su aspecto y su anchura mínima, y el PDF coloca el widget del campo justo sobre la caja que pinta el chip. Las casillas que rellena el lector son blancas con borde gris; las que calcula el formulario son de color kraft y sin borde, para que se vea cuáles se escriben a mano. Las líneas de la dirección son chips con solo un filete inferior, de 145,5 mm para el nombre y de 64 o 59,5 mm para las medias líneas, y así sus extremos coinciden con los tabuladores del estilo de párrafo field. La casilla de marcar conserva su anchura mínima de 3,9 mm sin relleno, y en el PDF el campo es una casilla de verificación.
#2 · El TSV de una hoja de cálculo; las casillas, de la mano del 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) }))) });
Las variedades llegan como una hoja: una referencia, el nombre con su nota, las semillas del sobre y el precio. priceList() añade a cada fila los dos chips de campo y, al final de cada grupo, una fila de subtotal. La celda del precio imprime formatFieldNumber(price, 'currency', style), la misma función que da formato a los totales, de modo que el precio impreso y el total calculado usan los mismos separadores: coma decimal y el euro detrás. La fila que abre cada grupo es una sola celda que cruza las seis columnas, y al partir la tabla nunca queda sola al pie de una página. La tabla de la página 3 toma sus cinco filas del Markdown de content.summary.es.md, con los chips escritos en las celdas.
#3 · La portada: primero la pintura, luego el título
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' }) },
] } },
};
El elemento de imagen se ancla a la página, a 210 × 134 mm, y sangra por tres lados. El antetítulo queda a 120 mm del arranque del contenedor, y el título y la entradilla cuelgan de él. La altura mínima del estilo, 164 mm, deja la introducción a dos columnas por debajo del título, sea cual sea su longitud.
#4 · Cabeceras que no tocan la portada
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 par lleva el nombre de la casa de semillas y la impar la sección, cada uno junto a su folio. El estilo de título de la portada tiene la cabecera y el pie vacíos, así que la página 1 no lleva cabecera.
#5 · Una paleta con un color para los importes calculados
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 verde hoja marca lo que es de la casa: la fila de cabecera, los antetítulos, los bordes de los subtotales y la casilla maciza del total a pagar. El kraft se reserva para las casillas que calcula el PDF, de modo que en papel se leen como las casillas que dejas en blanco.
La receta 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),
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Pide los gastos de envío como campo
Convierte el envío impreso en un campo que escribe el lector y súmalo al total en lugar del importe fijo.
-Envío y embalaje, sea cual sea el pedido :chip[3,90 €]{style="amount"}
+Envío y embalaje, sea cual sea el pedido :chip[ ]{style="entry" field="order.postage" format="currency"}
-**Total a pagar** :chip[ ]{style="total" field="order.total" format="currency" calc="sum(order.seeds, order.circleFee, 3.90, order.gift)"}
+**Total a pagar** :chip[ ]{style="total" field="order.total" format="currency" calc="sum(order.seeds, order.circleFee, order.postage, order.gift)"}Errores frecuentes
Las páginas capturadas muestran las casillas vacías, porque las palabras de un campo son su valor inicial y aquí todos empiezan en blanco. El envío es texto impreso en un chip sin field, y el total lo suma como el número 3.90 dentro del cálculo (con punto decimal, como cualquier número de un calc), así que el lector no puede cambiarlo.
Los totales son scripts (AFSimple_Calculate y expresiones breves) que ejecutan Acrobat, Foxit, Chrome y Firefox. Vista Previa de macOS muestra los campos y guarda lo que escribes, pero no ejecuta scripts, así que allí los totales se quedan vacíos.
La casilla del círculo lleva on="1", el valor que lee un cálculo cuando está marcada. Con el valor por defecto, Yes, product(order.circle, 10) daría siempre 0, y postext-pdf avisa de ello.
La receta importa https://esm.sh/postext-pdf?bundle. La compilación por defecto de pdf-lib en esm.sh deja sus clases de anotación en un módulo aparte, y entonces pdf-lib rechaza el widget de cada campo: el PDF conserva las casillas, pero sin formato de número, sin totales y sin campos de solo lectura, con un aviso formField en la consola. ?bundle compila pdf-lib en un solo módulo y deja postext fuera, compartido con el resto de la página.
Créditos
- Receta
- Ignacio Ferro
- Texto
- La lista de semillas, las notas de cada variedad y la hoja de pedido · Ignacio Ferro · CC BY 4.0
- Imágenes
- El bodegón de hortalizas tradicionales de la primera página, una pintura · Generated With Diffusion Models · original
- Fuentes
- Libre Caslon Text (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · Barlow Semi Condensed (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


