Em poucas palavras
Um cartaz de palestras de astronomia antes de um eclipse do Sol. Mostra como posicionar cada item medindo a partir da borda da página ou de outro item.
O que você vai compor
Um cartaz de um clube de astronomia fictício para quatro palestras às quintas-feiras antes do eclipse total do Sol de 2 de agosto de 2027. Um céu azul-ultramar ocupa os dois terços superiores de uma folha A3. À direita, uma Lua preta cobre um Sol amarelo-limão cortado pelo refile, e uma coroa desenhada em código se espalha atrás dos dois. O título, The Shadow Returns em Funnel Display de 120 pt, se apoia na linha fina, no pé do céu. Abaixo do horizonte, quatro datas em azul encabeçam as palestras, e a letra miúda corre em duas colunas sobre uma faixa azul. Cada elemento se pendura na sangria, na página, no espaço de design ou em outro elemento, e os deslocamentos contam a partir dali. A segunda folha repete o cartaz com uma moldura rosa em volta da caixa de cada elemento e dos contêineres do cabeçalho e do rodapé, e um rótulo em treze elementos que imprime o posicionamento de cada um.
Esta receita responde a
- Como posiciono elementos de design em relação à página, à sangria ou uns aos outros, em vez de usar coordenadas?
- Como acrescento uma marca-d'água, um fundo de cor ou uma imagem decorativa em todas as páginas?
A resposta curta
const SKY = 272; // mm from the trim's top edge to the horizon, the sky's lower edge
const INSET = BLEED + MARGIN; // from the bleed's edge to the text's edge
const AIR = 14; // mm between the standfirst and the horizon
const poster = () => ({ enabled: true, slot: { elements: [ // array order is paint order
// 'bleed' and 'page' are frames of the sheet; 'container' would be this heading's own box.
{ kind: 'box', id: 'sky', style: { backgroundColor: col('sky') }, // no width: fills the bleed
placement: at('bleed', 'top-left', 0, 0, { height: mm(BLEED + SKY) }) },
...eclipse(), // the Sun hangs from the trim's corner, the Moon and the corona from the Sun
// The headline stands on the horizon and grows upwards: 'above' puts an element's
// bottom-left corner on the top-left corner of its anchor, so a longer title lifts the kicker.
text('deck', '{attr.deck}', FACE.deck, { ...at('#sky', 'align-bottom', INSET, -AIR),
size: { maxWidth: mm(153) } }), // shrink-wraps its lines, but wraps at 153 mm
text('title', '{titleText}', FACE.title, at('#deck', 'above', 0, -9)), // breaks at the \\
text('kicker', '{attr.kicker}', FACE.kicker, at('#title', 'above', 0, -7)),
...programme(), // four columns chained off the horizon
] } }); // hook-up: headings.levels[0] = { span: 'page', breakBefore, advancedDesign: poster() }
// {titleText} is the heading's text; each {attr.*} is written on its line in content.md.
Ingredientes
- Funcionalidades
- Ancoragem de elementos de designTextos, fios e caixas nos designs de páginaImagens nos designs de páginaAberturas desenhadasFaixa de capítulo em largura totalFaixas sangradas e guias lateraisEstilos de títuloCabeços por seçãoAtributos de títuloQuebras de linha nos títulosPaleta de cores semânticaEstilos de parágrafoFiguras e tabelas como recursosPáginas em um canvas
- Também usa
- Sangria e marcas de corte
- Tipografia
- Funnel Display, Funnel Sans, Martian Mono (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Prenda dois elementos à folha e pendure o resto neles
O código é a resposta curta logo acima. Nele, anchor.to diz de onde um elemento se pendura: 'bleed' e 'page' são caixas de referência da folha (a mesma caixa enquanto page.cutLines estiver desativado), 'container' é a caixa do próprio espaço de design e '#id' é outro elemento (posicionamento de elementos). Uma caixa sem largura vai até a borda oposta da caixa de referência, por isso o céu ocupa a sangria de um lado ao outro. Um elemento posicionado em relação ao céu mede a partir da borda esquerda do céu, que é a da sangria; por isso a linha fina usa INSET, 18 mm, como x. O título é montado de baixo para cima a partir da borda inferior do céu. 'align-bottom' coloca o pé da caixa da linha fina AIR, 14 mm, acima dessa borda, e 'above' apoia o pé de cada elemento no topo do que está embaixo, de modo que um título com mais linhas levanta o antetítulo em vez de cobrir a linha fina. Abaixo do design, a letra miúda começa na primeira linha da grade de 16 pt que fique pelo menos 3,2 mm abaixo do elemento mais baixo, a linha dos palestrantes; esses 3,2 mm são a margem inferior padrão do título.
#2 · Pendure a Lua e a coroa no Sol
const SUN = 150; // mm across; the Moon is drawn the same size
const CORONA = 300; // mm, the square picture of the corona
const HALO = (CORONA - SUN) / 2; // how far the corona reaches past the Sun on every side
const BITE = { x: 2, y: 2.5 }; // mm the Moon sits off the Sun: a sliver is left at upper left
const disc = (id, colour, placement) => ({ kind: 'box', id, placement: { ...placement,
size: square(SUN) }, style: { backgroundColor: col(colour), borderRadius: mm(SUN / 2) } });
const eclipse = () => [
{ kind: 'image', id: 'corona', resourceId: 'corona', // listed before the discs: painted behind
placement: at('#sun', 'align-top', -HALO, -HALO, square(CORONA)) },
disc('sun', 'sun', at('page', 'top-right', 30, 25)), // 30 mm of it past the right edge
disc('moon', 'ink', at('#sun', 'align-top', BITE.x, BITE.y)),
];
O Sol é o único elemento preso à página, a caixa do refile. Medido a partir do canto 'top-right', um x positivo passa da borda direita, de modo que 30 mm do disco ficam cortados. A Lua e a coroa se penduram no Sol com 'align-top', de modo que mover o Sol move os dois. Os deslocamentos contam a partir do canto superior esquerdo do Sol: a Lua fica 2 mm à direita e 2,5 mm abaixo, o que deixa uma lasca de Sol no alto à esquerda, e a coroa começa HALO, 75 mm, acima e à esquerda, o que centraliza o quadrado de 300 mm sobre o disco de 150 mm. A coroa é um elemento de imagem que assume o tamanho da caixa (elementos de imagem) e vem antes dos discos na lista, por isso é pintada atrás deles.
#3 · Encadeie as noites em colunas
const GUT = 7; // mm between the evenings, and between the two columns of text under them
const COL = (A3.width - 2 * MARGIN - 3 * GUT) / 4; // four columns across the text width: 60 mm
const DROP = 12; // mm from the horizon to the dates
const programme = () => [1, 2, 3, 4].flatMap((n) => [
text(`day${n}`, `{attr.d${n}}`, FACE.day, n === 1
? at('#sky', 'below', INSET, DROP, wide(COL)) // the first date hangs from the horizon
: at(`#day${n - 1}`, 'right-of', GUT, 0, wide(COL))), // the others from the one before
text(`talk${n}`, `{attr.t${n}}`, FACE.talk, at(`#day${n}`, 'below', 0, 3, wide(COL))),
text(`who${n}`, `{attr.s${n}}`, FACE.who, at(`#talk${n}`, 'below', 0, 2.5, wide(COL))),
]);
Cada data, palestra e linha de palestrante tem um size.width fixo de COL, e 'right-of' mais GUT coloca a data seguinte uma coluna adiante. Sem largura, uma data se ajusta aos algarismos (o “8” tem 17 mm de largura), por isso o “15” começaria 7 mm depois dele e cada palestra correria numa só linha até invadir a coluna seguinte. COL divide a largura do texto em quatro com a mesma medianiz de 7 mm das duas colunas de letra miúda abaixo, o que põe a segunda coluna de letra miúda sob o 22. Cada palestra se pendura 'below' da data e cada linha de palestrante abaixo da palestra, por isso uma palestra que quebrasse numa terceira linha empurraria para baixo o próprio palestrante e nenhum outro.
#4 · Ponha a faixa no rodapé, em todas as páginas
const MARK = 10; // mm, the club's mark
const PAD = (FOOT - MARK) / 2; // centres the mark in the bottom margin
const markTall = { height: mm(MARK) }; // as tall as the mark: the line is centred on it
const footer = { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('sky') }, // the bottom margin, bled
placement: at('bleed', 'bottom-left', 0, 0, { height: mm(BLEED + FOOT) }) },
// The container runs from the text down to the trim: 'bottom-*' counts up, 'top-*' down.
{ kind: 'image', id: 'mark', resourceId: 'mark',
placement: at('container', 'bottom-left', 0, -PAD, square(MARK)) },
text('club', '{attr.club}', FACE.foot, at('#mark', 'right-of', 3, 0, markTall)),
text('free', '{attr.free}', FACE.foot, at('container', 'top-right', 0, PAD, markTall)),
] };
Tudo o que precisa sair em todas as páginas, como esta faixa, vai no espaço de design do cabeçalho ou do rodapé, e um estilo de título com cabeçalho ou rodapé próprio substitui esse espaço nas páginas da seção dele. O rodapé do estilo das guias repete estes quatro elementos com as molduras e rótulos, e é por isso que a faixa e o selo saem nas duas folhas. O contêiner do rodapé é a margem inferior, do texto até o refile: 'bottom-left' conta para cima a partir do refile e 'top-right' para baixo a partir do texto, e o −10 do selo e o +10 da linha “Free entry” caem na mesma faixa de 10 mm no meio da faixa azul (cabeçalhos e rodapés). O rodapé é pintado depois do texto e não tira espaço dele, de modo que FOOT define ao mesmo tempo a margem inferior e a altura da faixa, e a faixa nunca encosta nas linhas de cima.
#5 · Desenhe as linhas de construção a partir da mesma configuração
const GUIDE = { borderColor: col('guide'), borderWidth: pt(1) };
const signed = ({ value }) => `${value < 0 ? '−' : '+'}${Math.abs(value)}`; // all offsets in mm
const describe = ({ id, placement: { anchor: { to, edge }, offset = {} } }) => [`#${id}`,
`${edge} ${to}`, // the two words of anchor: { to, edge }
['x', 'y'].filter((k) => offset[k]?.value).map((k) => `${k} ${signed(offset[k])}`).join(' '),
].filter(Boolean).join(' · ');
// A border never changes an element's size (padding does), so each frame traces its box.
// An image or a rounded box gets a square frame of its size, hung from its top-left corner.
const frame = (el) => (el.kind === 'text' ? [{ ...el, box: { ...el.box, ...GUIDE } }]
: el.kind === 'box' && !el.style.borderRadius ? [{ ...el, style: { ...el.style, ...GUIDE } }]
: [el, { kind: 'box', id: `${el.id}-box`, style: GUIDE,
placement: at(`#${el.id}`, 'align-top', 0, 0, el.placement.size) }]);
const tag = (el, [edge, x = 0, y = 0, note]) => text(`${el.id}-tag`, note ?? describe(el),
face('Martian Mono', 8.5, 500, 'ink', { box: { backgroundColor: col('guide'),
padding: { top: pt(1.6), bottom: pt(1.2), left: pt(3), right: pt(3) } } }),
at(`#${el.id}`, edge, x, y));
const guides = (elements, tags) => [...elements.flatMap(frame),
...elements.filter((el) => tags[el.id]).map((el) => tag(el, tags[el.id]))];
const container = (id) => ({ kind: 'box', id, style: GUIDE, // the slot's own box, drawn
placement: at('container', 'top-left', 0, 0, { width: 'fill', height: 'fill' }) });
const TAGS = { // where each tag sits against its element: [edge, x, y, text]
sky: ['align-bottom', INSET, -3], corona: ['align-bottom', 90, -2], sun: ['above'],
moon: ['below', 20, 2], kicker: ['above'], title: ['above'], deck: ['above'],
day1: ['above', 0, -6], day2: ['above'], who1: ['below'],
mark: ['above', 0, -2], club: ['above', 69, -2], free: ['above', -30, -2],
header: ['align-bottom', 0, -2, t({ en: 'header container', es: 'contenedor de la cabecera' })],
footer: ['align-bottom', 0, -2, t({ en: 'footer container', es: 'contenedor del pie' })],
};
guides() percorre os elementos do cartaz. Um texto ganha uma borda na caixa, e uma caixa quadrada, uma borda no estilo; nenhuma das duas move nada, porque só o preenchimento aumenta uma caixa. Uma imagem ou um disco redondo ganha uma caixa quadrada do próprio tamanho pendurada no canto superior esquerdo, por isso o canto do Sol em que a Lua e a coroa se penduram também fica desenhado. Cada rótulo é um texto pendurado no elemento, escrito por describe() a partir do placement desse mesmo elemento, por isso um rótulo não tem como discordar da configuração que ele descreve. {style="guides"} no segundo título traz este design, com cabeçalho e rodapé próprios (estilos de título). Um rótulo sem largura só dispõe do espaço entre a âncora e a borda direita do contêiner, e é por isso que o rótulo de #free começa 30 mm à esquerda do texto. pageIndexOffset: 1, na continuation do conteúdo, transforma o cartaz numa página par, e o visualizador põe as duas folhas lado a lado.
A receita completa
// ═══ Postext Cookbook · Nº 029 · Anchoring cheat sheet: a poster built from chained elements ═══
// https://postext.dev/en/cookbook/anchoring-cheat-sheet
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Funnel Display, Funnel Sans, Martian Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// An A3 poster whose elements hang from the bleed, the page, their slot or one another, never
// from coordinates; the second sheet is the same poster with each element framed and tagged.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'anchoring-cheat-sheet';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#0b0b0c', // text, and the Moon
sky: '#1b3bff', // the sky, the foot band and the dates
sun: '#ffe53b', // the Sun and the kicker
paper: '#ffffff', // type on the sky
muted: '#5c5f66', // speakers and the colophon
guide: '#ff2d9b', // frames and tags on the construction sheet
};
// col(id): a colour linked to its palette entry, so a swapped palette recolours the sheet.
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: 'sky (defaults)', value: { hex: palette.sky, model: 'hex' } },
];
const A3 = { width: 297, height: 420 }; // mm, the trim
const MARGIN = 18; // mm at the top and sides: the body's edges, and the header container's
const FOOT = 30; // mm, the bottom margin: the footer container and its band
const BLEED = 0; // mm; 3 for the printer, which switches on page.cutLines below
// at(): a placement. Offsets are distances from the anchor point, never page coordinates.
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const wide = (w) => ({ width: mm(w) }); // fixed, so a text is as wide as its column
const square = (d) => ({ width: mm(d), height: mm(d) });
// Design text is centred by default, and in a footer it is cut with '…': these wrap, set left.
const text = (id, content, face, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
align: 'left', ...face, placement });
const face = (fontFamily, size, fontWeight, colour, more) => ({ fontFamily, fontSize: pt(size),
fontWeight, color: col(colour), ...more });
const caps = (tracking) => ({ letterSpacing: pt(tracking), textTransform: 'uppercase' });
const FACE = { // lineHeight as a multiple of each size
kicker: face('Martian Mono', 12, 500, 'sun', caps(1.8)),
title: face('Funnel Display', 120, 800, 'paper', { lineHeight: 0.86 }),
deck: face('Funnel Sans', 22, 400, 'paper', { lineHeight: 1.22 }),
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
#Acrescente 3 mm de sangria e marcas de corte
Três milímetros de BLEED ligam as linhas de corte e empurram o céu e a faixa do rodapé 3 mm para dentro da sangria em que se penduram, enquanto INSET mantém o texto na margem; o Sol, a Lua e a coroa se penduram na página, e tudo o que uma página pinta é recortado na sangria, de modo que o Sol termina 3 mm além do corte e fora da sangria ficam só as marcas de corte.
-const BLEED = 0; // mm; 3 for the printer, which switches on page.cutLines below
+const BLEED = 3; // mm; 3 for the printer, which switches on page.cutLines below#Suba o horizonte
Tirar 20 mm de SKY levanta a borda do céu e, com ela, a linha fina, o título, o antetítulo e os doze textos da programação, enquanto a letra miúda começa numa linha mais alta da grade; o Sol se pendura na página, de modo que a segunda mudança o levanta os mesmos 20 mm, senão o “w” de Shadow encostaria na lasca de Sol.
-const SKY = 272; // mm from the trim's top edge to the horizon, the sky's lower edge
+const SKY = 252; // mm from the trim's top edge to the horizon, the sky's lower edge
- disc('sun', 'sun', at('page', 'top-right', 30, 25)), // 30 mm of it past the right edge
+ disc('sun', 'sun', at('page', 'top-right', 30, 5)), // 30 mm of it past the right edgeErros comuns
Erro comum
Os elementos de cabeçalho e rodapé são pintados sobre o texto
Os elementos de cabeçalho e rodapé são pintados por cima da página, e a área de texto não abre espaço para eles. Mantenha esses elementos dentro das margens, que são o que reserva o espaço deles. Cabeços e fólios →
Erro comum
Valores de atributo: sem { ou }; aspas simples se tiver "
Um valor de atributo termina na chave de fechamento, por isso não pode conter { nem }. Um valor que contém aspas duplas vai entre aspas simples; o cifrão não causa problema. Atributos de título →
Verificação do Sandbox · designCyclicAnchor
Referência de âncora cíclica
Por quê. Elementos de design se ancoram uns nos outros em ciclo; por isso, nenhum deles pode ser posicionado.
Correção. Ancore um elemento da cadeia no contêiner, na página ou na sangria. Docs →
Verificação do Sandbox · designDanglingAnchor
Referência de âncora pendente
Por quê. Um elemento de design se ancora num #id que nenhum elemento do mesmo espaço de design tem.
Correção. Corrija o id ou acrescente o elemento a que ele se refere. Docs →
- Num pen, nada avisa de âncoras cíclicas nem de âncoras soltas. O painel Verificações do Sandbox as aponta no cabeçalho, no rodapé, nas páginas de parte e nos níveis de título, mas não em estilos de título como
guides. Um elemento preso a um#idque não existe é posicionado em relação ao contêiner: uma borda de elemento como'below'volta ao canto superior esquerdo do contêiner, com o deslocamento, e uma borda de contêiner como'top-right', a esse canto. Num laço, um elemento volta da mesma forma e os outros se encadeiam nele. 'align-left'e'align-top'levam ao mesmo ponto: os dois põem o canto superior esquerdo do elemento sobre o canto superior esquerdo da âncora.- Uma borda é pintada centrada no contorno da caixa, por isso cada moldura rosa de 1 pt avança 0,5 pt para fora da caixa que contorna, embora a documentação de configuração diga que os traços são pintados por dentro.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Funnel Display (SIL OFL 1.1) · Funnel Sans (SIL OFL 1.1) · Martian Mono (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)


