> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Fórmulas do quiz: calcule resultados a partir das respostas

> Crie fórmulas nos funis de quiz do LanderLab para calcular valores a partir das respostas do quiz e exibir resultados personalizados em qualquer etapa. Dê nome, reutilize e teste cada fórmula com valores em tempo real.

As fórmulas permitem transformar as respostas do quiz em um valor calculado. Você combina uma ou mais respostas com operações matemáticas e depois exibe o resultado em qualquer etapa ou o usa nas suas regras. Um uso comum é uma estimativa em tempo real, como um valor de economia ou um total acumulado, que se atualiza de acordo com o que cada visitante seleciona.

## Onde encontrar as fórmulas

Abra seu quiz no editor e clique no ícone **Formulas** na barra lateral esquerda. O painel começa vazio. Clique em **Add Formula** para abrir o editor de fórmulas.

<img src="https://mintcdn.com/landerlab-babdc23f/r7Zh2MPRSmzJr3wD/images/add-formula.png?fit=max&auto=format&n=r7Zh2MPRSmzJr3wD&q=85&s=7b6466d980b595166cd7d4921907a7ec" alt="Adicionar fórmula" width="1920" height="958" data-path="images/add-formula.png" />

## Criar uma fórmula

O editor de fórmulas tem três partes: as configurações gerais, a expressão e um teste em tempo real.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/XJDaZ6ILyLkk7ClU/images/naming.png?fit=max&auto=format&n=XJDaZ6ILyLkk7ClU&q=85&s=a2251afaef06fed97af8f3add2bf4eae" alt="Nomeação" width="1920" height="956" data-path="images/naming.png" />
</Frame>

### Nome (Name)

Dê à fórmula um nome claro. É pelo nome que você vai referenciar a fórmula depois, então um nome descritivo facilita a reutilização em várias etapas. Por exemplo, chame uma fórmula de `Estimated Savings` em vez de deixá-la como `Formula 1`.

### Casas decimais (Decimals)

Escolha quantas casas decimais o resultado vai exibir. Use `0` para números inteiros, como um total em dólares, ou `2` para valores que precisam de centavos.

### Valor alternativo (Fallback)

Defina um valor a ser exibido quando a fórmula não conseguir retornar um resultado válido, por exemplo, quando um campo numérico estiver vazio ou faltar uma resposta. O fallback impede que um valor em branco ou quebrado chegue ao visitante.

***

### Expressão (Expression)

A expressão é onde você monta o cálculo. Digite-a diretamente ou use os botões acima do campo.

<img src="https://mintcdn.com/landerlab-babdc23f/XpG_XlFI-vAvUO_O/images/Expression.png?fit=max&auto=format&n=XpG_XlFI-vAvUO_O&q=85&s=081548b9c9f7aafdbcddcf80e85bf1aa" alt="Expressão" width="1920" height="956" data-path="images/Expression.png" />

* Operadores: `+`, `-`, `*`, `/`, `%` (resto), `**` (potência) e `( )` para agrupar partes do cálculo
* Funções: `min()`, `max()`, `round()`, `floor()`, `ceil()`, `abs()`, `sqrt()`

Para adicionar uma resposta ao cálculo, clique no botão de **variável** (o ícone `{ }`) e escolha um campo. A lista mostra todos os campos que você criou no quiz, e o campo escolhido é inserido como uma variável, como `{{Amount}}`.

<img src="https://mintcdn.com/landerlab-babdc23f/XJDaZ6ILyLkk7ClU/images/image-42.png?fit=max&auto=format&n=XJDaZ6ILyLkk7ClU&q=85&s=4508efa7c742d7c71a08798db6efbd01" alt="Imagem" width="1922" height="956" data-path="images/image-42.png" />

<Note>
  O campo inserido precisa conter um **número** para que o cálculo funcione. Uma escolha ou um campo que armazena um número, como um preço ou um valor, é calculado corretamente. Uma resposta de texto simples, não.
</Note>

Por exemplo, para dobrar o valor que um visitante inseriu, insira o campo **Amount** e multiplique-o:

```text theme={null}
{{Amount}} * 2
```

***

### Teste (Test)

A seção **Test** mostra uma prévia do resultado com valores de exemplo antes de você publicar. Insira um valor para cada variável da sua expressão e o LanderLab mostrará o **Result** calculado na hora. Usando a expressão acima, um `Amount` de `2000` retorna o resultado `4000`.

***

## Usar uma fórmula em uma etapa

Depois de salva, uma fórmula pode ser usada em qualquer campo de texto do seu quiz, como o título de uma etapa, um parágrafo ou um botão.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/uXYM9xg2v-5XftzT/images/use-formula.png?fit=max&auto=format&n=uXYM9xg2v-5XftzT&q=85&s=3556ff2e974ca9c88d109737c95a34b9" alt="Usar fórmula" width="1917" height="958" data-path="images/use-formula.png" />
</Frame>

Há duas formas de inseri-la:

* **Digite.** Referencie a fórmula pelo nome com a sintaxe `{{= }}`, por exemplo, `{{=Formula 1}}`
* **Selecione.** Clique no botão de **variável** no campo de texto, role até a seção **Formulas** e selecione sua fórmula

<img src="https://mintcdn.com/landerlab-babdc23f/uXYM9xg2v-5XftzT/images/variable.png?fit=max&auto=format&n=uXYM9xg2v-5XftzT&q=85&s=31a05c5528809a50682f01446adf037f" alt="Variável" width="1922" height="956" data-path="images/variable.png" />

O resultado é calculado em tempo real conforme o visitante avança pelo quiz, então o valor sempre reflete as respostas dadas. O título de uma etapa poderia ser:

```text theme={null}
Your estimated savings: ${{=Formula 1}}
```

## Pré-visualizar e testar

Para ver a fórmula funcionando, clique em **Preview** e responda o quiz como um visitante faria. O resultado aparece na etapa em que você o colocou, usando as respostas que você selecionou ao longo do caminho.

## Dicas

* Dê um nome claro a cada fórmula para que seja fácil encontrá-la e reutilizá-la
* Defina um fallback para que os visitantes nunca vejam um valor em branco ou quebrado
* Referencie apenas campos que armazenam números
* Teste com valores realistas antes de publicar
