Aba Estilo

A aba Style é onde você personaliza as propriedades do elemento atualmente selecionado. As opções disponíveis mudam de acordo com o tipo do elemento selecionado (Texto, Imagem, Código de barras, etc.).

Propriedades comuns de layout

Todos os elementos compartilham um conjunto básico de controles de layout:

• X / Y: As coordenadas do elemento em milímetros.
• Position Mode:
  • Absolute: Coordenadas fixas (X, Y) relativas à origem da página.
  • Relative: Posiciona automaticamente o elemento abaixo do elemento anterior na lista de camadas. Útil para conteúdo dinâmico que se expande.
• Width / Height: As dimensões do elemento em milímetros.
  • 0 = Auto: A maioria dos elementos se expandirá automaticamente para caber no conteúdo quando definido como 0.

Visibilidade condicional

Os elementos suportam uma propriedade visible (configurável via YAML) que exibe ou oculta condicionalmente um elemento com base nos valores dos dados. Quando a condição avalia como false, o elemento é completamente ignorado durante a geração do PDF.

Exemplo (no YAML do modelo):

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

Configurações específicas por elemento

Elemento Text

O elemento de texto suporta redimensionamento dinâmico e tratamento de overflow.

• Tamanho automático (Width/Height = 0):

  • Se Width e Height forem 0, a caixa de texto se expande automaticamente horizontal e verticalmente para caber no conteúdo (ilimitado).

• Dimensões fixas:

  • Se você definir uma Width específica, o texto quebrará dentro dessa largura.
  • Se você definir uma Height específica, pode controlar o comportamento de overflow.
  • Overflow:
    • Visible: O conteúdo que ultrapassa a caixa permanece visível.
    • Clip: O conteúdo que excede as dimensões é ocultado.

• Line Height: Controla o espaçamento vertical entre linhas de texto. Especificado como multiplicador (ex.: 1.2 = 120% do tamanho da fonte).

Elemento Image

• Source: Ao selecionar uma imagem, ela é automaticamente copiada para a pasta assets no workspace do perfil.
• Fit: Controla como a imagem é dimensionada dentro da caixa (Contain, Cover, Fill).
• Opacity: Controla a transparência da imagem (0–100%).

Elemento Barcode

Gera códigos de barras 1D padrão.

• Tipos: CODE128, JAN, EAN13, EAN8, CODE39, UPCA, NW-7, ITF
• JAN/EAN:
  • Suporta códigos de 13 ou 8 dígitos.
  • Se você inserir um número de 12 dígitos para JAN/EAN13, o motor calcula e adiciona automaticamente o Dígito Verificador.
• CODE39:

  Caracteres de início/parada

  O motor adiciona automaticamente os caracteres padrão de início/parada (*) ao código de barras. Você não deve incluí-los nos seus dados de entrada — forneça apenas o conteúdo (ex.: 123).

• NW-7 (Codabar):
  • Semelhante ao CODE39, você deve incluir os caracteres de início/parada (A, B, C ou D) nos dados de entrada (ex.: A12345678A).
• CODE128:
  • Alterna automaticamente entre os Subsets A, B e C para otimizar o comprimento do código de barras. Não é necessário especificar o subset manualmente.

Elemento QR Code

Gera QR Codes 2D.

• Color: Define a cor do primeiro plano dos módulos do QR Code.
• Back Color: Define a cor de fundo do QR Code.
• Opacity: Controla a transparência do QR Code (0–100%).
• Quiet Zone:
  • Por padrão, uma margem padrão de 4 módulos é aplicada.
  • Desmarque Use Quiet Zone para definir a margem como zero (sangria total).

Static Table

Uma tabela com número fixo de linhas e colunas, editável manualmente.

• Columns: Defina o número de colunas e seus cabeçalhos.
• Rows: Adicione ou remova linhas manualmente.
• Content Types: Células podem conter Text, Barcode ou QR Code.
• Minimum Rows:
  • Garante que a tabela sempre exiba pelo menos N linhas.
  • Se os dados manuais tiverem menos de N linhas, linhas de espaço reservado vazias são adicionadas.

Group Table (Dados de transação)

Uma tabela dinâmica que itera sobre dados de transação associados a uma Group Key.

• Group Key: Define quais registros de transação são agrupados para esta tabela.
• Content Types: Suporta Text, Barcode e QR Code nas células.
• Minimum Rows:
  • Garante que a tabela sempre exiba pelo menos N linhas, adicionando linhas vazias se os dados tiverem menos de N.
  • Útil para manter a altura do layout consistente mesmo com dados variáveis.
• Paginação:
  • Se o número de linhas exceder a altura da página (definida pelas margens), a tabela quebra automaticamente e continua na próxima página.
• Totais e rodapés:
  • A Group Table não possui uma linha de rodapé integrada para totais.
  • Solução: Crie um elemento Text ou Static Table separado para seus totais e posicione-o abaixo da Group Table na lista de camadas. Defina o modo de posição como Relative.
  • Controle de espaço: No modo Relative, a propriedade Y permite definir o espaçamento vertical (em mm) entre o final da Group Table e o topo deste elemento de rodapé.