Field

Elemento de campo vinculado a dados com formatação

Field#

Exibe o valor de um campo do registro atual. Usado dentro de DetailBand para valores dinâmicos, ou em qualquer band com bindings estáticos.

JSON#

{
  "type": "field",
  "id": "col_price",
  "x": 300,
  "y": 5,
  "width": 100,
  "height": 22,
  "binding": "price",
  "format": "currency:BRL",
  "bold": true,
  "align": "right",
  "verticalAlign": "middle",
  "padding": 4,
  "hasBorder": true,
  "borderColor": "d0d0d0",
  "borderWidth": 1,
  "borderDashed": false
}

Propriedades#

Propriedade	Tipo	Padrão	Descrição
`width`	`double`	—	Largura em pontos
`zIndex`	`int`	`0`	Ordem de empilhamento — valores maiores ficam acima (use `-1` para fundos)
`height`	`double`	`20.0`	Altura em pontos
`binding`	`string`	—	Campo do registro ou expressão
`format`	`string`	`""`	Formato de exibição
`fontSize`	`double`	`12.0`	Tamanho da fonte
`bold`	`bool`	`false`	Negrito
`italic`	`bool`	`false`	Itálico
`color`	`string`	`"000000"`	Cor hexadecimal
`align`	`string`	`"left"`	Alinhamento horizontal: `left`, `center`, `right`
`verticalAlign`	`string`	`"middle"`	Alinhamento vertical: `top`, `middle`, `bottom`
`padding`	`double`	`0.0`	Espaçamento interno
`hasBorder`	`bool`	`false`	Exibir borda
`borderColor`	`string`	`"000000"`	Cor da borda
`borderWidth`	`double`	`1.0`	Espessura da borda
`borderDashed`	`bool`	`false`	Borda tracejada
`borderDashGap`	`double`	`4.0`	Espaçamento do tracejado
`rounding`	`object`	`null`	Configuração de arredondamento
`wrap`	`bool`	`false`	Permite quebra de linha automática (multi-linha)
`valueExpression`	`string`	`null`	Expressão aplicada ao valor após o binding. Útil para converter strings antes da formatação (ex: `PARSE_NUMBER(raw_price)` )

Binding#

O binding referencia um campo do registro:

{ "binding": "product" }

Também aceita expressões:

{ "binding": "quantity * price" }

Formatos#

Format	Saída
`""`	Valor como string
`"currency:BRL"`	R$ 1.234,56
`"currency:USD"`	$1,234.56
`"date:dd/MM/yyyy"`	16/02/2026
`"datetime:dd/MM/yyyy HH:mm"`	16/02/2026 14:30
`"integer"`	42
`"number:2"`	42.50

Arredondamento#

{
  "type": "field",
  "id": "avg",
  "x": 0,
  "y": 0,
  "width": 80,
  "binding": "average_score",
  "format": "number:2",
  "rounding": {
    "precision": 2,
    "mode": "half_even"
  }
}

Modos de arredondamento#

Modo	O que faz	`2.545` (precisão 2)	`2.534` (precisão 2)
`half_even`	Quando o dígito é exatamente 5, arredonda para o par mais próximo. É o padrão bancário — evita viés estatístico.	`2.54`	`2.53`
`half_up`	Quando o dígito é 5 ou mais, arredonda para cima. É o arredondamento "escolar" que todo mundo conhece.	`2.55`	`2.53`
`half_down`	Quando o dígito é exatamente 5, arredonda para baixo. Só sobe se for maior que 5.	`2.54`	`2.53`
`up`	Sempre arredonda para cima (em direção a +∞), independente do dígito.	`2.55`	`2.54`
`down`	Sempre arredonda para baixo (em direção a −∞), independente do dígito.	`2.54`	`2.53`
`truncate`	Corta as casas decimais excedentes sem arredondar. Igual a `down` para positivos.	`2.54`	`2.53`

Se você não informar o modo, o Sulfite usa `half_even` — o mesmo padrão usado por bancos e sistemas financeiros.