Pular para o conteúdo principal
Receita número 103

Receitas · Capítulo 10 · Saída e integração

Uma bancada para os ajustes do visualizador Folio

Um formulário com cada ajuste de config.folio controla um visualizador postext-folio com setAppearance: papel, encadernação, capas, mesa e luz mudam na hora.

Nesta página
  • Amostra em inglês: ainda sem edição em português
  • Refile 110 × 160 mm
  • 1 coluna
  • Source Serif 4 9,3/12,4
  • Outfit
  • 10 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 51 ms
  • 144 linhas de código

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

script.js · linhas 196–220no código completo
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

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

script.js · linhas 72–86no código completo
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

script.js · linhas 40–61no código completo
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

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),

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

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