Table#

Renderiza uma tabela completa com header, linhas de dados e estilos configuráveis. Alternativa ao uso de bands detail quando se quer uma tabela self-contained dentro de qualquer band.

JSON#

{
  "type": "table",
  "id": "items_table",
  "x": 30,
  "y": 10,
  "width": 500,
  "dataSourceId": "items",
  "showHeader": true,
  "alternateRowColors": true,
  "columns": [
    { "id": "col1", "header": "Produto", "binding": "product", "width": 250 },
    { "id": "col2", "header": "Qtd", "binding": "quantity", "width": 80, "format": "integer", "align": "right" },
    { "id": "col3", "header": "Preço", "binding": "price", "width": 120, "format": "currency:BRL", "align": "right" }
  ]
}

Propriedades#

TableColumn#

Editor de colunas no Studio#

Ao selecionar um TableElement no canvas, o botão Editar Tabela abre o TableEditorDialog:

• Busca de colunas — campo de filtro por header ou binding
• Seções colápsáveis por coluna — padrão expandido
• Aplicar estilo a todas — propaga fontSize, align e wrapText de uma coluna para todas as demais com um clique

Modo Pivot#

Quando a propriedade pivot está presente no elemento table, ele entra no modo pivot: os dados planos (um registro por célula) são agrupados em uma matriz dinâmica linhas × colunas em tempo de renderização. As columns normais são ignoradas — os cabeçalhos são gerados a partir dos valores distintos de columnField.

{
  "type": "table",
  "id": "pivot_icms",
  "x": 0, "y": 10, "width": 782, "height": 0,
  "dataSourceId": "arrecadacao",
  "headerFill": "2e7d32",
  "headerTextColor": "ffffff",
  "columns": [],
  "pivot": {
    "rowFields": ["estado"],
    "columnField": "mes",
    "valueField": "icms",
    "verb": "SUM",
    "showRowTotals": true,
    "showColumnTotals": true,
    "totalLabel": "Total",
    "columnSort": "alpha",
    "totalsFill": "1b5e20",
    "totalsTextColor": "ffffff",
    "totalsBold": true
  }
}

Use height: 0 na band que contém a tabela pivot para que o PDF calcule a altura automaticamente.

TablePivotConfig#

TableColumnOverride#

Overrides de estilo para uma coluna específica do pivot. Cada entrada em columnOverrides é um objeto com as seguintes propriedades:

Exemplo:

"columnOverrides": {
  "Total": { "bold": true, "headerColor": "1a237e", "align": "right" },
  "Dez":   { "headerColor": "b71c1c", "format": "#,##0.00" }
}

Estilos Condicionais de Célula#

Aplique estilos dinâmicos a células de tabela com base nos dados da linha usand conditionalStyles na TableColumn (tabela regular) ou em TablePivotConfig.cellConditionalStyles / TableColumnOverride.conditionalStyles (tabela pivot).

A semântica é first-match-wins: a primeira regra cuja expressão when avaliar como truthy define o estilo; as demais são ignoradas.

CellStyleRule#

Valores truthy na expressão when: true (bool), número ≠ 0, string não vazia.

Contexto de avaliação: além dos campos da linha, a variável especial value contém o valor bruto da célula antes da formatação.

"conditionalStyles": [
  { "when": "value < 0",          "textColor": "e53935" },
  { "when": "value > 1000000",    "fill": "e8f5e9", "bold": true },
  { "when": "tier == 'VIP'",      "textColor": "1565c0", "bold": true },
  { "when": "value == 'negativo'","fill": "fff59d" }
]

Diferença entre Table e Detail Band#

• Detail Band: cada registro gera uma band posicionada (mais controle visual)
• Table: tabela pronta com header e linhas, posicionada como um bloco único

Use Table para tabelas de dados. Use Detail Band quando precisar de layout livre por registro.