Sections et filigranes

La composition n'a pas besoin d'un mode spécial pour « ce composant est sa propre page ». Entrelacez les éléments de rupture existants avec vos inclusions. Un break: "section" est le puissant : il peut porter son propre pageSetup, header, footer et watermarks — donc chaque section bascule l'orientation/les marges, le cadre et la décoration de page, et un en-tête de section peut lui-même utiliser use un composant :

"content": [
  { "use": { "name": "cover-page", "data": { "title": "Q3 Review" } } },

  { "break": "section",
    "header": { "content": [ { "use": { "name": "running-head", "data": { "section": "Executive Summary" } } } ] } },
  { "use": { "name": "executive-summary" } },

  { "break": "section",
    "pageSetup": { "orientation": "landscape" },
    "header": { "content": [ { "use": { "name": "running-head", "data": { "section": "Holdings" } } } ] } },
  { "use": { "name": "holdings-table" } },

  { "break": "section", "pageSetup": { "orientation": "portrait" }, "header": { "content": [] } },
  { "use": { "name": "appendix", "style": "appendixBody" } }
]

break: "page" force une nouvelle page ; break: "section" démarre une nouvelle section. Un header/footer de section remplace le cadre du document ({ "content": [] } le supprime ; l'omission hérite du cadre doc-root — donc un pied de page avec $global.PAGE reste cohérent dans chaque section). Cela compose un rapport multi-pages — couverture portrait, corps avec un en-tête continu, un tableau de participations paysage, une annexe propre — à partir de composants indépendants.

Filigranes par section

Un break: "section" peut également porter ses propres watermarks — décoration de page-chrome indépendante du contenu de flux. Les trois états reflètent les remplacements d'en-tête/pied de page :

watermarks sur une rupture de section	Comportement
Absent	Hériter des filigranes au niveau du document
[]	Supprimer les filigranes pour cette section
Peuplé	Remplacer par les filigranes de cette section

Le content d'un filigrane est un canvas, donc il peut utiliser use un cadre de composant graphique réutilisable et le recolorer par section via use.style — un composant deco-frame, un accent différent dans chaque section :

{ "break": "section",
  "watermarks": [
    { "content": {
        "viewBox": [760, 580],
        "shapes": [ { "use": { "name": "deco-frame", "x": 0, "y": 0, "width": 760, "height": 580, "style": "frameBurgundy" } } ]
      },
      "repeat": false }
  ] }

Exemple réel : rapport composé

Un rapport d'investissement à quatre sections — chaque section un cadre différent — assemblé à partir de cinq composants (letterhead, cover-page, running-head, holdings-table, appendix) :

{
  "document": {
    "pageSetup": { "size": "A4", "orientation": "portrait", "margins": [54, 54, 54, 54] },
    "use": [ { "name": "letterhead", "override": true } ],
    "content": [
      { "use": { "name": "cover-page", "data": { "title": "Q3 2026 Portfolio Review", "date": "October 2026" } } },

      { "break": "section",
        "header": { "content": [ { "use": { "name": "running-head", "data": { "section": "Executive Summary" } } } ] } },
      { "h1": "Executive Summary", "style": "h1" },
      { "p": "Fund III returned 4.2% net in the third quarter…", "style": "body" },

      { "break": "section",
        "pageSetup": { "orientation": "landscape" },
        "header": { "content": [ { "use": { "name": "running-head", "data": { "section": "Holdings" } } } ] } },
      { "use": { "name": "holdings-table" } },

      { "break": "section", "pageSetup": { "orientation": "portrait" }, "header": { "content": [] } },
      { "use": { "name": "appendix", "style": "appendixBody" } }
    ]
  }
}

Chaque section bascule son cadre indépendamment : la couverture conserve l'en-tête de l'en-tête, les sections résumé et participations échangent un composant running-head (avec un titre par section), les participations vont paysage pour un large tableau, et l'annexe supprime l'en-tête — tandis que le pied de page numéroté par page reste cohérent tout au long (les sections remplacent uniquement ce qu'elles déclarent).

Output

Try in Playground →

Template

Data

Pour une approche orientée marketing des mêmes techniques — une couverture de marque, une carte de produit estampillée par article et une diffusion paysage — voir le tutoriel Product Lookbook. Pour les filigranes par section pilotés par un seul composant de cadre réutilisable, voir le tutoriel Certificate Suite.