Referencia de Pestaña Estilo

Configure la apariencia y el comportamiento de los elementos.

La Pestaña Estilo es donde personaliza las propiedades del elemento seleccionado. Las opciones disponibles cambian según el tipo de elemento seleccionado (Texto, Imagen, Código de barras, etc.).

Propiedades de diseño comunes

Todos los elementos comparten un conjunto básico de controles de diseño:

  • X / Y: Las coordenadas del elemento en milímetros.
  • Modo de posición:
    • Absoluto: Coordenadas fijas (X, Y) relativas al origen de la página.
    • Relativo: Posiciona automáticamente el elemento debajo del elemento anterior en la lista de Capas. Útil para contenido dinámico que se expande.
  • Ancho / Alto: Las dimensiones del elemento en milímetros.
    • 0 = Auto: La mayoría de los elementos se expandirán automáticamente para ajustarse a su contenido si se establece en 0.

Visibilidad condicional

Los elementos admiten una propiedad visible (configurable vía YAML) que muestra u oculta condicionalmente un elemento según los valores de los datos. Cuando la condición se evalúa como false, el elemento se omite por completo durante la generación del PDF.

Ejemplo (en el YAML de la plantilla):

visible: "{{Status}} == 'PAID'"

Ajustes específicos por elemento

Elemento de texto

El elemento de texto admite redimensionamiento dinámico y manejo de desbordamiento.

  • Auto-dimensionado (Ancho/Alto = 0):

    • Si Ancho y Alto son 0, el cuadro de texto se expandirá automáticamente horizontal y verticalmente para ajustarse al contenido (ilimitado).

  • Dimensiones fijas:

    • Si establece un Ancho específico, el texto se ajustará dentro de ese ancho.
    • Si establece un Alto específico, puede controlar el comportamiento de desbordamiento.
    • Desbordamiento:
      • Visible: El contenido que sobresale del cuadro permanece visible.
      • Recortar: El contenido que excede las dimensiones se oculta.

  • Altura de línea: Controla el espaciado vertical entre líneas de texto. Se especifica como multiplicador (ej., 1.2 = 120% del tamaño de fuente).

Elemento de imagen

  • Origen: Al seleccionar una imagen, se copia automáticamente a la carpeta assets dentro del espacio de trabajo de su perfil.
  • Ajuste: Controla cómo la imagen se escala dentro de su cuadro (Contener, Cubrir, Rellenar).
  • Opacidad: Controla la transparencia de la imagen (0–100%).

Elemento de código de barras

Genera códigos de barras 1D estándar.

  • Tipos: CODE128, JAN, EAN13, EAN8, CODE39, UPCA, NW-7, ITF
  • JAN/EAN:
    • Admite códigos de 13 dígitos o 8 dígitos.
    • Si ingresa un número de 12 dígitos para JAN/EAN13, el motor calcula y agrega automáticamente el Dígito de Verificación.
  • CODE39:
  • NW-7 (Codabar):
    • Similar a CODE39, debe incluir los caracteres de inicio/fin (A, B, C o D) en sus datos de entrada (ej., A12345678A).
  • CODE128:
    • Cambia automáticamente entre los subconjuntos A, B y C para optimizar la longitud del código de barras. No necesita especificar el subconjunto manualmente.

Elemento de código QR

Genera códigos QR 2D.

  • Color: Establece el color de primer plano de los módulos del código QR.
  • Color de fondo: Establece el color de fondo detrás del código QR.
  • Opacidad: Controla la transparencia del código QR (0–100%).
  • Zona tranquila:
    • Por defecto, se aplica un margen estándar de 4 módulos.
    • Desmarque Usar Zona Tranquila para establecer el margen en cero (sangrado completo).

Tabla estática

Una tabla con un número fijo de filas y columnas, editable manualmente.

  • Columnas: Defina el número de columnas y sus encabezados.
  • Filas: Agregue o elimine filas manualmente.
  • Tipos de contenido: Las celdas pueden contener Texto, Código de barras o Código QR.
  • Filas mínimas:
    • Asegura que la tabla muestre siempre al menos N filas.
    • Si los datos manuales son menos de N, se agregan filas vacías de relleno.

Tabla de grupo (Datos de transacción)

Una tabla dinámica que itera sobre datos de transacción asociados con una Clave de Agrupación.

  • Clave de agrupación: Define qué registros de transacción se agrupan para esta tabla.
  • Tipos de contenido: Admite Texto, Código de barras y Código QR en las celdas.
  • Filas mínimas:
    • Asegura que la tabla muestre siempre al menos N filas, agregando líneas vacías si los datos de transacción son menos de N.
    • Útil para mantener una altura de diseño consistente incluso con datos variables.
  • Paginación:
    • Si el número de filas excede la altura de la página (definida por los márgenes), la tabla se divide automáticamente y continúa en la siguiente página.
  • Totales y pies de página:
    • La Tabla de Grupo no tiene una fila de pie de página integrada para totales.
    • Solución: Cree un elemento separado de Texto o Tabla Estática para sus totales y colóquelo debajo de la Tabla de Grupo en la lista de Capas. Establezca su Modo de Posición en Relativo.
    • Control de espacio: En modo Relativo, la propiedad Y le permite establecer el espaciado vertical (en mm) entre la parte inferior de la Tabla de Grupo y la parte superior de este elemento de pie de página.