# Créer des variantes de modèle

Réutilisez un design avec différents ensembles d'étiquettes, de couleurs ou de contenu via des variantes.

Utilisez **Variantes** lorsqu'une conception nécessite plusieurs ensembles d'étiquettes, de couleurs ou de contenu alternatif. Conservez le HTML/CSS et les données d'entrée ensemble dans un seul modèle, puis choisissez la variante appropriée pour une exécution.

Par exemple, une variante peut utiliser des étiquettes vietnamiennes alors que la base conserve des étiquettes anglaises. Remplacez uniquement les valeurs qui doivent différer ; le reste continue de venir de la base.

## 1. Comprendre la base et l'héritage

**Standard** est la variante de base, marquée **BASE** dans la liste. Modifiez les HTML/CSS partagés et la structure à cet endroit.

D'autres variantes héritent de valeurs qu'elles n'ont pas remplacées. La modification d'un accessoire dans une variante stocke une valeur distincte pour cette variante. Une modification ultérieure de la même valeur de base ne remplace pas le remplacement.

Les variantes non-base ne peuvent exposer Props que pour l'édition. Revenez à la norme pour modifier la configuration partagée HTML/CSS ou structurelle.

<figure class="doc-sim data-assets-illustration" aria-label="Standard est la base · Une variante le réutilise avec les modifications sélectionnées">
<div class="sim-stage"><div class="ds-variants sim-panel"><div class="ds-head"><strong>VARIANTES</strong><span class="sim-control">＋</span></div><div class="ds-variant-row sim-focus"><b>Norme</b><span class="sim-badge">BASE</span></div><div class="ds-variant-row"><b>VI</b><small>Valeurs héritées + personnalisées</small></div></div></div>
<figcaption>Standard est la base · Une variante le réutilise avec les modifications sélectionnées</figcaption>
</figure>

## 2. Ajouter ou copier une variante

Ouvrez **Variantes** et sélectionnez **＋**. Lorsque seul Standard existe, l'application crée une variante à partir de la base. Avec de multiples variantes, le menu propose :

- **Depuis Standard** : démarrez à partir de la base sans un ensemble distinct de remplacements.
- **Dupliquer** : copie la variante sélectionnée, y compris ses remplacements.

Utilisez le contrôle de renommage ou double-cliquez sur le nom d'une variante pour la renommer. Choisissez un nom reconnaissable tel que `VI`, `EN` ou un nom de conception. Les noms doivent être uniques dans le modèle.

<figure class="doc-sim data-assets-illustration" aria-label="Variantes → ＋ → De Standard / Duplicata">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>VARIANTES</strong><span class="sim-control sim-focus">＋</span></div><div class="ds-rows"><div><span>De la norme</span><small>Commencer par la base</small></div><div><span>VI en double</span><small>Conserver les remplacements du VI</small></div></div></div></div>
<figcaption>Variantes → ＋ → De Standard / Duplicata</figcaption>
</figure>

## 3. Modifiez les différences

Sélectionnez la variante, puis sélectionnez une section dans **Structure → Props**. Modifiez les étiquettes, les couleurs ou autres props qui nécessitent leurs propres valeurs.

Les contrôles de visibilité de Structure vous permettent également de masquer une page ou une section dans la variante sélectionnée, permettant à un modèle d'omettre du contenu dans une version particulière de sa présentation.

Conservez les noms des destinataires et les listes d'éléments dans **Parameters**. Une variante sélectionne les valeurs du modèle ; Parameters fournit des données pour l'exécution.

<figure class="doc-sim data-assets-illustration" aria-label="Modifiez un accessoire avec la variante sélectionnée pour enregistrer un remplacement">
<div class="sim-stage"><div class="ds-variant-picker"><span class="sim-control">Norme</span><span class="sim-control sim-focus">VI</span></div><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>rubrique</b><span class="ds-type">Texte <svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div class="sim-prop-value"><small class="sim-label">VALEUR</small><span class="sim-input sim-focus">Tài liệu</span><span class="sim-embed">{{ props.heading }}</span></div></div><div class="ds-compare-values"><span>Norme : Documenter</span><span>VI : Tài liệu</span></div></div>
<figcaption>Modifiez un accessoire avec la variante sélectionnée pour enregistrer un remplacement</figcaption>
</figure>

## 4. Choisissez une variante pour un PDF

Dans **Run**, choisissez une version et sélectionnez le nom exact dans **Variante**. Vous pouvez réutiliser le même objet de données dans des variantes partageant les mêmes champs de saisie.

Pour les appels API, `variant` est le **nom de variante**, et non le nom de la version ou le slug du modèle. Voir la [Référence du rendu API](/docs/fr/developers/render-reference/) lors de la préparation d'une requête.

Les modifications apportées à une valeur de base atteignent les variantes qui en héritent toujours. Les valeurs remplacées par une variante restent inchangées.

<figure class="doc-sim data-assets-illustration" aria-label="Run → sélectionnez le nom de la variante pour ce PDF">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>COURIR</strong></div><div class="ds-run-fields"><div><small>VERSION</small><span class="sim-input">v1</span></div><div><small>VARIANTE</small><span class="sim-input sim-focus">VI <svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div><div class="ds-code"><code>{ "recipient": "Tembuilder" }</code></div><div class="sim-form-footer ds-pad"><span class="sim-control sim-dark">Rendu</span></div></div></div>
<figcaption>Run → sélectionnez le nom de la variante pour ce PDF</figcaption>
</figure>
