Variáveis e Modificadores

1. Como Utilizar Variáveis

Em contextos aplicáveis, os usuários podem utilizar variáveis usando a seguinte sintaxe:

{{ data.reference_do_campo }}

A referência do campo pode ser consultada na tela onde os campos são criados e sempre segue o formato snake_case baseado no nome do campo.

Exemplo

Se um usuário criou um campo chamado "Data de vencimento", a referência poderá ser: {{ data.data_de_vencimento }}

2. Estrutura das Variáveis Disponíveis para Itens

Os usuários podem utilizar as seguintes variáveis quando existe um contexto de item:

Dentro de data, estarão os campos personalizados, como:

• {{ data.campo_01 }}
• {{ data.campo_02 }}

3. Aplicação de Modificadores (Mods)

Os usuários podem modificar as variáveis usando o sufixo especial __mod[] no final da variável:

{{ data.campo_01__mod[format?type=date&dt_style=short] }}

Explicação da Sintaxe

1. O sufixo __mod[] indica que uma modificação será aplicada.
2. Dentro dos colchetes [], especificam-se as modificações e parâmetros no formato query string.

Modificadores Disponíveis

• format → Para formatar diversos tipos de dados (ex: datas).
• transformText → Para transformar textos aplicando diferentes funções.

4. Como Usar o Modificador format

O modificador format permite personalizar a exibição dos dados de acordo com o tipo de informação (números, moedas, datas).

4.1. Estrutura da Sintaxe

A estrutura básica utiliza parâmetros semelhantes aos de uma URL:

{{ variavel__mod[format?parametro1=valor1&parametro2=valor2] }}

• format → Define o tipo de modificador.
• ? → Inicia a lista de parâmetros.
• parametro=valor → Define um parâmetro e seu valor correspondente.
• & → Separa múltiplos parâmetros.

Exemplo Prático: Formatação de Moeda

{{ data.valor_total__mod[format?type=number&n_style=currency&n_currency=USD] }}

• type=number → Indica que o valor é um número.
• n_style=currency → Formata o valor como moeda.
• n_currency=USD → Define a moeda como Dólar Americano.
• Saída esperada: $10.00

4.2 Lista de Parâmetros e Como Usá-los

📌 Parâmetros Gerais

📌 Parâmetros para type=date (Datas)

Exemplos Práticos

• Data Completa:{{ data.custom_due_date__mod[format?type=date&d_style=full] }}
  🔹 Saída: terça-feira, 8 de março de 2025
• Data e Hora Médias:{{ data.server_time__mod[format?type=date&d_style=medium&dt_style=short] }}
  🔹 Saída: 8 de mar. de 2025 13:30
• Data Curta com Hora Curta:{{ data.server_time__mod[format?type=date&d_style=short&dt_style=short] }} Ss 🔹 Saída: 08/03/2025, 13:30

📌 Parâmetros para type=number (Números e Moedas)

Exemplos Práticos: Números e Moedas

Abaixo estão exemplos práticos de como aplicar os parâmetros de formatação para números e multiplicadores:

• Formatação de Moeda (Dólar):{{ data.preco__mod[format?type=number&n_style=currency&n_currency=USD] }}
  🔹 Saída esperada: $10.00
• Formatação de Percentual com Casas Decimais:{{ data.taxa__mod[format?type=number&n_style=percent&n_minimumFractionDigits=2] }}
  🔹 Se o valor for 0.075, a saída será: 7,50%
• Uso de Multiplicador (Conversão de Unidades):{{ data.tempo__mod[format?type=number&n_multiplier=60] }}
  🔹 Se o valor for 2, a saída será: 120 (ex: converte horas para minutos)

  ---

📌 Parâmetros para type=text (Texto)

Exemplo:

{{ data.descricao__mod[format?type=text&t_length=20&t_suffix="..."] }}

🔹 Se o texto for "Este é um exemplo de texto muito longo", a saída será: "Este é um exemplo..."

📌 Parâmetros para type=list (Listas)

📢 value_path é obrigatório para type=list, pois ele determina de onde os valores serão extraídos dentro dos itens da lista.

Exemplo

{{ data.produtos__mod[format?type=list&value_path=name&l_separator=", "] }}

Se a lista contiver:

[
  { "name": "Product A" },
  { "name": "Product B" },
  { "name": "Product C" }
]

🔹 Saída esperada:Produto A, Produto B, Produto C

📌 Parâmetros para type=object (Objetos JSON)

Exemplo

{{ data.detalhes__mod[format?type=object] }}

◆ Se o objeto contiver:

{
  "nome": "João",
  "idade": 30
}

🔹 Saída esperada:{"nome":"João","idade":30}

5. Como Usar o Modificador transformText

O modificador transformText permite realizar alterações no formato do texto. Ele aceita uma lista de opções dentro do parâmetro options.

Opções Disponíveis para transformText

Exemplos de Uso do transformText

• Converter para maiúsculas

  {{ data.nome_cliente__mod[transformText?options=uppercase] }}
  

• Aplicar múltiplas transformações
  (Remove espaços extras e capitaliza a primeira letra)

  {{ data.nome_cliente__mod[transformText?options=trim&options=capitalize] }}
  

• Remover acentos e converter para kebab-case

  {{ data.titulo__mod[transformText?options=deburr&options=kebabCase] }}
  

• Gerar um slug a partir de um título

  {{ data.titulo__mod[transformText?options=slugify] }}