Comment ajouter des listes à un modèle

Ajouter des listes dynamiques à vos modèles DocuGenerate est un excellent moyen d’organiser et d’afficher des données répétitives dans un format facile à lire. Avec DocuGenerate, vous pouvez boucler sur des tableaux dans vos données JSON pour créer des listes. Les tableaux peuvent contenir des types de données primitifs ou des objets imbriqués.

Boucler sur des types primitifs

Si vos données JSON contiennent un tableau de données primitives, comme des chaînes ou des nombres, vous pouvez créer une liste en utilisant une structure de boucle simple dans votre modèle.

Voici un exemple de syntaxe de modèle :

[#items]
- [.]
[/items]

Dans cet exemple, [#items] et [/items] indiquent le début et la fin de la boucle. Vous pouvez également utiliser [/] comme version raccourcie pour indiquer la fin de la boucle. Le [.] à l’intérieur de la boucle est l’endroit où chaque élément du tableau sera placé.

Par exemple, si vos données JSON sont les suivantes :

[{
  "items": [
    "Cars",
    "Trains"
  ]
}]

La liste générée ressemblera à ceci dans votre document :

- Cars
- Trains

Boucler sur des objets imbriqués

Vous pouvez également boucler sur un tableau d’objets imbriqués. Dans ce cas, vous pouvez accéder aux propriétés de chaque objet au sein de la boucle.

Voici un exemple de syntaxe de modèle :

[#items]
- [name]: [quantity]
[/items]

Dans cet exemple, [#items] et [/items] indiquent à nouveau le début et la fin de la boucle. Le [name]: [quantity] à l’intérieur de la boucle est l’endroit où les propriétés name et quantity de chaque élément seront placées.

Par exemple, si vos données JSON sont les suivantes :

[{
  "items": [{
    "name": "Cars",
    "quantity": "10"
  }, {
    "name": "Trains",
    "quantity": "20"
  }]
}]

La liste générée ressemblera à ceci dans votre document :

- Cars: 10
- Trains: 20

En résumé, ajouter des listes à vos modèles vous permet d’afficher efficacement des données répétitives, qu’il s’agisse de types primitifs ou d’objets imbriqués.