Saltar al contingut principal
Recepta número 103

Receptari · Capítol 10 · Sortida i integració

Un banc de proves per a la configuració de Folio

Un formulari amb cada paràmetre de config.folio governa un visor postext-folio amb setAppearance: paper, enquadernació, cobertes, taula i llum canvien al vol.

En aquesta pàgina
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.26.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en anglès: encara no hi ha edició en català
  • Format 110 × 160 mm
  • 1 columna
  • Source Serif 4 9,3/12,4
  • Outfit
  • 10 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 51 ms
  • 144 línies de codi

En poques paraules

Un llibret de butxaca en 3D al costat d'un tauler de controls. Canvia el paper, l'enquadernació, la taula o la llum i el llibre canvia a l'instant, sense tornar-se a compondre.

Què compondràs

Six Knots, un llibre de butxaca de deu pàgines a 110 × 160 mm, obert a Folio al costat d'un tauler amb tots els paràmetres de config.folio. Tria un paper i els fulls canvien de color, de superfície i de rigidesa; passa de rústica a tapa dura i apareix una caixa al voltant del bloc; tria la caixa en lloc de les cobertes impreses, tela o pell, una taula, una llum, una inclinació. El llibre es compon una vegada. Cada canvi arriba al visor amb setAppearance, així que no es mou cap línia ni es torna a pintar cap pàgina, i sota el formulari apareixen els paràmetres com el codi que s'enganxa a config.folio.

Aquesta recepta respon a

  • Com veig l'enquadernació, la coberta, el paper i la llum d'un llibre abans d'enviar-lo a impremta?
  • Com mostro el meu document com un llibre en 3D les pàgines del qual el lector passa amb la mà?

La resposta curta

script.js · línies 196–220al codi complet
const book = createFolioFromDocument(document.getElementById('folio'), doc, {
  // The look starts from doc.config.folio; setAppearance replaces it on every change.
  appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' },
  onChange: ({ pages }) => kitStatus(`${doc.pages.length} pages · open at `
    + pages.map((i) => i + 1).join('–')),
});
function update() {
  const folio = folioOf();
  // Only the appearance changes: the pages keep their paintings, nothing is laid out again.
  book.setAppearance({ folio });
  show('grammage-out', `${folio.paper.grammage} g/m²`);
  show('intensity-out', folio.lighting.intensity.toFixed(2));
  show('tilt-out', `${folio.tilt}°`);
  document.getElementById('folio-json').textContent = `folio: ${JSON.stringify(folio, null, 2)}`;
}
form.addEventListener('input', update);
// A stock sets its own weight: picking one moves the weight slider to the stock's.
const WEIGHTS = { uncoated: 90, bookWove: 80, coatedMatte: 115, coatedSilk: 115,
  coatedGloss: 115, bible: 40, newsprint: 48, cardStock: 250 };
form.elements['paper.type'].addEventListener('change', (event) => {
  form.elements['paper.grammage'].value = WEIGHTS[event.target.value];
  update();
});
document.getElementById('reset-view').addEventListener('click', () => book.resetView());
update();

Ingredients

Tipografia
Source Serif 4, Outfit (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Anomena els camps com la configuració

script.js · línies 72–86al codi complet
const form = document.getElementById('controls');
const hex = (value) => ({ hex: value, model: 'hex' });
function folioOf() { // 'paper.grammage' → { paper: { grammage } }, typed by the input
  const folio = {};
  for (const el of form.elements) {
    if (!el.name || el.type === 'button' || el.tagName === 'OUTPUT') continue;
    const value = el.type === 'checkbox' ? el.checked : el.type === 'range' ? Number(el.value)
      : el.type === 'color' ? hex(el.value) : el.value;
    const [group, key] = el.name.split('.');
    if (key) (folio[group] ??= {})[key] = value;
    else folio[group] = value;
  }
  return folio;
}
const show = (name, value) => { form.elements[name].value = value; };

Cada camp del formulari es diu com la seva ruta a config.folio (paper.grammage, binding.cover, lighting.environment), de manera que un sol bucle converteix el formulari en l'objecte que rep el visor: nombres dels lliscadors, booleans de les caselles i un color { hex, model } del selector. Aquest mateix objecte és el config.folio del document quan el pen el compon, així que el Sandbox obre el llibre tal com comença el formulari.

#2 · Cobertes que el visor passa com a tapes

script.js · línies 40–61al codi complet
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
  placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
  margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
  enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
  cover('cover', [
    text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),
      lineHeight: 0.92, color: col('cream') },
    { ...at('page', 'top-left', INNER, 30), size: { width: mm(80) } }),
    text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
      fontSize: pt(11), lineHeight: 1.3, color: col('cream') },
    { ...at('#title', 'below', 0, 6), size: { width: mm(72) } }),
    text('author', '{author}', caps(7, col('cream')), at('page', 'bottom-left', INNER, -16)),
  ]),
  cover('back', [
    text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
      fontSize: pt(11), lineHeight: 1.3, color: col('cream'), align: 'center' },
    { ...at('page', 'center', 0, 0), size: { width: mm(76) } }),
  ], { breakBefore: { enabled: true, parity: 'even' } }), // the back: always a verso
];

Amb binding.cover: 'pages' la primera pàgina és la tapa davantera i l'última la del darrere, si cau en un verso. L'estil de la contracoberta salta a pàgina parella, així que el llibre acaba sempre en un verso i giren les dues tapes. Canvia el formulari a A case round the pages i aquestes dues pàgines giren com a fulls corrents dins d'una caixa de tela.

#3 · Canvia el llibre sense refer-lo

El codi és la resposta curta de més amunt. setAppearance({ folio }) substitueix la configuració del document i torna a dibuixar l'escena: gruix i rigidesa del paper, la caixa, els mapes de la taula i la llum. Les pàgines conserven la seva pintura, així que el canvi apareix al fotograma següent. Cada tipus de paper porta el seu gramatge, per això en triar-ne un es mou el lliscador del pes; resetView() torna la càmera al seu lloc després que el lector hagi girat el llibre arrossegant amb el botó dret.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 103 · A bench for the Folio viewer's settings ═══════════════
// https://postext.dev/en/cookbook/folio-settings-bench
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Source Serif 4, Outfit (SIL OFL 1.1) · Needs postext ≥ 1.26.0
//
// A pocket book of knots, laid out once and opened in postext-folio next to a form of every
// folio setting: paper, binding, covers, desk, light and tilt. Each change goes to the viewer
// with setAppearance, so the book is redrawn in place and no page is laid out or painted
// again. The settings as code sit under the form, ready to paste into config.folio.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { createFolioFromDocument } from 'https://esm.sh/postext-folio';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'folio-settings-bench';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: brick red for the covers and the knot numbers, a warm ink for the text
const palette = {
  ink: '#24211f',
  brick: '#9a3b2e', // the cover field, kickers and folios
  cream: '#f6efe2', // type on the covers
  muted: '#6f6860',
};
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.brick, model: 'hex' } },
];
// #endregion
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [110, 160, 15, 17, 14, 12]; // mm: a pocket
const LEAD = 12.4; // pt
const SANS = 'Outfit';
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
  align: 'left', placement, ...look });
const caps = (size, color) => ({ fontFamily: SANS, fontSize: pt(size), fontWeight: 600,
  letterSpacing: pt(size * 0.16), textTransform: 'uppercase', color });

// #region covers: a full-page colour field on page 1 and on the last page
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
  placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
  margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
  enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
  cover('cover', [
    text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),

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

#Comença en tapa dura amb caixa de tela

Canvia els valors inicials del formulari a index.html; el document i el Sandbox els segueixen.

-        <option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
+        <option value="hardcover" selected>Hardcover</option><option value="paperback">Paperback</option>

#Un llibre amb el seu aspecte a la configuració

Un llibre sobre la taula escriu els mateixos paràmetres una vegada a config.folio, sense formulari, i el mostrari posa un paper diferent a cada full.

Errors freqüents

Error freqüent

El visor Folio pren la mida del seu contenidor

createFolioFromDocument encaixa el llibre a l'element que li dones, amb els botons i el comptador de pàgines als marges. Un element sense alçada (un div buit en el flux normal) no mostra res: dona-li una alçada en CSS. Visor de llibre en 3D (Folio) →

Error freqüent

cover: 'pages' necessita un nombre parell de pàgines per a la tapa posterior

Amb binding.cover a 'pages' la primera pàgina gira com a tapa anterior, i l'última com a tapa posterior només si cau en un verso. Amb un nombre senar de pàgines el llibre té tapa anterior i no posterior: completa'l fins a un nombre parell o deixa la caixa. Paper, enquadernació, taula i llum (Folio) →

Crèdits

Text
Text original, CC BY 4.0
Fonts
Source Serif 4 (SIL OFL 1.1) · Outfit (SIL OFL 1.1)
Sandbox