Sauts

Insérez un saut pour contrôler où le contenu se coule ensuite. L'élément de saut est placé directement dans le tableau de contenu aux côtés d'autres éléments.

Types de sauts

Valeur	Description
"page"	Commencer le contenu sur une nouvelle page
"section"	Commencer une nouvelle section au niveau de la page, optionnellement avec sa propre configuration de page, en-tête ou remplacements de pied de page
"line"	Insérer un saut de ligne dans le contenu coulant (équivalent à une ligne vide)

Saut de page

Forcer le contenu suivant sur une nouvelle page.

{ "break": "page" }

Exemple : document multi-chapitres

{
  "document": {
    "styles": {
      "title": { "fontSize": 18, "fontWeight": "bold" },
      "body": { "fontSize": 10 }
    },
    "content": [
      { "p": "Chapitre 1 : Introduction", "style": "title" },
      { "p": "Ce contenu apparaît sur la première page.", "style": "body" },

      { "break": "page" },

      { "p": "Chapitre 2 : Analyse", "style": "title" },
      { "p": "Ce contenu commence sur une nouvelle page.", "style": "body" },

      { "break": "page" },

      { "p": "Chapitre 3 : Conclusion", "style": "title" },
      { "p": "Ce contenu commence sur une autre nouvelle page.", "style": "body" }
    ]
  }
}

Utilisez les sauts de page pour :

• Chapitres — commencer chaque chapitre sur une page vierge
• Pages de couverture — séparer la couverture du corps
• Appendices — isoler le contenu supplémentaire du corps principal
• Avant les grands tableaux — assurer qu'un tableau commence au sommet d'une page plutôt que de se diviser maladroitement

Saut de section

Partitionnez le document en sections au niveau de la page. Chaque section peut porter sa propre pageSetup en ligne (taille, orientation, marges, arrière-plan, bordures), header, et footer — tous sur le saut lui-même. Utilisez-le pour les pages de couverture, les appendices en paysage, ou tout document qui a besoin d'une configuration de page différente à mi-chemin.

{ "break": "section",
  "pageSetup": { "size": "LETTER", "orientation": "landscape" }
}

Les propriétés de la pageSetup en ligne remplacent la pageSetup racine du document pour chaque page de cette section. Chaque propriété est indépendante : omettez une clé pour l'hériter de la racine. Omettez entièrement le champ pageSetup pour hériter de tout.

Pour la mécanique complète — y compris les remplacements d'en-tête/pied de page par section — voir Configuration de page.

Exemple : appendice en paysage

{
  "document": {
    "pageSetup": {
      "size": "LETTER",
      "orientation": "portrait"
    },
    "styles": {},
    "content": [
      { "h1": "Rapport principal" },
      { "p": "Corps du rapport orienté en portrait." },
      {
        "break": "section",
        "pageSetup": {
          "size": "LETTER",
          "orientation": "landscape",
          "margins": [40, 40, 40, 40]
        }
      },
      { "h1": "Appendice A — Tableaux larges" },
      { "p": "Cette section se rend en paysage avec des marges plus larges." }
    ]
  }
}

Un saut de section démarre une nouvelle page quand la configuration de page effective de la section diffère de celle de la section précédente. Si la configuration est identique, le moteur de rendu peut continuer sur la même page.

Saut de ligne

Insérez l'espacement vertical entre les éléments de contenu sans démarrer une nouvelle page ou section.

{ "break": "line" }

Exemple : espacement entre les blocs

{
  "document": {
    "content": [
      { "p": "Conditions générales" },
      { "p": "Veuillez examiner attentivement ce qui suit." },

      { "break": "line" },

      { "p": "1. L'accord est contraignant lors de la signature." },
      { "p": "2. La résiliation nécessite un avis écrit de 30 jours." },

      { "break": "line" },

      { "p": "Contactez legal@acme.com pour toute question." }
    ]
  }
}

Remarques

• Un saut page à la fin du tableau de contenu ajoute une page vierge finale. Évitez-le sauf intention.
• Le contenu qui dépasse naturellement la hauteur de la page s'enroule automatiquement — vous n'avez pas besoin de sauts de page pour le débordement. Utilisez-les uniquement pour les divisions structurelles intentionnelles.
• Les sauts section avancent vers une nouvelle page quand la configuration de page de la section diffère de celle de la section précédente ; sinon le moteur de rendu peut continuer sur la même page.
• Les sauts line n'avancent jamais vers une nouvelle page — ils sont équivalents à une ligne vide.
• Un saut section n'est pas lié à l'élément columns. columns est un bloc de mise en page multi-colonne en ligne ; break: section est une partition au niveau de la page avec sa propre configuration de page.