Em poucas palavras
Um pequeno livro de bolso mostrado em 3D ao lado de um painel de controles. Troque o papel, a encadernação, a mesa ou a luz e o livro muda na hora, sem ser composto de novo.
O que você vai compor
Six Knots, um livro de bolso de dez páginas em formato 110 × 160 mm, aberto no Folio ao lado de um painel com todos os ajustes de config.folio. Escolha um papel e as folhas mudam de cor, de superfície e de rigidez; troque a encadernação de brochura para capa dura e uma capa cresce em volta do miolo; escolha a capa dura no lugar das capas impressas, um revestimento de tecido ou couro, uma mesa, uma luz, uma inclinação. O livro é diagramado uma vez. Cada mudança chega ao visualizador com setAppearance, de modo que nenhuma linha se move e nenhuma página é pintada de novo, e os ajustes aparecem embaixo do formulário como o código para colar em config.folio.
Esta receita responde a
- Como visualizo a encadernação, a capa, o papel e a iluminação de um livro antes de mandá-lo para a gráfica?
- Como mostro meu documento como um livro em 3D cujas páginas o leitor vira com a mão?
A resposta curta
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
- Funcionalidades
- Papel, encadernação, mesa e luz (Folio)Visualizador de livro em 3D (Folio)Estilos de títuloAberturas desenhadasAtributos de títuloEstilos de parágrafoCabeços por tipo de páginaPaleta de cores semânticaMargens espelhadasPáginas em um canvas
- Tipografia
- Source Serif 4, Outfit (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Dê aos campos os nomes da configuração
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 do formulário tem como nome o caminho em config.folio (paper.grammage, binding.cover, lighting.environment), por isso um único laço transforma o formulário no objeto que o visualizador recebe: números dos controles deslizantes, booleanos das caixas de seleção, uma cor { hex, model } do seletor. O mesmo objeto é o config.folio do próprio documento quando o pen o compõe, por isso o Sandbox abre o livro como o formulário começa.
#2 · Capas que o visualizador vira como pranchas
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
];
Com binding.cover: 'pages' a primeira página é a capa da frente e a última a de trás, quando cai numa página par. O estilo de título da quarta capa salta para uma página par, de modo que o livro sempre termina numa página par e as duas capas viram. Mude o formulário para A case round the pages e as mesmas duas páginas viram como folhas comuns dentro de uma capa dura de tecido.
#3 · Mude o livro sem refazê-lo
O código está na resposta curta, mais acima. setAppearance({ folio }) substitui os ajustes do documento e redesenha a cena: espessura e rigidez do papel, a capa dura, os mapas da mesa e a luz. As páginas mantêm a pintura, de modo que uma mudança aparece no quadro seguinte. Cada tipo de papel traz a própria gramatura, por isso escolher um move o controle do peso; resetView() devolve a câmera ao lugar depois que o leitor gira o livro arrastando com o botão direito.
A receita 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; }
}
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Comece de uma capa dura revestida de tecido
Mude os valores iniciais do formulário em index.html; o documento e o Sandbox seguem esses valores.
- <option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
+ <option value="hardcover" selected>Hardcover</option><option value="paperback">Paperback</option>#Um livro com a aparência na configuração
Um livro sobre a mesa escreve os mesmos ajustes uma vez em config.folio, sem formulário, e o mostruário põe um papel diferente em cada folha.
Erros comuns
Erro comum
O visualizador Folio assume o tamanho do seu contêiner
createFolioFromDocument encaixa o livro no elemento que você passa, com os botões e o contador de páginas nas margens. Um elemento sem altura (um div vazio no fluxo normal) não mostra nada: defina uma altura para ele em CSS. Visualizador de livro em 3D (Folio) →
Erro comum
cover: 'pages' precisa de um número par de páginas para a capa traseira
Com binding.cover em 'pages', a primeira página vira como capa da frente, e a última vira como capa traseira só quando cai em uma página par. Com um número ímpar de páginas, o livro fica com capa da frente e sem capa traseira: complete até um número par ou mantenha a capa dura. Papel, encadernação, mesa e luz (Folio) →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Source Serif 4 (SIL OFL 1.1) · Outfit (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


