# Crear variantes de plantilla

Reutiliza un diseño con diferentes conjuntos de etiquetas, colores o contenido mediante variantes.

Utilice **Variantes** cuando un diseño necesite varios conjuntos de etiquetas, colores o contenido alternativo. Mantenga el HTML/CSS y los datos de entrada juntos en una plantilla, luego elija la variante adecuada para una ejecución.

Por ejemplo, una variante puede usar etiquetas en vietnamita mientras que la base mantiene etiquetas en inglés. Anule sólo los valores que deben diferir; el resto sigue viniendo de la base.

## 1. Comprender la base y la herencia

**Estándar** es la variante básica, marcada como **BASE** en la lista. Edite HTML/CSS compartido y estructure allí.

Otras variantes heredan valores que no han anulado. La edición de un accesorio en una variante almacena un valor separado para esa variante. Un cambio posterior al mismo valor base no reemplaza la anulación.

Las variantes no básicas solo pueden exponer Props para edición. Regrese a Estándar para cambiar HTML/CSS compartido o la configuración estructural.

<figure class="doc-sim data-assets-illustration" aria-label="El estándar es la base · Una variante la reutiliza con cambios seleccionados">
<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>Estándar</b><span class="sim-badge">BASE</span></div><div class="ds-variant-row"><b>VI</b><small>Heredado + valores personalizados</small></div></div></div>
<figcaption>El estándar es la base · Una variante la reutiliza con cambios seleccionados</figcaption>
</figure>

## 2. Agregar o copiar una variante

Abra **Variantes** y seleccione **+**. Cuando solo existe Estándar, la aplicación crea una variante desde la base. Con múltiples variantes, el menú ofrece:

- **Desde Estándar**: comience desde la base sin un conjunto separado de anulaciones.
- **Duplicar**: copia la variante seleccionada, incluidas sus anulaciones.

Utilice el control de cambio de nombre o haga doble clic en el nombre de una variante para cambiarle el nombre. Elija un nombre reconocible como `VI`, `EN` o un nombre de diseño. Los nombres deben ser únicos dentro de la plantilla.

<figure class="doc-sim data-assets-illustration" aria-label="Variantes → ＋ → De Estándar / Duplicado">
<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>Desde estándar</span><small>Empezar desde la base</small></div><div><span>Duplicado VI</span><small>Mantener las anulaciones de VI</small></div></div></div></div>
<figcaption>Variantes → ＋ → De Estándar / Duplicado</figcaption>
</figure>

## 3. Edita las diferencias

Seleccione la variante, luego seleccione una sección en **Structure → Props**. Cambie las etiquetas, colores u otros props que necesiten sus propios valores.

Los controles de visibilidad de Structure también le permiten ocultar una página o sección en la variante seleccionada, permitiendo que una plantilla omita contenido en una versión particular de su presentación.

Mantenga los nombres de los destinatarios y las listas de elementos en **Parameters**. Una variante selecciona valores de plantilla; Parameters proporciona datos para la ejecución.

<figure class="doc-sim data-assets-illustration" aria-label="Edite un accesorio con la variante seleccionada para guardar una anulación">
<div class="sim-stage"><div class="ds-variant-picker"><span class="sim-control">Estándar</span><span class="sim-control sim-focus">VI</span></div><div class="sim-prop-card ds-field"><div class="sim-prop-name"><b>título</b><span class="ds-type">Texto <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">VALOR</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>Estándar: Documento</span><span>VI: Tài liệu</span></div></div>
<figcaption>Edite un accesorio con la variante seleccionada para guardar una anulación</figcaption>
</figure>

## 4. Elija una variante para un PDF

En **Run**, elige una versión y selecciona el nombre exacto en **Variante**. Puede reutilizar el mismo objeto de datos en variantes que comparten los mismos campos de entrada.

Para las llamadas API, `variant` es el **nombre de la variante**, no el nombre de la versión ni el slug de la plantilla. Consulte la [referencia de renderizado API](/docs/es/developers/render-reference/) al preparar una solicitud.

Los cambios en un valor base alcanzan a las variantes que aún lo heredan. Los valores anulados por una variante permanecen sin cambios.

<figure class="doc-sim data-assets-illustration" aria-label="Run → seleccione el nombre de la variante para este PDF">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>CORRER</strong></div><div class="ds-run-fields"><div><small>VERSIÓN</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">Renderizar</span></div></div></div>
<figcaption>Run → seleccione el nombre de la variante para este PDF</figcaption>
</figure>