En poques paraules
Un cartell de xerrades d'astronomia abans d'un eclipsi de sol. Ensenya a col·locar cada element mesurant des de la vora de la pàgina o des d'un altre element.
Què compondràs
Cartell d'un club d'astronomia fictici per a quatre xerrades, els dijous d'abril, abans de l'eclipsi total de Sol del 2 d'agost de 2027. Un cel blau ultramar omple els dos terços superiors d'un A3. Una Lluna negra tapa un Sol groc llimona tallat per la vora dreta, i darrere de tots dos s'estén una corona dibuixada amb codi. El títol, Vuelve la sombra en Funnel Display de 120 pt, es recolza en la seva entradeta al peu del cel. Sota l'horitzó, quatre dates blaves encapçalen les xerrades, i la lletra petita va a dues columnes sobre una banda blava. Cada element penja de la sang, de la pàgina, de la seva zona de disseny o d'un altre, i els seus desplaçaments es mesuren des d'allà. El segon full emmarca en rosa la caixa de cada element i els contenidors de capçalera i peu, i retola tretze elements amb el seu ancoratge.
Aquesta recepta respon a
- Com col·loco els elements de disseny respecte a la pàgina, la sang o entre si, en lloc de per coordenades?
- Com afegeixo una marca d'aigua, un fons de color o una imatge decorativa a totes les pàgines?
La 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.
Ingredients
- Funcions
- Ancoratge d'elements de dissenyTextos, filets i caixes als dissenys de pàginaImatges als dissenys de pàginaObertures dissenyadesBanda de capítol d'amplada completaBandes a sang i pestanyesEstils de títolCapçaleres per seccióAtributs de títolSalts de línia als títolsPaleta de color semànticaEstils de paràgrafFigures i taules com a recursosPàgines en un canvas
- També fa servir
- Sang i marques de tall
- Tipografia
- Funnel Display, Funnel Sans, Martian Mono (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Ancora dos elements al full i penja-hi els altres
El codi és la resposta curta de dalt. En aquest codi, anchor.to diu de què penja un element: 'bleed' i 'page' són marcs del full (la mateixa caixa mentre page.cutLines estigui desactivat), 'container' és la caixa de la zona mateixa i '#id' és un altre element (posicionament d'elements). Una caixa sense amplada arriba fins a la vora oposada del seu marc, de manera que el cel ocupa la sang d'un costat a l'altre. Un element col·locat respecte al cel es mesura des de la vora esquerra del cel, que és la de la sang; per això la x de l'entradeta és INSET, 18 mm. El titular es munta de baix a dalt des de la vora inferior del cel. 'align-bottom' deixa la base de la caixa de l'entradeta AIR, 14 mm, per sobre d'aquesta vora, i 'above' recolza cada element sobre el de sota, de manera que un títol amb més línies fa pujar l'avanttítol en comptes de trepitjar l'entradeta. Sota el disseny, la lletra petita comença a la primera línia de la retícula de base de 16 pt que queda com a mínim 3,2 mm per sota de l'element més baix, la línia dels ponents; aquests 3,2 mm són el marge inferior que el títol porta per defecte.
#2 · Penja la Lluna i la corona del 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)),
];
El Sol és l'únic element ancorat a la pàgina, que és la caixa de tall. Comptada des de la cantonada 'top-right', una x positiva surt per la vora dreta, i 30 mm del disc queden fora. La Lluna i la corona pengen del Sol amb 'align-top', així que es mouen amb ell. Els seus desplaçaments es compten des de la cantonada superior esquerra del Sol: la Lluna es desplaça 2 mm a la dreta i 2,5 mm cap avall, cosa que deixa un fil de Sol a dalt a l'esquerra, i la corona comença HALO, 75 mm, més amunt i més a l'esquerra, cosa que centra el seu quadrat de 300 mm sobre el disc de 150 mm. La corona és un element d'imatge que pren la mida de la seva caixa (elements d'imatge) i va a la llista abans que els discos per pintar-se darrere seu.
#3 · Encadena les quatre tardes en columnes
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, xerrada i ponent té un size.width fix de COL, i 'right-of' més GUT posa la data següent una columna més enllà. Sense amplada, una data s'ajusta a les seves xifres (el «8» fa 17 mm), així que el «15» començaria 7 mm després i cada xerrada correria en una sola línia fins a ficar-se a la columna següent. COL reparteix l'amplada del text entre quatre amb el mateix espai entre columnes de 7 mm que les dues columnes de lletra petita de sota, de manera que la segona columna de lletra petita comença sota el 22. Cada xerrada penja 'below' de la seva data i cada ponent de la seva xerrada, de manera que una xerrada que ocupés tres línies faria baixar el seu ponent i cap altre.
#4 · Porta la banda al peu, a totes les pàgines
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)),
] };
El que hagi de sortir a totes les pàgines, com aquesta banda, va a la zona de la capçalera o del peu de pàgina, i un estil d'encapçalament amb capçalera o peu propis la substitueix a les pàgines de la seva secció. El peu de l'estil de les guies repeteix aquests quatre elements amb els seus marcs i les seves etiquetes; per això la banda i l'emblema surten als dos fulls. El contenidor del peu és el marge inferior, del text al tall: 'bottom-left' compta cap amunt des del tall i 'top-right' cap avall des del text, i el −10 de l'emblema i el +10 de la línia «Entrada libre» cauen a la mateixa franja de 10 mm, al mig de la banda (capçaleres i peus). El peu es pinta després del text i no li treu lloc, de manera que FOOT és alhora el marge inferior i l'alçada de la banda, que així mai no trepitja les línies de sobre.
#5 · Dibuixa les línies de construcció des de la mateixa configuració
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() recorre els elements del cartell. Un text rep una vora a la seva caixa, i una caixa quadrada, una vora al seu estil; cap de les dues no mou res, perquè només el padding fa més gran una caixa. Una imatge o un disc rodó rep una caixa quadrada de la mateixa mida penjada de la seva cantonada superior esquerra, així que també queda dibuixada la cantonada del Sol d'on pengen la Lluna i la corona. Cada etiqueta és un text penjat del seu element i escrit per describe() a partir del placement d'aquest element, de manera que cap etiqueta no pot contradir la configuració que retola. {style="guides"} al segon títol porta aquest disseny, amb una capçalera i un peu propis (estils de capçalera). Una etiqueta sense amplada només disposa de l'espai entre el seu ancoratge i la vora dreta del contenidor; per això l'etiqueta de #free comença 30 mm a l'esquerra del seu text. pageIndexOffset: 1, a la continuation del contingut, converteix el cartell en pàgina parella, i així el visor posa els dos fulls l'un al costat de l'altre.
La recepta 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 = 'es'; // @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 }),
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Afegeix 3 mm de sang i marques de tall
Amb 3 mm de BLEED s'activen les marques de tall, i el cel i la banda del peu, que pengen de la sang, hi entren 3 mm mentre INSET deixa el text al marge; el Sol, la Lluna i la corona pengen de la pàgina, i tot el que pinta una pàgina es retalla a la sang, de manera que el Sol s'acaba 3 mm més enllà del tall i fora de la sang només queden les marques de tall.
-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#Puja l'horitzó
Amb 20 mm menys de SKY puja la vora del cel, i amb ella l'entradeta, el títol, l'avanttítol i els dotze textos del programa, mentre la lletra petita passa a una línia més alta de la retícula de base; el Sol penja de la pàgina, així que el segon canvi el puja els mateixos 20 mm perquè mantingui la distància amb el títol, que a l'edició anglesa arribaria a tocar el fil 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 edgeErrors freqüents
Error freqüent
Els elements de capçalera i peu es pinten damunt del text
Els elements de capçalera i peu es pinten sobre la pàgina i l'àrea de text no els deixa lloc. Mantén-los dins dels marges, que són els que els reserven l'espai. Capçaleres i folis →
Error freqüent
Valors d'atribut: sense { ni }; cometes simples si porten "
Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →
Comprovació del Sandbox · designCyclicAnchor
Referència d'ancoratge cíclica
Per què. Els elements de disseny s'ancoren els uns als altres en bucle, de manera que cap no es pot col·locar.
Solució. Ancora un element de la cadena al contenidor, a la pàgina o a la sang. Documentació →
Comprovació del Sandbox · designDanglingAnchor
Referència d'ancoratge trencada
Per què. Un element de disseny s'ancora a un #id que no té cap element de la zona de disseny.
Solució. Corregeix l'id o afegeix l'element al qual es refereix. Documentació →
- En un pen res no avisa d'un ancoratge cíclic ni d'un de trencat. El tauler Revisió del Sandbox en dona un avís a la capçalera, al peu, a les portadelles de part i als nivells de títol, però no als estils d'encapçalament com
guides. Un element ancorat a un#idque no existeix es col·loca respecte al contenidor: una vora d'element com'below'cau a la cantonada superior esquerra del contenidor, amb el seu desplaçament, i una vora de contenidor com'top-right', en aquesta cantonada. En un bucle, un element cau de la mateixa manera i els altres s'hi encadenen. 'align-left'i'align-top'porten al mateix punt: tots dos posen la cantonada superior esquerra de l'element sobre la de la seva àncora.- Una vora es pinta centrada sobre el contorn de la caixa, així que cada marc rosa d'1 pt sobresurt 0,5 pt de la caixa que traça, tot i que la documentació de la configuració diu que els traços es pinten per dins.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Funnel Display (SIL OFL 1.1) · Funnel Sans (SIL OFL 1.1) · Martian Mono (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


