Pular para o conteúdo principal

Planilhas

O componente Planilha coloca uma grade no estilo Excel/CSV dentro da página — com direito a fórmulas. É útil tanto para exibir uma tabela quanto para montar telas que se comportam como uma planilha de verdade.

Carregando os dados​

Há duas formas de trazer os dados:

  • Upload de arquivo — envie um .xlsx ou .csv. É a forma mais comum.
  • Por URL — carrega a planilha de um endereço.

A planilha também suporta múltiplas abas (sheets).

Aparência​

Nas propriedades você ajusta como a grade aparece:

  • Mostrar/ocultar colunas.
  • Estilo: tamanho da fonte, alinhamento, exibir números de linha, exibir letras de coluna e listras (zebra) para facilitar a leitura.

Fórmulas​

As células aceitam fórmulas, como no Excel. É isso que torna a planilha mais do que uma tabela estática — ela pode calcular.

Referência de célula (o recurso mais poderoso)​

Quando há uma Planilha na página, alguns campos ganham a opção Referenciar célula:

  • Um campo de Texto ou Número pode ser ligado a uma célula (por exemplo, A1).
  • As opções de um campo de Seleção podem vir de células da planilha.

A ligação é de mão dupla: o que o usuário digita no campo vai para a célula, e o valor da célula — incluindo o resultado de fórmulas — aparece no campo. É isso que permite montar formulários que se comportam como uma planilha em tempo real: calculadoras, simuladores, orçamentos que recalculam sozinhos, etc.

A escrita vem sempre do campo

Só é possível escrever na célula através de um campo ligado a ela — o usuário não edita a célula diretamente na grade. A planilha mostra o conteúdo (e o resultado das fórmulas), mas a entrada de dados acontece pelos campos referenciando as células, não digitando na célula em si.

Poderoso, mesmo que discreto

A referência de célula é o recurso que mais rende com planilhas: combine campos ligados a células + fórmulas e você tem uma "mini-planilha interativa" dentro do workflow, sem escrever nenhuma expressão.

Usando valores da planilha em expressões​

Também dá para ler uma célula diretamente por expressão, usando o endereço no estilo A1:

{{ $form.Minha_Planilha.A1 }}

Assistente de IA​

A planilha tem um assistente de IA: descreva o que você quer e ele cria ou ajusta a planilha para você. Há também a opção de esconder a planilha da tela (útil quando ela serve só de "motor" de cálculo por trás dos campos ligados às células).