Scheda Stile

Configurare l'aspetto e il comportamento degli elementi.

La scheda Style (Stile) è dove si personalizzano le proprietà dell'elemento attualmente selezionato. Le opzioni disponibili cambiano in base al tipo di elemento selezionato (Testo, Immagine, Codice a barre, ecc.).

Proprietà di layout comuni

Tutti gli elementi condividono un set base di controlli di layout:

  • X / Y: Le coordinate dell'elemento in millimetri.
  • Position Mode (modalità posizione):
    • Absolute (assoluto): Coordinate fisse (X, Y) relative all'origine della pagina.
    • Relative (relativo): Posiziona automaticamente l'elemento sotto l'elemento precedente nell'elenco dei livelli. Utile per contenuti dinamici che si espandono.
  • Width / Height: Le dimensioni dell'elemento in millimetri.
    • 0 = Auto: La maggior parte degli elementi si espande automaticamente per adattarsi al contenuto se impostato a 0.

Visibilità condizionale

Gli elementi supportano una proprietà visible (configurabile tramite YAML) che mostra o nasconde condizionalmente un elemento in base ai valori dei dati. Quando la condizione restituisce false, l'elemento viene completamente saltato durante la generazione PDF.

Esempio (nel YAML del modello):

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

Impostazioni specifiche per elemento

Elemento Testo

L'elemento Testo supporta il ridimensionamento dinamico e la gestione dell'overflow.

  • Dimensionamento automatico (Width/Height = 0):

    • Se Width e Height sono 0, il campo di testo si espande automaticamente in orizzontale e verticale per adattarsi al contenuto (illimitato).

  • Dimensioni fisse:

    • Impostando una Width specifica, il testo andrà a capo entro quella larghezza.
    • Impostando una Height specifica, è possibile controllare il comportamento di overflow.
    • Overflow:
      • Visible: Il contenuto che fuoriesce dal riquadro resta visibile.
      • Clip: Il contenuto che supera le dimensioni viene nascosto.

  • Line Height (altezza riga): Controlla la spaziatura verticale tra le righe di testo. Specificato come moltiplicatore (es. 1.2 = 120% della dimensione del font).

Elemento Immagine

  • Source: Quando si seleziona un'immagine, questa viene automaticamente copiata nella cartella assets del workspace del profilo.
  • Fit: Controlla come l'immagine si scala all'interno del riquadro (Contain, Cover, Fill).
  • Opacity (opacità): Controlla la trasparenza dell'immagine (0–100%).

Elemento Codice a barre

Genera codici a barre 1D standard.

  • Tipi: CODE128, JAN, EAN13, EAN8, CODE39, UPCA, NW-7, ITF
  • JAN/EAN:
    • Supporta codici a 13 o 8 cifre.
    • Inserendo un numero di 12 cifre per JAN/EAN13, il motore calcola e aggiunge automaticamente la cifra di controllo.
  • CODE39:
  • NW-7 (Codabar):
    • Come per CODE39, è necessario includere i caratteri di start/stop (A, B, C o D) nei dati di input (es. A12345678A).
  • CODE128:
    • Alterna automaticamente tra i sottoinsiemi A, B e C per ottimizzare la lunghezza del codice a barre. Non è necessario specificare manualmente il sottoinsieme.

Elemento Codice QR

Genera codici QR 2D.

  • Color: Imposta il colore di primo piano dei moduli QR.
  • Back Color: Imposta il colore di sfondo dietro il codice QR.
  • Opacity (opacità): Controlla la trasparenza del codice QR (0–100%).
  • Quiet Zone:
    • Per impostazione predefinita, viene applicato un margine standard di 4 moduli.
    • Deselezionare Use Quiet Zone per impostare il margine a zero (senza bordo).

Tabella statica

Una tabella con un numero fisso di righe e colonne, modificabile manualmente.

  • Columns: Definisce il numero di colonne e le intestazioni.
  • Rows: Aggiunge o rimuove righe manualmente.
  • Content Types: Le celle possono contenere Text, Barcode o QR Code.
  • Minimum Rows:
    • Garantisce che la tabella mostri sempre almeno N righe.
    • Se i dati manuali sono inferiori a N, vengono aggiunte righe segnaposto vuote per riempire lo spazio.

Tabella di dettaglio (Group Table)

Una tabella dinamica che itera sui dati transazionali associati a un Group Key.

  • Group Key: Definisce quali record transazionali vengono raggruppati per questa tabella.
  • Content Types: Supporta Text, Barcode e QR Code nelle celle.
  • Minimum Rows:
    • Garantisce che la tabella mostri sempre almeno N righe, aggiungendo righe vuote se i dati transazionali sono inferiori a N.
    • Utile per mantenere un'altezza di layout costante anche con dati variabili.
  • Paginazione:
    • Se il numero di righe supera l'altezza della pagina (definita dai margini), la tabella si interrompe automaticamente e continua nella pagina successiva.
  • Totali e piè di pagina:
    • La tabella di dettaglio non ha una riga piè di pagina integrata per i totali.
    • Soluzione: Creare un elemento Text o Static Table separato per i totali e posizionarlo sotto la tabella di dettaglio nell'elenco dei livelli. Impostare la modalità posizione su Relative.
    • Controllo spaziatura: In modalità Relative, la proprietà Y consente di impostare la spaziatura verticale (in mm) tra la fine della tabella di dettaglio e l'inizio dell'elemento piè di pagina.