Saltar para o conteúdo principal

numericfield

Número

Campo numérico com casas decimais, sufixo e barra de progresso opcional.

  • Kind: component
  • Key: numericfield
  • Categoria: número
  • Envelope: mapa (um objeto JSON em config)

Campos

ChaveTipoObrigatórioOmissãoDescriçãoReferência
decimalPlacesintegernão-Casas decimais a mostrar (vazio = inteiro).-
isUniquebooleannãofalseRecusa guardar um valor já usado noutra linha.-
uniqueErrorMessagestringnão-Mensagem a mostrar quando o valor está repetido.-
uniqueWithlist de stringnão[]Outras colunas que entram na mesma chave: o repetido passa a ser o conjunto, e não esta coluna sozinha. Vazio = só esta coluna.-
suffixenumerationnão"none"Símbolo mostrado depois do valor.-
visualModeenumerationnão"valueOnly"Mostra só o valor ou uma barra de progresso com o valor.-
minValuenumbernão-Mínimo do intervalo (alimenta a barra de progresso).-
maxValuenumbernão-Máximo do intervalo (alimenta a barra de progresso).-
thousandsSeparatorbooleannãotrueAgrupa os milhares na apresentação (pt_PT). Ligado por omissão para não mudar o que as colunas já mostravam.-
prefixTextstringnão-Texto fixo mostrado antes do valor (ex.: "Ref.").-
stepperEnabledbooleannãofalseMostra os botões +/- para somar e subtrair.-
stepValuenumbernão1Incremento de cada toque nos botões +/-.-
roundingenumerationnão-Arredondamento aplicado ao guardar (vazio comporta-se como none).-
allowNegativebooleannãotruePermite escrever valores negativos.-
enforceMinMaxbooleannãofalseFaz de minValue/maxValue uma validação, e não só o intervalo da barra de progresso.-
minMaxErrorMessagestringnão-Mensagem a mostrar quando o valor sai do intervalo.-
customUnitstringnão-Unidade própria mostrada depois do valor (ex.: "kg", "m²"); só vale quando suffix é none.-
isCurrencybooleannão-Descontinuado. Legado: valia o mesmo que suffix = currency. Ainda se lê, já não se escreve.-

Exemplo JSON

{
"isUnique": false,
"uniqueWith": [],
"suffix": "none",
"visualMode": "valueOnly",
"thousandsSeparator": true,
"stepperEnabled": false,
"stepValue": 1,
"allowNegative": true,
"enforceMinMax": false
}

Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.