En pocas palabras
Un librito de bolsillo en 3D junto a un panel de controles. Cambia el papel, la encuadernación, la mesa o la luz y el libro cambia en el acto, sin componerse otra vez.
Lo que vas a componer
Six Knots, un libro de bolsillo de diez páginas a 110 × 160 mm, abierto en Folio junto a un panel con todos los ajustes de config.folio. Elige un papel y las hojas cambian de color, superficie y rigidez; pasa de rústica a tapa dura y aparece una caja alrededor del bloque; elige la caja en lugar de las cubiertas impresas, tela o piel, una mesa, una luz, una inclinación. El libro se compone una vez. Cada cambio llega al visor con setAppearance, así que no se mueve ninguna línea ni se vuelve a pintar ninguna página, y bajo el formulario aparecen los ajustes como el código que se pega en config.folio.
Esta receta responde a
- ¿Cómo veo la encuadernación, la cubierta, el papel y la luz de un libro antes de mandarlo a imprenta?
- ¿Cómo muestro mi documento como un libro en 3D cuyas páginas el lector pasa con la mano?
La respuesta corta
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();
Ingredientes
- Funciones
- Papel, encuadernación, mesa y luz (Folio)Visor de libro en 3D (Folio)Estilos de títuloAperturas diseñadasAtributos de títuloEstilos de párrafoCabeceras según el tipo de páginaPaleta de color semánticaMárgenes simétricosPáginas en un canvas
- Tipografía
- Source Serif 4, Outfit (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Nombra los campos como la configuración
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 campo del formulario se llama como su ruta en config.folio (paper.grammage, binding.cover, lighting.environment), de modo que un solo bucle convierte el formulario en el objeto que recibe el visor: números de los deslizadores, booleanos de las casillas y un color { hex, model } del selector. Ese mismo objeto es el config.folio del documento cuando el pen lo compone, así que el Sandbox abre el libro tal como empieza el formulario.
#2 · Cubiertas que el visor pasa como tapas
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
];
Con binding.cover: 'pages' la primera página es la tapa delantera y la última la trasera, si cae en una página par. El estilo de la contracubierta salta a página par, así que el libro acaba siempre en una página par y giran las dos tapas. Cambia el formulario a A case round the pages y esas dos páginas giran como hojas corrientes dentro de una caja de tela.
#3 · Cambia el libro sin rehacerlo
El código es la respuesta corta de arriba. setAppearance({ folio }) sustituye los ajustes del documento y vuelve a dibujar la escena: grosor y rigidez del papel, la caja, los mapas de la mesa y la luz. Las páginas conservan su pintura, así que el cambio aparece en el fotograma siguiente. Cada tipo de papel trae su gramaje, por eso al elegir uno se mueve el deslizador del peso; resetView() devuelve la cámara a su sitio después de que el lector gire el libro arrastrando con el botón derecho.
La receta completa
// ═══ 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),
<section id="bench">
<div id="folio" role="region" aria-label="The book in 3D"></div>
<form id="controls" aria-label="Folio settings">
<fieldset>
<legend>Paper</legend>
<label>Stock <select name="paper.type">
<option value="uncoated">Uncoated</option><option value="bookWove" selected>Book wove</option>
<option value="coatedMatte">Coated matte</option><option value="coatedSilk">Coated silk</option>
<option value="coatedGloss">Coated gloss</option><option value="bible">Bible</option>
<option value="newsprint">Newsprint</option><option value="cardStock">Card</option>
</select></label>
<label>Weight <output name="grammage-out">80 g/m²</output>
<input type="range" name="paper.grammage" min="30" max="300" step="5" value="80"></label>
<label>Texture <select name="paper.texture">
<option value="auto" selected>The stock’s</option><option value="smooth">Smooth</option>
<option value="vellum">Vellum</option><option value="wove">Wove</option>
<option value="laid">Laid</option><option value="linen">Linen</option>
<option value="felt">Felt</option>
</select></label>
<label class="check"><input type="checkbox" name="paper.showThrough" checked> Show-through</label>
</fieldset>
<fieldset>
<legend>Binding</legend>
<label>Type <select name="binding.type">
<option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
<option value="sewn">Sewn softcover</option><option value="layflat">Lay-flat</option>
<option value="saddleStitch">Saddle stitch</option>
</select></label>
<label>Covers <select name="binding.cover">
<option value="pages" selected>The first and last pages</option>
<option value="case">A case round the pages</option>
</select></label>
<label>Material <select name="binding.coverMaterial">
<option value="auto" selected>The binding’s</option><option value="cloth">Cloth</option>
<option value="paper">Paper</option><option value="leather">Leather</option>
</select></label>
<label>Colour <input type="color" name="binding.coverColor" value="#9a3b2e"></label>
</fieldset>
<fieldset>
<legend>Desk and light</legend>
<label>Surface <select name="surface.type">
<option value="oak" selected>Oak</option><option value="walnut">Walnut</option>
<option value="linen">Linen</option><option value="felt">Felt</option>
<option value="leather">Leather</option><option value="marble">Marble</option>
<option value="plain">Plain</option><option value="none">None</option>
</select></label>
<label>Light <select name="lighting.environment">
<option value="studio">Studio</option><option value="daylight" selected>Daylight</option>
/* The bench: the book on the left, the settings on the right, the flat pages below. */
#bench {
display: grid; grid-template-columns: minmax(0, 1fr) 300px; gap: 16px;
max-width: 1320px; margin: 0 auto; padding: 16px; box-sizing: border-box;
color: #c9ccd3; font: 13px/1.4 system-ui, sans-serif;
}
#folio { height: min(80vh, 760px); min-height: 420px; }
#controls { display: grid; gap: 12px; align-content: start; }
#controls fieldset {
display: grid; gap: 8px; margin: 0; padding: 10px 12px 12px;
border: 1px solid #2a2e36; border-radius: 6px;
}
#controls legend {
padding: 0 4px; color: #f0b35a; font-weight: 600; font-size: 11px;
letter-spacing: .12em; text-transform: uppercase;
}
#controls label { display: grid; grid-template-columns: 1fr auto; gap: 4px 8px; align-items: center; }
#controls label > select, #controls label > input[type="range"] { grid-column: 1 / -1; }
#controls label.check { display: flex; gap: 8px; }
#controls select, #controls button {
min-height: 32px; padding: 4px 8px; border: 1px solid #3a3f49; border-radius: 4px;
background: #1a1d23; color: #eceef2; font: inherit;
}
#controls input[type="color"] {
width: 44px; height: 32px; padding: 0; border: 1px solid #3a3f49; border-radius: 4px;
background: none;
}
#controls input[type="range"] { accent-color: #f0b35a; }
#controls output { color: #8d9199; font-variant-numeric: tabular-nums; }
#controls button { cursor: pointer; }
#controls button:hover, #controls button:focus-visible { border-color: #f0b35a; }
#folio-json {
margin: 0; padding: 10px 12px; max-height: 220px; overflow: auto; border-radius: 6px;
background: #15171c; color: #aeb3bd; font: 11.5px/1.45 ui-monospace, Menlo, monospace;
}
@media (max-width: 860px) {
#bench { grid-template-columns: minmax(0, 1fr); }
#folio { height: 70vh; }
}
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
#Empieza en tapa dura con caja de tela
Cambia los valores iniciales del formulario en index.html; el documento y el Sandbox los siguen.
- <option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
+ <option value="hardcover" selected>Hardcover</option><option value="paperback">Paperback</option>#Un libro con su aspecto en la configuración
Un libro sobre la mesa escribe los mismos ajustes una vez en config.folio, sin formulario, y el muestrario pone un papel distinto en cada hoja.
Errores frecuentes
Error frecuente
El visor Folio toma el tamaño de su contenedor
createFolioFromDocument encaja el libro en el elemento que le das, con los botones y el contador de páginas en sus márgenes. Un elemento sin altura (un div vacío en el flujo normal) no muestra nada: dale una altura en CSS. Visor de libro en 3D (Folio) →
Error frecuente
cover: 'pages' necesita un número par de páginas para la tapa trasera
Con binding.cover en 'pages' la primera página gira como tapa delantera, y la última como tapa trasera solo si cae en un verso. Con un número impar de páginas el libro tiene tapa delantera y no trasera: complétalo hasta un número par o deja la caja. Papel, encuadernación, mesa y luz (Folio) →
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Source Serif 4 (SIL OFL 1.1) · Outfit (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)


