Expressão junto com Formato
Formatadores de Valores Utilizando Resultado de uma Expressão
O resultado de uma expressão pode ser formatado diretamente na expressão (caso este resultado seja objeto de apresentação em algum recurso).
Supondo que o valor de $value seja igual a 10, existem dois formatadores possíveis para aplicar um formato ao resultado da expressão, conforme os exemplos de sintaxes:
Formatador |
Exemplo |
Resultado |
|---|---|---|
Pipe “|” |
value | %.2f ºC |
10.00 ºC |
Pipe “|” |
${value * 1000} | %.3f kg |
10.000 Kg |
Função “format” |
$format($value, “%.2f ºC”) |
10.00 ºC |
Função “format” |
$format($value * 1000, “%.3f Kg”) |
10.000 Kg |
Nota
Para mais informações de Formatador de Dado, acesse: Formato de apresentação de um valor.
Atenção
Utilize este recurso apenas quando o campo Formato não estiver disponível. Caso a configuração de formatação seja definida diretamente no campo Formato, ela terá prioridade sobre a formatação aplicada internamente na expressão, garantindo consistência e evitando conflitos na apresentação dos Dados.
Utilizando Vários Atributos na Mesma Expressão
É possível combinar múltiplos atributos do Conector ou do Dispositivo em uma única expressão, permitindo a criação de rótulos personalizados e informativos.
Exemplo de Sintaxe
Para exibir o nome do recurso, o valor e a unidade de medida na mesma linha:
${data.name}: ${value.toFixed(2)} ${data.unity_label}
Resultado esperado: Temperatura: 23.45 ºC
Nota
${}: É utilizado para converter o conteúdo do atributo em texto (String), permitindo a concatenação de diferentes tipos de Dados.
.toFixed(): Uma função JavaScript que fixa a quantidade de casas decimais especificada entre os parênteses.
Configuração de Formato
Para que expressões que concatenam textos e valores funcionem corretamente, o sistema precisa interpretar o resultado final como um texto (String).
Atenção
Certifique-se de que o campo Formato esteja vazio ou utilize o
formatador de string: %s.
Caso contrário, ao utilizar um formatador numérico, o sistema tentará
interpretar os atributos textuais como números, resultando na exibição
de NaN para cada atributo da expressão.