Configurazione: intestazioni e piè di pagina

#Intestazioni e piè di pagina

Le proprietà header e footer controllano gli spazi di intestazione e piè di pagina di ogni pagina. Intestazioni e piè di pagina si disegnano dentro i margini esistenti della pagina: non riservano spazio aggiuntivo e non riducono l’area del contenuto.

Cornice del contenitore. Un elemento ancorato a 'container' si colloca nella fascia di margine tra il testo e il bordo di rifilo, per tutta la larghezza dell’area del contenuto. Il contenitore dell’intestazione va dal bordo superiore di rifilo fino alla sommità del testo; quello del piè di pagina dalla base del testo fino al bordo inferiore di rifilo. Quindi le ancore top-* dell’intestazione e bottom-* del piè di pagina misurano dal bordo di rifilo, mentre le ancore bottom-* dell’intestazione e top-* del piè di pagina misurano dal bordo del testo. Il contenitore non comprende mai l’abbondanza né la fascia dei segni di taglio, quindi un’intestazione o un piè di pagina cade nella stessa posizione sulla pagina rifilata sia con page.cutLines attivo sia disattivato. Ancora a 'page' (il formato rifilato) o a 'bleed' per andare oltre la larghezza dell’area del contenuto o dentro l’abbondanza.

Gli spazi usano il modello unificato degli spazi di progetto: ogni elemento ha un placement con un anchor (al contenitore o a un altro elemento tramite #id), un offset facoltativo e una size facoltativa. I vecchi campi piatti align, marginFromBody, marginFromEdge e width: 'full' sono ancora accettati in ingresso e vengono convertiti automaticamente nella nuova forma; la descrizione equivalente nella nuova forma è documentata più sotto.

Ogni spazio contiene un elenco di elementi text, rule e box. L’ordine dell’array è l’ordine di disegno (il primo elemento si disegna per primo, l’ultimo sopra tutti). Vale qualunque cosa dicano le ancore: un elemento può ancorarsi a uno elencato dopo di lui (anchor.to: '#ttl'), così un riquadro di sfondo può venire per primo ed essere comunque posizionato rispetto al testo che sta dietro.

Valori predefiniti incorporati. Quando header o footer è undefined, postext applica un valore predefinito incorporato ragionevole invece di uno spazio vuoto:

• Intestazione predefinita: {title} allineato a destra sulle pagine dispari, {chapterTitle} allineato a sinistra sulle pagine pari e un filetto a tutta larghezza, tutto nel colore principale della palette, Open Sans 8pt/600, marginFromBody 16pt (testo) / 13pt (filetto).
• Piè di pagina predefinito: {pageNumber} centrato su ogni pagina nel colore principale della palette, Open Sans 8pt/600, marginFromBody 16pt.

Per rinunciare ai valori predefiniti incorporati, imposta header: { elements: [] } (o footer: { elements: [] }). Un array elements vuoto ed esplicito viene conservato come «nessun elemento»: solo undefined attiva i valori predefiniti.

#Elementi di testo

Gli elementi di testo disegnano una stringa modello sostituendo i segnaposto. I segnaposto usano la sintassi {name}; {{ e }} producono parentesi graffe letterali.

I valori predefiniti della tabella qui sotto sono quelli di un elemento di testo che aggiungi tu. L’intestazione e il piè di pagina incorporati descritti più sopra in Valori predefiniti incorporati sono elementi già pronti con valori propri (Open Sans 8pt/600 nel colore principale della palette), non i valori predefiniti dell’elemento.

Segnaposto disponibili:

• {pageNumber}: numero della pagina corrente, a partire da 1.
• {totalPages}: numero totale di pagine del documento. In un libro impaginato capitolo per capitolo (la Sandbox, buildBundle) ogni capitolo è un documento, quindi questo è il conteggio del capitolo stesso.
• {bookTotalPages}: numero totale di pagine dell’intero libro: tutti i capitoli, pagine bianche comprese. Per un documento impaginato da solo è uguale a {totalPages}. Vedi Numero di pagine del libro più sotto.
• {title}, {subtitle}, {author}, {publishDate}: valori letti da content.metadata. I metadati sconosciuti o vuoti producono una stringa vuota (e generano un avviso nella Sandbox).
• {chapterTitle}: testo dell’H1 più recente sulla pagina corrente o prima di essa. Un H1 il cui stile di titolo imposta runningChapter: false (una tavola, una mappa) viene saltato.
• {chapterTitleAtTop}, {chapterNumberAtTop}: titolo e numero del capitolo in vigore in cima alla pagina, che differiscono da {chapterTitle} e {chapterNumber} su una pagina dove un nuovo capitolo inizia sotto altro testo. Vedi Il capitolo in cima alla pagina più sotto.
• {partTitle}, {partNumber}: titolo e numero della parte corrente (la pagina :::part più recente sulla pagina corrente o prima di essa; le pagine bianche di parità appena prima di una pagina di parte le appartengono già). Vuoti prima della prima parte.
• {firstMark.<key>}, {lastMark.<key>}: la prima e l’ultima parola guida della pagina: un titolo di un livello (h1–h6) o una voce di uno stile di paragrafo. Vedi Parole guida più sotto.

Numero di pagine del libro

{bookTotalPages} stampa il numero di pagine dell’intero libro, il conteggio che un lettore vede in «pagina 12 di 348». Conta le pagine fisiche, bianche comprese, come {totalPages}, ma su tutti i capitoli:

• Un documento impaginato da solo (buildDocument senza continuation) è l’intero libro: {bookTotalPages} è uguale a {totalPages}.
• buildBundle impagina il libro, somma le pagine di tutti i capitoli e lo impagina ancora una volta con quel totale, così ogni capitolo stampa lo stesso numero. Il conteggio non sposta mai un’interruzione di pagina, quindi basta un giro in più; una configurazione che non stampa {bookTotalPages} non costa nulla.
• La Sandbox passa il totale a ogni capitolo quando le pagine di tutti i capitoli sono note. Fino ad allora, un capitolo stampa le pagine fino alla propria fine. L’esportazione dell’intero libro della scheda PDF conta le pagine che impagina: quando un capitolo ha stampato un altro conteggio, perché le sue pagine non erano ancora note, impagina il libro ancora una volta con il conteggio a cui sono arrivati i capitoli.
• Un host che impagina i capitoli da sé passa il totale come continuation.bookPageCount (anche al primo capitolo). Senza di esso, {bookTotalPages} conta le pagine fino alla fine del documento (continuation.pageIndexOffset più le sue pagine), il che è corretto solo per l’ultimo capitolo.

footer: {
  elements: [{
    kind: 'text', id: 'folio', content: '{pageNumber} / {bookTotalPages}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'top' }, size: { width: 'auto', height: 'auto' } },
  }],
}

configUsesPlaceholder(config, 'bookTotalPages') dice a un host se vale la pena calcolare il conteggio.

Parole guida: primo e ultimo segno

Un dizionario stampa nella testatina la prima e l’ultima voce di ogni pagina («Aback – Anchor»); un’opera di consultazione stampa la prima e l’ultima sezione. {firstMark.<key>} e {lastMark.<key>} le stampano. La chiave indica che cosa marca una pagina:

• Da h1 a h6: un titolo di quel livello. Il segno è il suo testo, senza il numero.
• L’id di uno stile di paragrafo (entry): un paragrafo di un contenitore :::paragraphs{style="entry"}. Il segno è la sequenza in grassetto con cui si apre il paragrafo, il lemma, senza la punteggiatura finale: **Aback.** Said of… marca Aback. Un paragrafo che non si apre con testo in grassetto non imposta alcun segno.

{firstMark.<key>} è il primo segno che inizia sulla pagina e {lastMark.<key>} l’ultimo. Una pagina su cui non inizia alcun segno (una voce lunga che continua) stampa per entrambi il segno in vigore, l’ultimo prima di essa. Le pagine prima del primo segno non stampano nulla; in un libro impaginato capitolo per capitolo si tratta del primo segno del capitolo, perché i segni non passano da un capitolo al successivo. Un titolo o un paragrafo diviso tra più pagine marca solo la pagina in cui inizia. La chiave si scrive dopo il punto con lettere, cifre, _ e -, cominciando con una lettera o con _; una chiave sconosciuta non stampa nulla.

:::paragraphs{style="entry"}
**Aback.** Said of the sails when pressed back against the mast.
 
**Abaft.** Towards the stern, or behind a given point.
:::

header: {
  elements: [{
    kind: 'text', id: 'guide', content: '{firstMark.entry} – {lastMark.entry}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom' }, size: { width: 'auto', height: 'auto' } },
  }],
}

Le parole guida sono testatine: si risolvono negli spazi di intestazione e piè di pagina (compresi header e footer di uno stile di titolo) e non stampano nulla nei progetti dei titoli, delle parti e del sommario; nei progetti dei titoli e delle parti il pannello Verifiche le segnala come segnaposto sconosciuti. Per mostrare il primo lemma sui verso e l’ultimo sui recto, crea due elementi con parity: 'even' e parity: 'odd'. Un H1 il cui stile di titolo imposta runningChapter: false non imposta alcun segno h1.

Il capitolo in cima alla pagina

{chapterTitle} e {chapterNumber} indicano l’ultimo capitolo iniziato sulla pagina o prima di essa. In un libro i cui capitoli si susseguono senza interruzione di pagina, una pagina che chiude un capitolo e inizia il successivo vicino al piede porta allora il titolo del nuovo capitolo sopra un testo che appartiene ancora al vecchio. {chapterTitleAtTop} e {chapterNumberAtTop} indicano invece il capitolo in vigore in cima alla pagina, come fanno i romanzi con capitoli consecutivi e molte opere di consultazione:

• una pagina il cui primo blocco è l’H1 di un capitolo indica quel capitolo;
• qualsiasi altra pagina indica il capitolo da cui prosegue, anche quando un nuovo capitolo inizia più in basso;
• una pagina bianca aggiunta per la parità va con la pagina che la segue, e il separatore delle modalità always-* con la pagina che lo precede (vedi Appartenenza delle pagine bianche); quando la pagina dopo una bianca di parità si apre con la fine di un capitolo e non con il suo H1, anche la bianca resta a quel capitolo;
• un H1 con runningChapter: false viene saltato.

header: {
  elements: [{
    kind: 'text', id: 'chapter', content: '{chapterTitleAtTop}', parity: 'odd', pages: 'body',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom-right' }, size: { width: 'auto', height: 'auto' } },
  }],
}

Come le parole guida, entrambi sono testatine: si risolvono negli spazi di intestazione e piè di pagina e non stampano nulla nei progetti dei titoli, delle parti e del sommario. {attr.<key>} legge sempre l’ultimo capitolo iniziato.

Allineamento implicito dal bordo

Quando il placement.anchor.to di un elemento di testo fa riferimento a un altro elemento tramite #id, il bordo di ancoraggio implica un allineamento predefinito del testo per le righe spezzate:

• right-of e align-left implicano un testo align: 'left': le righe spezzate scorrono verso destra a partire dall’ancora.
• left-of e align-right implicano align: 'right': le righe spezzate aderiscono al lato più vicino all’elemento di riferimento.

L’editor dei titoli della Sandbox applica automaticamente questi allineamenti impliciti quando cambi il bordo o l’elemento di ancoraggio. Mantengono il testo su più righe visivamente ancorato all’elemento a cui si riferisce (così, per esempio, la «P» di un «Postext» spezzato si allinea verticalmente sotto la «I» di «Introduction»).

Segni in linea e contorni

Un elemento di testo compone il suo testo in un solo carattere per impostazione predefinita: **, ^ e gli altri marcatori Markdown si stampano come sono scritti. Con inlineMarks: true il testo risolto viene letto come Markdown in linea, con gli stessi segni che accetta il testo (vedi Formato del documento → Formattazione in linea):

• **bold** imposta il peso 700 (o il fontWeight dell’elemento stesso quando è più pesante); *italic* inverte l’inclinazione dell’elemento, così l’enfasi dentro un elemento in corsivo risulta in tondo; ***both*** fa entrambe le cose. Funzionano anche le forme con il trattino basso (__bold__, _italic_).
• ^superscript^ e ~subscript~ si compongono al 58% del corpo, l’apice alzato di un terzo del corpo e il pedice abbassato di 0,15; un pedice e un apice che si toccano (T~0~^2^) vengono impilati, come nel testo.
• Una barra rovesciata compone il carattere marcatore stesso (\*, \_, \^, \~). Un link conserva il suo testo; gli apici inversi del codice vengono eliminati.

I segni si leggono dopo che i segnaposto sono stati riempiti, quindi un valore può contenerli: una riga di autori in un attributo del titolo riceve i numeri di affiliazione come apici. L’a capo, la giustificazione, le modalità con puntini, dropCap e paragraphIndent funzionano tutti sul testo marcato; ogni sequenza conserva il colore dell’elemento.

{ "kind": "text", "id": "authors", "content": "{attr.authors}", "inlineMarks": true, "overflow": "wrap",
  "fontSize": { "value": 11, "unit": "pt" },
  "placement": { "anchor": { "to": "#title", "edge": "below" }, "offset": { "y": { "value": 6, "unit": "pt" } } } }

# Snow cover and river flow {authors="Ana Ruiz^1^, Luis Gil^2^ and Marta Sanz^1,3^"}

stroke traccia un contorno intorno alle lettere: width è lo spessore della linea, centrata sui bordi dei glifi (metà cade dentro le lettere, metà fuori; la larghezza misurata del testo non cambia), color vale per impostazione predefinita il colore del testo, e hollow: true lascia le lettere senza riempimento così che si veda solo il contorno: un numero da display a contorno, un titolo che si stacca da una fotografia. Il contorno si dipinge sopra il riempimento, allo stesso modo nel canvas, nell’HTML (-webkit-text-stroke) e nel PDF (modalità di rendering del testo 2, o 1 quando è vuoto).

{ "kind": "text", "id": "year", "content": "1863", "fontFamily": "Bitter", "fontSize": { "value": 120, "unit": "pt" }, "fontWeight": 700,
  "color": { "hex": "#1d3557", "model": "hex" },
  "stroke": { "width": { "value": 1.5, "unit": "pt" }, "hollow": true },
  "placement": { "anchor": { "to": "page", "edge": "bottom-right" }, "offset": { "x": { "value": -15, "unit": "mm" }, "y": { "value": -20, "unit": "mm" } } } }

Nel PDF le sequenze in grassetto e in corsivo incorporano i caratteri corrispondenti della famiglia dell’elemento, quindi il provider di font deve fornirli.

Valori predefiniti del testo e trappole dell’ancoraggio

Un elemento di testo che scrivi tu parte da questi valori, alcuni dei quali sorprendono:

• overflow segue lo spazio. Nel progetto di un titolo o in una pagina di parte un titolo lungo va a capo su più righe; in una testatina, in un folio o in una riga di parte del sommario un testo troppo largo per il suo spazio viene tagliato a una riga con …. Imposta overflow: 'wrap' su una testatina che può allungarsi (un indirizzo, una firma) e controlla gli avvisi designTextTruncated per i testi tagliati. Un a capo nel contenuto (un fine riga, o \n nel modello o nel valore di un attributo) inizia una nuova riga in ogni modalità; le modalità con puntini tagliano ogni riga per conto suo.
• align è 'center' e verticalAlign è 'middle'. Un elemento a larghezza automatica si adatta alla sua riga più lunga, quindi le sue righe sono centrate l’una rispetto all’altra; imposta align: 'left' per un blocco allineato a sinistra (un elemento a larghezza automatica ancorato a un altro elemento allinea da sé le righe sul lato della sua ancora, vedi sopra).
• Il carattere è EB Garamond 8 pt, nero, lineHeight 1.2, qualunque cosa usi il testo. A differenza delle altre interlinee della configurazione, il lineHeight di un testo di progetto è di solito un semplice multiplo (1.2); funziona anche una Dimension (vedi sopra).

Un elemento senza placement.size.width (o con 'auto') si dimensiona sul suo testo, ma solo entro lo spazio tra il suo punto di ancoraggio e il bordo del contenitore verso cui cresce: per un’ancora top o bottom, il doppio della distanza dal bordo più vicino. Il suo offset conta. Uno scostamento in direzione opposta a quel bordo non costa nulla: una testatina ancorata top-left con una x negativa (che sporge nel margine sinistro) non perde spazio, perché cresce verso destra. Uno scostamento verso quel bordo riduce lo spazio della stessa misura (il doppio per un’ancora top o bottom), e uno che spinge l’ancora oltre il bordo non ne lascia: un’ancora top-right la cui x è inferiore a meno la larghezza del contenitore, o un’ancora top spostata di lato di più di metà di quella larghezza. Senza spazio, una modalità con puntini non stampa nulla e 'wrap' impila un carattere per riga. Tre vie d’uscita:

• dai all’elemento una size.width fissa: le larghezze fisse non vengono mai limitate;
• ancoralo a 'page' o a 'bleed', così lo spazio è delimitato dalla pagina (o dall’abbondanza);
• ancoralo al bordo opposto del contenitore.

Il contenitore di un’intestazione va dal bordo superiore di rifilo fino al testo, e quello di un piè di pagina dal testo fino al bordo inferiore di rifilo: in un’intestazione le ancore top-* misurano dal bordo di rifilo e le ancore bottom-* dal testo, e viceversa in un piè di pagina (vedi Cornice del contenitore più sopra). Un’intestazione o un piè di pagina non sposta mai il testo e si dipinge sopra di esso, quindi un elemento spinto nell’area del testo copre il testo. Una fascia di apertura, invece, si dipinge sotto il testo; quanto spazio occupa nel flusso è descritto in Altezza riservata.

#Elementi di testo verticale

Un elemento di testo con writingMode: 'vertical-rl' si compone in verticale in uno spazio il cui testo è orizzontale: le testatine e i folio di qualsiasi libro, che restano sul foglio, e ogni progetto di una pagina orizzontale. Si impagina come un testo orizzontale nella propria cornice ruotata di un quarto di giro in senso orario, e poi riportata sulla pagina:

• Il suo riquadro resta dove lo mette la collocazione. La sua altezza è la lunghezza di una riga: la imposta size.height (o 'auto', la lunghezza del testo; 'fill', fino al bordo del contenitore), size.width imposta quante righe entrano in larghezza, e size.maxWidth limita la lunghezza di una riga.
• align colloca le righe lungo il riquadro ('left' in alto), verticalAlign attraverso di esso ('top' a destra, dove sta la prima riga), e il padding di un riquadro resta sul lato per cui è scritto.
• I caratteri si misurano e si dipingono come in una pagina verticale: gli Han diritti, un em ciascuno, la punteggiatura nella sua forma verticale, le parole latine di lato, i numeri brevi in una cella (cjk.uprightDigits). Il canvas, il PDF e l’HTML lo collocano nello stesso rettangolo.
• Con inlineMarks: true i segni di orientamento distinguono una sequenza come nel testo: 第:tcy[3.0]回 compone 3.0 in una cella, :upright[GDP] mette le lettere diritte una sotto l’altra, :sideways[…] ruota una sequenza; una riga non va mai a capo al loro interno. Un elemento orizzontale li ignora.
• Un capolettera non si compone su un elemento verticale.
• Nel flusso di una pagina verticale (un’apertura, una pagina di parte, il titolo di un riquadro) il testo scorre già verso il basso, e lì writingMode non cambia nulla.

I libri cinesi verticali mettono testatine e folio in uno di tre posti (clreq §7.2; JLREQ §2.6 per il giapponese):

Le testatine sul margine esterno, come le aggiunge la Sandbox (Intestazione › Testatine sul taglio (verticali)), qui per un testo a 10 pt (la Sandbox le imposta all’80% del corpo del testo):

{
  "page": { "pageNumbering": { "format": "trad-chinese-informal" } },
  "header": { "elements": [
    { "kind": "text", "id": "head", "content": "{chapterTitle}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "top" }, "offset": { "y": { "value": 4, "unit": "em" } } } },
    { "kind": "text", "id": "folio", "content": "{pageNumber}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "bottom" }, "offset": { "y": { "value": -5, "unit": "em" } } } }
  ] }
}

anchor.to: 'outer' (vedi Collocazione degli elementi) è il margine esterno di ogni pagina, quindi in un libro rilegato a destra (page.binding) i due elementi scendono lungo il bordo sinistro di un recto e il bordo destro di un verso. {pageNumber} si stampa nel formato di numerazione delle pagine: trad-chinese-informal dà 一百零三 a pagina 103, cjk-decimal 一〇三. Le regole di ciascuno spazio valgono ancora: pages: 'body' tiene una testatina lontana dalle aperture di capitolo. Un piccolo ornamento tra testatina e folio (una coda di pesce ︻, un filetto) è un elemento ordinario ancorato alla stessa cornice.

Nel VDT un blocco verticale porta vertical (VDTDesignTextBlock.vertical: la regione, le cifre diritte e l’asse centrale di ogni famiglia); le sue righe sono nella cornice ruotata del blocco stesso, xOffset verso il basso a partire dalla sommità del riquadro, baselineY verso sinistra a partire dal suo bordo destro. Una sequenza di una riga marcata porta tcy o orientation, come un segmento del testo.

#Elementi filetto

Gli elementi filetto disegnano una linea: orizzontale attraverso lo spazio, o verticale lungo di esso.

#Elementi riquadro

Gli elementi riquadro dipingono un rettangolo arrotondato dentro lo spazio: utile come fondale dietro il testo nelle aperture di capitolo, nelle colonne laterali o nei piè di pagina. Gli elementi riquadro si posizionano esclusivamente tramite il campo placement; non hanno la vecchia forma abbreviata piatta. Riempimento, tratto e raggio degli angoli stanno nell’oggetto annidato style (ElementBoxStyle), come nell’esempio JSON in «Collocazione degli elementi».

#Elementi immagine

Un elemento image disegna una risorsa bitmap o SVG del documento: il logo di un editore su un frontespizio, un marchio in una testatina. Si dimensiona con il suo placement.size: con uno tra width / height lasciato su 'auto' (il valore predefinito) l’altro lato segue le proporzioni dell’immagine; con entrambi impostati l’immagine viene adattata dentro il riquadro e centrata. Una risorsa mancante o che non è un’immagine non disegna nulla.

{
  kind: 'image', id: 'logo', resourceId: 'logo-publisher',
  placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: { value: 64, unit: 'mm' }, y: { value: 233, unit: 'mm' } }, size: { width: { value: 83, unit: 'mm' }, height: 'auto' } },
}

resourceId accetta i segnaposto che accetta il content di un elemento di testo, così un unico progetto può disegnare un’immagine diversa per ogni titolo. Con resourceId: '{attr.vignette}' in uno stile di titolo, # Chapter I {style="opener" vignette="log"} disegna la risorsa log e # Chapter II {style="opener" vignette="wig"} disegna wig: i capitoli condividono lo stile invece di avere un clone per ogni immagine. Un’intestazione o un piè di pagina legge gli attributi del capitolo della pagina, come fa {attr.<key>} in una testatina, e funzionano anche gli altri segnaposto ('map-{chapterNumber}'). Un id che risulta vuoto, come un titolo senza l’attributo, non disegna nulla. Da postext 1.8.

Il backend PDF incorpora la risorsa come una figura (un SVG con un master di stampa usa quello); il visualizzatore HTML la risolve tramite resourceImageUrl.

Un’immagine disegnata da un progetto è contenuto quando la sua risorsa la descrive: l’altText della risorsa, altrimenti la sua didascalia come testo semplice (un chip letto attraverso la sua etichetta, un :ref attraverso il suo text quando ne ha uno), entra nel VDT (VDTDesignImageBlock.altText), diventa l’alt del suo <img> nell’HTML e una Figure con /Alt in un PDF con tag, letta subito dopo il testo del suo progetto (la tavola di un capitolo dopo il titolo del capitolo). Un’immagine la cui risorsa non ha né l’uno né l’altra, e una marcata decorative, è decorazione: alt="" con role="presentation", e un artefatto nel PDF. L’immagine di una testatina o di un piè di pagina si ripete su ogni pagina, quindi è un elemento d’arredo qualunque cosa dica la sua risorsa: nessun altText nel VDT, alt="" con role="presentation" nell’HTML, un artefatto della pagina nel PDF.

#Collocazione degli elementi

ElementPlacement è il modello di posizionamento unificato usato da ogni tipo di elemento (testo, filetto, riquadro) dentro qualsiasi spazio di progetto: intestazione della pagina, piè di pagina, o spazio del progetto avanzato di un livello di titolo. Tre informazioni descrivono una collocazione:

interface ElementPlacement {
  /** What this element anchors to and which edge of that target. */
  anchor: {
    to: 'container' | 'page' | 'bleed' | 'outer' | `#${string}`; // container = the slot; page = trim box; bleed = trim box + bleed; outer = the outer margin (header, footer); #id = another element
    edge: AnchorEdge;
  };
  /** Distance from the anchor point. */
  offset?: { x?: Dimension; y?: Dimension };
  /** Optional fixed width / height. Width also accepts 'fill' (span the slot).
   *  `maxWidth` caps an 'auto' width (text): the element still shrink-wraps its
   *  content, so elements anchored to it stay attached, but a long text wraps or
   *  ellipsizes there — a running head can reserve room for the label hanging
   *  off it instead of squeezing that label out. */
  size?: { width?: Dimension | 'fill' | 'auto'; height?: Dimension | 'fill' | 'auto'; maxWidth?: Dimension };
}

AnchorEdge accetta:

• Bordi del contenitore (quando anchor.to è 'container', 'page' o 'bleed'): top, top-left, top-right, bottom, bottom-left, bottom-right, left, right.
• Bordi relativi a un elemento (quando anchor.to === '#someId'): right-of, left-of, below, above, align-top, align-bottom, align-left, align-right.

Ogni bordo relativo a un elemento mette un angolo dell’elemento su un angolo dell’elemento a cui si ancora, e offset lo sposta da lì:

• right-of: il suo angolo in alto a sinistra sull’angolo in alto a destra dell’elemento di riferimento (accanto, con le sommità allineate); left-of: il suo angolo in alto a destra sull’angolo in alto a sinistra dell’elemento di riferimento;
• below: il suo angolo in alto a sinistra sull’angolo in basso a sinistra dell’elemento di riferimento (sotto, con i bordi sinistri allineati); above: il suo angolo in basso a sinistra sull’angolo in alto a sinistra dell’elemento di riferimento;
• align-top e align-left: il suo angolo in alto a sinistra sull’angolo in alto a sinistra dell’elemento di riferimento. I due nomi danno la stessa collocazione: si allineano sia i bordi superiori sia quelli sinistri;
• align-bottom: il suo angolo in basso a sinistra sull’angolo in basso a sinistra dell’elemento di riferimento;
• align-right: il suo angolo in alto a destra sull’angolo in alto a destra dell’elemento di riferimento.

Un bordo relativo a un elemento usato con 'container', 'page' o 'bleed', e un bordo del contenitore usato con '#id', vengono letti come l’angolo in alto a sinistra.

anchor.to: 'page' ancora l’elemento al formato rifilato (la pagina fisica dopo il taglio) e 'bleed' al formato rifilato allargato di cutLines.bleed su ogni lato (identico al formato rifilato finché i segni di taglio sono disattivati). Entrambe le cornici diventano anche il riferimento per size: 'fill' e per il limite automatico della larghezza, così una fascia colorata può andare da bordo a bordo indipendentemente dai margini della pagina:

{ "kind": "box", "id": "band", "placement": { "anchor": { "to": "bleed", "edge": "top-left" }, "size": { "width": "fill", "height": { "value": 6, "unit": "cm" } } }, "style": { "backgroundColor": { "hex": "#1d3557", "model": "hex" } } }

Con i segni di taglio attivi, tutto ciò che un elemento dipinge oltre il riquadro dell’abbondanza viene tagliato (vedi Segni di taglio).

anchor.to: 'outer' (spazi di intestazione e piè di pagina) ancora l’elemento al margine esterno della pagina: dal bordo della gabbia del testo al bordo di rifilo sul lato opposto al dorso, e dalla testa della gabbia del testo al suo piede. Sta a destra di un recto e a sinistra di un verso in un libro rilegato a sinistra, e al contrario in uno rilegato a destra (page.binding), così un solo elemento serve entrambe le pagine di una doppia pagina: una testatina lungo il margine esterno (vedi Elementi di testo verticale). In qualsiasi altro spazio vale come 'container'. L’offset di un elemento di testo si può scrivere in em, em del suo stesso fontSize: quattro caratteri sotto la testa della gabbia del testo è { "y": { "value": 4, "unit": "em" } }.

Dentro lo spazio del progetto avanzato di un titolo, gli elementi ancorati alla pagina e all’abbondanza non aumentano l’altezza riservata al titolo a meno che non si estendano sotto il bordo superiore del titolo (una fascia in cima alla pagina sta dietro l’apertura; una fascia che arriva sotto il titolo spinge in basso il testo). Usa advancedDesign.minHeight per riservare comunque un’altezza fissa all’apertura, e reserve: false su un elemento che non deve spingere affatto il testo. Le regole complete sono in Altezza riservata.

Ogni elemento ha un id stabile (assegnato automaticamente dalla Sandbox; puoi anche impostarlo a mano). Gli elementi ancorati ad altri elementi formano un piccolo grafo di dipendenze che il motore risolve prima di misurare, così un elemento può concatenarsi a un altro senza coordinate manuali.

La vecchia forma align + marginFromBody + marginFromEdge viene analizzata in ingresso e riscritta in una collocazione al momento della risoluzione della configurazione, così le configurazioni esistenti continuano a funzionare senza modifiche.