Datos y variantes
Docs/Datos y variantes

Crear variantes de plantilla

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

3 minutos de lectura4 secciones
En esta página

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.

VARIANTES+
EstándarBASE
VIHeredado + valores personalizados
El estándar es la base · Una variante la reutiliza con cambios seleccionados

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.

VARIANTES+
Desde estándarEmpezar desde la base
Duplicado VIMantener las anulaciones de VI
Variantes → + → De Estándar / Duplicado

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.

EstándarVI
títuloTexto
VALORTài liệu{{ props.heading }}
Estándar: DocumentoVI: Tài liệu
Edite un accesorio con la variante seleccionada para guardar una anulación

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 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.

CORRER
VERSIÓNv1
VARIANTEVI
{ "recipient": "Tembuilder" }
Run → seleccione el nombre de la variante para este PDF

Buscar documentación