Definindo o formato numérico de um campo editável

Saiba como criar um campo editável pelo usuário que mantém um formato especificado.

Se um administrador quiser exibir um campo numérico para um usuário final em um determinado formato, mas também permitir que os usuários editem esse campo, uma solução será definir o tipo de exibição do campo como um número formatado.

Atualmente, a única maneira de usar a formatação numérica em campos editáveis é definir este tipo de exibição de componente no próprio CSV de layout. Uma vez exportado e aberto com seu editor CSV preferencial (excel neste exemplo), você pode adicionar o seguinte ao seu campoʼs linha:

• FormatedNumber Para a coluna F. (Tipo de exibição de componente)
• formato: Para a coluna I. (valor)

Depois que isso for salvo, você pode arrastar este CSV de layout para a janela do editor de layout e ele substituirá o layout atual. Você pode verificar se essa mudança foi feita na guia Editar informações do campo do editor de layout, onde o tipo de exibição ficará em branco:

E na guia Organizar layout, onde as propriedades do campo do campo numérico terão o formato inserido na seção Valor bruto:

Depois de salvar e implantar o Blueprint, você deve obter um resultado semelhante à captura de tela na parte superior desta página. Outras opções de formatação estão listadas abaixo:

{
	"format": {
		"type": "currency" | "percent" | "unit" | "decimal",
		"precision": 2, // Any positive integer
		"unit": Unit, // List of standard JS units, i18n supported
		"customUnit": string, // Any unit to append to the end of the value, untranslated
		"displayZeroPriceAs": string,
		"displayNullPriceAs": string
	}
}

A formatação percentual multiplica automaticamente por 100. Portanto, um valor de campo de 0,1 será exibido como 10% .

Você pode mostrar apenas um sinal de porcentagem sem matemática usando tipo: unidade, unidade: percentual .

Para exibir uma lista de unidades compatíveis, consulte ECMAScript ®2026 Especificação da API de internacionalização .

Você pode usar customUnit para unidades que não estão nesta lista.