Regras em JavaScript

Tipo

Referência

Para

Analista, Desenvolvedor

Vários Widgets prontos aceitam uma regra em JavaScript no lugar de um valor fixo de cor ou de formatação. A regra é o corpo de uma função assíncrona: use return e, se precisar, await. Dentro dela, this traz datefns (a biblioteca date-fns) e as variáveis de cada Widget, na tabela abaixo.

As expressões da aba Expressões são outra linguagem, em SQL: veja Linguagem de expressões. Para escrever um Widget inteiro em código, veja o Widget Svelte.

// Cor da variação do KPI
return this.variation >= 0 ? '#16a34a' : '#dc2626';

Widget	Regra	Variáveis de this
KPI	A maioria dos campos	primaryValue, secondaryValue
KPI	Cor da Variação	as anteriores e variation
KPI	Cor do Gráfico Evolução	as anteriores, categories, values
Pizza	Cor por eixo	row, result, value, index, axis
Pizza	Cor do valor	row, value, index (sempre 0)
Pizza	Fundo	result
Barras e linhas	Colorir Eixo	data, index, result, axis, name
Barras e linhas	Colorir Valor	value, index, result, axis
Gauge	Cor da dimensão	label, value, target, percent, index
Tabela	Cor da célula	value, row
Tabela	Formatação do campo	value, row, prevRow
Tabela	Formatação da linha	row, prevRow, index, rows
Tabela	Totais	value, isTotalizador (true)
Matriz	Cor da célula	value, row
Matriz composta	Estilo da célula	value, row (id, label, kind), period (key, label, isTotal), column (index, label), rowValues
ListBox	Cor e condição do item	value, row, isSelected, isAvailable, index
ListBox	Gráfico na linha	value, row, index
Previsão	Cores	result
Diagrama	Variável de expressão	variables, app

Diferenças:

• Na Matriz composta, a regra é síncrona e não tem datefns. Ela devolve true ou um objeto de estilo.
• No Diagrama, as variáveis de dados são calculadas primeiro e as de expressão depois, na ordem da lista. O objeto que uma expressão devolve é espalhado em variables, e as seguintes já o enxergam.
• Mapa, Calendário e Texto não têm regras em JavaScript.

this.datefns traz as funções do date-fns, mas não os locales: this.datefns.locale.ptBR dá erro.

Relacionado

• Opções comuns
• Widget Svelte
• Contrato do componente