Composition

Créez des documents complexes à partir de petites pièces réutilisables. Un composant est un bloc autonome de styles et de contenu que n'importe quel document — ou un autre composant — peut insérer avec use.

use est le même verbe que vous connaissez déjà sur le canvas : une référence de composant nommée, optionnellement délimitée par data et stylisée avec style. La composition de flux ajoute des préoccupations au niveau du document (précédence de fusion de configuration) ; la composition de canvas ajoute la géométrie. Un concept, deux surfaces.

Pourquoi composer ?

• Réutilisabilité — définissez un en-tête, une page de couverture ou une annexe une fois ; use les de chaque modèle
• Séparer les responsabilités — un designer possède le composant en-tête, un analyste possède le corps
• Itérer en toute sécurité — mettez à jour un composant et chaque document qui l'utilise reprend le changement

Où use se résout

use fonctionne partout où les éléments de contenu apparaissent — le tableau de contenu de niveau supérieur, les colonnes, les cellules de tableau, les éléments de liste et le contenu d'en-tête/pied de page.

Dans cette section

• Composants — déclarez un composant réutilisable avec la clé racine "component"
• Réutilisabilité — référencez les composants avec use, délimitez les données, en cascade les styles et fusionnez la configuration
• Sections et filigranes — assemblez des documents multi-sections avec des cadres et des filigranes par section
• Imbrication et pipeline — limites de récursion, garanties de sécurité et comment la composition se résout