Saltar al contingut principal
Recepta número 29

Receptari · Capítol 3 · Títols i obertures

Xuleta d'ancoratges: un cartell d'elements encadenats

Un cartell A3 amb elements penjats de la sang, de la pàgina, de la zona de disseny o d'altres elements, i un segon full que els emmarca i en retola tretze.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.34.0
Llicència
Actualitzada el 16 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 297 × 420 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Funnel Sans 12/16
  • Funnel Display
  • Martian Mono
  • 2 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 47 ms
  • 180 línies de codi

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

script.js · línies 56–72al codi complet
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

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

script.js · línies 76–87al codi complet
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

script.js · línies 91–100al codi complet
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

script.js · línies 104–115al codi complet
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ó

script.js · línies 119–146al codi complet
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

Sandbox
// ═══ 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 edge

Errors 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 #id que 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

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