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

Receitas · Capítulo 6 · Boxes e notas

Boxes que se dividem, flutuam e ficam fixos

Uma ficha de laboratório em que o boxe do procedimento se divide em duas colunas, a folha de dados vai para o alto da página seguinte e um selo fica fixo no pé.

p. 42–43 · 2–3 de 4

  • Amostra em espanhol: ainda sem edição em português
  • Refile 195 × 255 mm
  • 2 colunas, medianiz de 7 mm
  • Host Grotesk 9,4/13,6
  • Commit Mono
  • 4 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 101 ms
  • 222 linhas de código

Em poucas palavras

Uma ficha escolar de ciências para construir um relógio de sol. Mostra boxes que se dividem entre duas colunas, passam para o alto da página seguinte ou ficam fixos no pé de uma página.

O que você vai compor

Quatro páginas de Taller de ciencias, um caderno escolar espanhol de atividades de laboratório: a Práctica 4, “Construye un reloj de sol” (Construa um relógio de sol). Na página 42, o aviso de segurança fica inteiro, e o procedimento de catorze passos, sobre fundo amarelo e com um selo de compasso no canto, começa no pé da coluna da esquerda e continua no alto da direita, na mesma medida e sem o título. A folha de dados de Madri sai do fluxo nessa página e encabeça a página 43, acima do texto. Um selo grafite, “Autoevaluación · 10 min”, fica fixo no pé da última página, com uma mão apontando na margem ao lado dele. Na abertura, uma faixa amarelo-sol traz um gráfico das sombras de uma vareta do meio-dia às cinco da tarde na latitude de Madri, e um painel lista os materiais em três colunas na largura da página.

Esta receita responde a

  • Como deixo um boxe longo se dividir entre colunas e páginas, ou mantenho um boxe curto inteiro?
  • Como levo um boxe para o alto ou o pé da página enquanto o texto continua correndo?
  • Como fixo um selo ou um adesivo em uma posição exata da página?
  • Como coloco um boxe atravessando as duas colunas no meio da página, como um painel “em números” com três blocos?

A resposta curta

script.js · linhas 54–84no código completo
const HAND = 6, GAP = 2, RULE = 0.75 * PT; // mm: the badge's hand, its gap, the hand's rule
const calloutStyles = [
  // Kept whole: keepTogether defaults to true, so a box that does not fit the rest of a
  // column moves on in one piece; only a box taller than a whole column splits anyway.
  box('seguridad', bar('charcoal', 'aviso')),
  // Split: the procedure fits a column, so it takes keepTogether: false to break where it
  // falls instead of moving on whole: between steps, or inside one (splitMinLines, default
  // 2, keeps at least two lines of the step on each side of the cut). The rest goes on in
  // the next column or page without the title or the icon; a corner icon takes no room
  // from the text, where an inline one would keep its column in both parts.
  box('pasos', { keepTogether: false, background: col('light'),
    icon: icon('compas', 7, { position: 'corner', cornerSide: 'outer' }) }),
  // Floated: its fence adds placement="top", so the box leaves the flow where the fence
  // stands and heads the next page, while the text after it fills this one.
  box('datos', { span: 'page', background: col('tint') }),
  // Pinned: 'fixed' sets the box on the page where its fence falls, at the bottom-left corner
  // of the text block unless fixed.anchor says otherwise, and the column text keeps out of it.
  // width: 'auto' shrink-wraps the title, so an empty fence prints a badge.
  box('autoevaluacion', { placement: 'fixed', width: 'auto',
    // Hang the hand and its rule in the margin (the outer one on this verso), so the badge
    // itself lines up with the text: [hand][rule][GAP][badge].
    fixed: { offset: { x: mm(-(HAND + RULE + GAP)) } },
    marker: { ...icon('mano', HAND), gap: mm(GAP),
      rule: { enabled: true, color: col('charcoal'), width: mm(RULE) } },
    background: col('charcoal'), borderRadius: mm(3.2),
    padding: { top: mm(1.6), right: mm(3.4), bottom: mm(1.6), left: mm(3.4) },
    titleStyle: { ...TITLE, color: col('paper') } }),
  // Across the page, in the flow: the text above it is cut level and resumes under it.
  box('resumen', { span: 'page', backgroundEnabled: false,
    stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('charcoal') } }),
];

Ingredientes

Tipografia
Host Grotesk, Commit Mono (SIL OFL 1.1)
Materiais
  • The shadow chart, the dial in profile and the icons, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)

Preparo

#1 · Um estilo de base para todos os boxes

script.js · linhas 38–50no código completo
const TITLE = { fontFamily: LABEL, fontSize: pt(8), color: col('charcoal'),
  textTransform: 'uppercase', letterSpacing: pt(1.2) }; // bold by default
const BOX_TYPE = { fontSize: pt(8.8), lineHeight: pt(12.4) }; // colours inherit bodyText
const box = (id, device) => ({ id, // margins: the defaults, snapped to whole grid lines
  padding: { top: mm(3), right: mm(3.6), bottom: mm(3.4), left: mm(3.6) },
  titleStyle: { ...TITLE, gap: mm(2) }, body: BOX_TYPE,
  lists: { gap: mm(2), itemSpacing: pt(3) }, ...device });
const icon = (id, size, extra) => ({ kind: 'resource', resourceId: id, size: mm(size),
  ...extra });
// A side bar with its icon centred on it, 1.4 mm narrower than the bar.
const bar = (hue, id, width = 5.6) => ({ backgroundEnabled: false,
  stripe: { enabled: true, side: 'left', width: mm(width), color: col(hue) },
  icon: icon(id, width - 1.4) });

Todo estilo parte de box(): o título em monoespaçada, letra de 8,8 pt contra os 9,4 pt do texto, e o preenchimento interno. Cada um acrescenta então um único recurso: uma barra grafite no aviso de segurança, um fundo amarelo no procedimento, um tom de papel na folha de dados, um fio superior no resumo, uma pílula grafite no selo. O aluno distingue os boxes por esse recurso antes de ler qualquer título. No procedimento, o fundo também marca a continuação: a parte no alto da coluna da direita não tem título, e só o amarelo a liga aos passos 1 a 4 no pé da coluna da esquerda.

#2 · Inteiro, dividido, flutuante e fixo

O código está na resposta curta, mais acima. O procedimento mede 192 mm e numa coluna cabem 211, por isso um boxe mantido inteiro pularia para o alto da coluna da direita e deixaria 43 mm vazios no pé da esquerda. keepTogether: false deixa o boxe começar onde ele cai e continuar na coluna seguinte, ou na página seguinte, como mostra a segunda variação (o contêiner :::callout). A continuação perde o título e o ícone. Um ícone na linha tiraria dos passos uma coluna própria nas duas partes; por isso o compasso fica no canto externo do boxe, onde não ocupa largura. A linha de abertura da folha de dados tem placement="top", de modo que o boxe sai do fluxo na página 42 e encabeça a página seguinte. O selo é fixed, e um offset.x negativo leva a mão e o fio dela para a margem externa, para que a borda esquerda do selo fique alinhada com o texto.

#3 · Atravessar a página com um painel de três colunas

script.js · linhas 88–93no código completo
const materials = box('material', { span: 'page', background: col('sun'),
  marginBottom: pt(LEAD), // one more grid line of air before the text resumes
  padding: { top: mm(3.6), right: mm(4.4), bottom: mm(3.8), left: mm(4.4) },
  columnGap: mm(GUTTER), // the page's gutter: the panel's columns sit as far apart as the text's
  body: { ...BOX_TYPE, paragraphSpacing: false },
  lists: { color: col('ink'), gap: mm(1.8), itemSpacing: pt(1) } });

Com span: 'page', o boxe de materiais atravessa as duas colunas. A introdução acima dele é cortada na mesma altura, e o texto continua em duas colunas embaixo dele (página 41). Dentro do contêiner, :::columns{count=3 breaks="5,9"} define onde começa cada coluna em vez de balanceá-las. breaks conta blocos filhos, e cada item de lista é um bloco, por isso a segunda e a terceira colunas abrem no quinto e no nono blocos, os rótulos em negrito. columnGap é a medianiz de 7 mm da página, e as colunas do painel ficam tão afastadas quanto as colunas de texto.

:::callout{type="material" title="Necesitarás"}
:::columns{count=3 breaks="5,9"}
**Para la esfera**
 
- Cartón pluma de 20 × 30 cm
- La plantilla de la esfera
- Pegamento y rotulador
 
**Para el gnomon y la base**
…
:::
:::

#4 · Um amarelo para os fundos, outro mais claro para o boxe longo

script.js · linhas 15–28no código completo
const palette = {
  ink: '#1b2430', // text
  charcoal: '#2b2d42', // the safety bar, the summary's rule, the table head, the badge, titles
  sun: '#f2b705', // the opener band and the materials panel: fields, never type
  light: '#fad65a', // the procedure
  tint: '#fff6d6', // the data sheet
  rule: '#d7dde3', // hairlines
  muted: '#5d6b78', // running heads, notes
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at charcoal, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.charcoal })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

O amarelo-sol fica reservado para as áreas de cor, a faixa e o painel, onde o grafite e a tinta preta têm contraste de 7,4:1 e 8,6:1. Como cor de letra sobre branco ele chegaria a 1,8:1, por isso nunca leva texto. O procedimento usa light, um amarelo mais pálido: a tinta preta tem contraste de 11:1 sobre ele, e a divisão ainda aparece na miniatura da galeria. A folha de dados usa tint, mais próximo do papel, para não ser confundida com o procedimento, o outro boxe com fundo da página dupla. main-color aponta para o grafite, e assim os valores padrão que a configuração não sobrescreve saem em grafite e não no azul do motor.

#5 · Abrir com uma faixa amarela

script.js · linhas 97–119no código completo
const BAND = 100; // mm from the trim to the foot of the band
const ART_W = 80; // mm: the width of the band's drawing, at the fore-edge
const AIR = 8; // mm between the band and the first line of text
const [TITLE_W, LEAD_W] = [104, 88]; // mm: the title's and the lead's measure
const onBand = { color: col('charcoal'), align: 'left' }; // a long title or lead wraps
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' },
  offset: { y: mm(y) }, size: { width: mm(width) } });
const opener = { enabled: true, minHeight: mm(BAND - TOP + AIR), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('sun') },
    placement: { anchor: { to: 'page', edge: 'top-left' }, size: { height: mm(BAND) } } },
  { kind: 'image', id: 'art', resourceId: 'sombras', placement: { anchor: { to: 'page',
    edge: 'top-right' }, size: { width: mm(ART_W), height: mm(BAND) } } },
  { kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: LABEL,
    fontSize: pt(8.5), fontWeight: 700, letterSpacing: pt(1.7), textTransform: 'uppercase',
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(4) } } },
  { kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: TEXT,
    fontSize: pt(44), fontWeight: 800, lineHeight: 0.98, placement: below('kicker', 3, TITLE_W) },
  { kind: 'text', id: 'lead', content: '{attr.lead}', ...onBand, fontFamily: TEXT,
    fontSize: pt(10.5), lineHeight: 1.4, placement: below('title', 5, LEAD_W) },
  { kind: 'text', id: 'meta', content: '{attr.meta}', ...onBand, fontFamily: LABEL,
    fontSize: pt(7.4), fontWeight: 700, letterSpacing: pt(1.1), textTransform: 'uppercase',
    placement: below('lead', 4, LEAD_W) },
] } };

A faixa é um elemento de caixa ancorado na página, e o desenho, um elemento de imagem junto ao corte; o chapéu, o olho e a linha de sessões vêm de atributos na linha do título. Como a faixa está ancorada na página, a abertura já reserva a altura até o pé da faixa, e o texto começaria 3,6 mm abaixo dela. minHeight: BAND - TOP + AIR pede 8 mm; a reserva se ajusta à linha seguinte da grade, e o texto começa 8,4 mm abaixo da faixa.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 021 · Boxes that split, float and pin ══════════════════
// https://postext.dev/en/cookbook/boxes-split-float-pin
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Host Grotesk, Commit Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Four pages of a school lab workbook in Spanish, and five ways a box can sit on them.
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document (this recipe is Spanish only)
const RECIPE = 'boxes-split-float-pin';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one yellow for fields, paler ones for two boxes, near-blacks for type and bars
const palette = {
  ink: '#1b2430', // text
  charcoal: '#2b2d42', // the safety bar, the summary's rule, the table head, the badge, titles
  sun: '#f2b705', // the opener band and the materials panel: fields, never type
  light: '#fad65a', // the procedure
  tint: '#fff6d6', // the data sheet
  rule: '#d7dde3', // hairlines
  muted: '#5d6b78', // running heads, notes
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at charcoal, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.charcoal })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Host Grotesk'; // text and display
const LABEL = 'Commit Mono'; // labels: kickers, box titles, step numbers, heads, the table
const LEAD = 13.6; // pt: the body leading, the pitch of the baseline grid
const LINES = 44; // grid lines in a full column
const [TRIM_W, TRIM_H, TOP, INNER, OUTER, GUTTER] = [195, 255, 22, 18, 14, 7]; // mm
const PT = 25.4 / 72; // mm in a point

// #region look: the base of every box (a mono title, smaller type), then one device each
const TITLE = { fontFamily: LABEL, fontSize: pt(8), color: col('charcoal'),
  textTransform: 'uppercase', letterSpacing: pt(1.2) }; // bold by default
const BOX_TYPE = { fontSize: pt(8.8), lineHeight: pt(12.4) }; // colours inherit bodyText
const box = (id, device) => ({ id, // margins: the defaults, snapped to whole grid lines
  padding: { top: mm(3), right: mm(3.6), bottom: mm(3.4), left: mm(3.6) },
  titleStyle: { ...TITLE, gap: mm(2) }, body: BOX_TYPE,
  lists: { gap: mm(2), itemSpacing: pt(3) }, ...device });
const icon = (id, size, extra) => ({ kind: 'resource', resourceId: id, size: mm(size),
  ...extra });
// A side bar with its icon centred on it, 1.4 mm narrower than the bar.
const bar = (hue, id, width = 5.6) => ({ backgroundEnabled: false,

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

#Manter o procedimento inteiro

Sem essa configuração, o procedimento, que cabe numa coluna, vai inteiro para o alto da coluna da direita e deixa 43 mm vazios no pé da esquerda.

-  box('pasos', { keepTogether: false, background: col('light'),
+  box('pasos', { background: col('light'),

#Fazer a folha de dados flutuar para o pé

Com placement="bottom" em content.es.md, a folha de dados ocupa o pé da página 42, onde cai o delimitador dela. O procedimento que ela desloca começa no alto da coluna da direita e se divide na virada da página, terminando no alto da página 43.

-:::callout{type="datos" placement="top" title="Hoja de datos · Madrid, 40,4° N · 3,7° O"}
+:::callout{type="datos" placement="bottom" title="Hoja de datos · Madrid, 40,4° N · 3,7° O"}

Erros comuns

Erro comum

Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita

Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →

Erro comum

A página 1 é ímpar: planeje com os números físicos

A página 1 fica à direita e a 2 é a primeira página par, então planeje as páginas duplas com os números físicos de página: uma abertura em página par fica de frente para a ímpar que vem depois dela. Quebras de página e de coluna →

Aviso de diagramação · calloutOverflow

Boxe ultrapassa a coluna

Por quê. Uma caixa que nenhum corte consegue dividir (uma figura, uma tabela ou um boxe aninhado nela mais alto que a coluna, ou um splitMinLines alto demais) foi colocada transbordando; o motor registra isso em doc.warnings e o Sandbox mostra na lista. Um boxe com span: 'side' mais alto que uma coluna lateral vazia também é colocado transbordando.

Correção. Encurte a caixa, deixe que ela se divida com keepTogether: false, reduza splitMinLines ou dê a ela outro span. Docs →

  • Um boxe mais alto que uma coluna inteira se divide, diga o que disser keepTogether. A configuração só decide nos boxes que cabem numa coluna, como este procedimento de 192 mm numa coluna de 211 mm.
  • splitMinLines (2 por padrão) é o mínimo de linhas que um corte deixa de cada lado, contadas no passo que ele corta, por isso nenhum passo deixa uma linha sozinha. O texto antes do procedimento foi ajustado para que o corte caia entre os passos 4 e 5. Qualquer mudança no texto acima de um boxe dividido pode mover o corte, por isso confira onde ele cai depois de cada uma.
  • Um ícone na linha ocupa uma coluna própria, e a continuação a mantém, vazia: os passos perdem a largura do ícone nas duas partes. Um ícone no canto, ou uma faixa lateral onde o ícone se apoie, deixa a eles a medida inteira.
  • Um boxe flutuante com placement="top" encabeça a página seguinte àquela em que cai o delimitador dele; por isso, o delimitador vai na página anterior à que o boxe deve encabeçar. Aqui ela fica logo antes do procedimento, na página 42.

Créditos

Texto
Imagens
  • The shadow chart, the dial in profile and the icons, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
Fontes
Host Grotesk (SIL OFL 1.1) · Commit Mono (SIL OFL 1.1)
Sandbox