Campos de Formulários

Os campos são as perguntas que um formulário faz. Todo campo tem um tipo, um nome (interno), um rótulo (visível), regras de validação e uma condição opcional de exibição-quando. A tela do construtor (Forms → edit → Fields) suporta criar, reordenar, editar e deletar campos; os nomes dos campos são únicos dentro de um formulário.

Tipos de campo

A paleta cobre:

Text, textarea - texto livre (os campos de contato usuais).
Email, tel - campos de linha única com formato validado.
Select / dropdown, radio buttons, checkbox list - campos baseados em opções; você fornece as opções uma por linha. Campos controladores do tipo checkbox podem dirigir a exibição condicional de outros campos.
Checkbox único e checkbox de consentimento - um único opt-in. O tipo de consentimento é destinado a linhas de concordância com políticas.
Address - um composto estruturado (linha 1/linha 2, cidade, estado, CEP, país) que é coletado e armazenado como uma unidade.
File upload - veja abaixo.
Number, date - validados numericamente e regionalmente pelo seu padrão.

Validação

Obrigatório - aplicado no servidor; campos ocultos condicionalmente são pulados (um campo oculto porque sua condição controladora não foi atendida nunca é exigido).
Regras de comprimento / valor / padrão - comprimento mínimo e máximo por campo, valores numéricos ou de data mínimos/máximos, e um formato por expressão regular (erro "does not match the required format" caso contrário).
Os nomes seguem uma única regra: letras minúsculas, números e sublinhados (eles são os nomes de máquina ecoados nos webhooks, emails e exportações CSV).

Comportamento de edição

A re-renderização após um erro de validação mantém as respostas dos visitantes preenchidas, inclusive entre grupos de checkboxes.
Os formulários se pré-preenchem a partir de parâmetros de consulta da URL no primeiro carregamento (por exemplo, linkar para o formulário com ?email=… preenche o campo de email para os campos nomeados), útil para links de campanha personalizados.
As edições de campo são salvas como parte do formulário; o histórico de um campo viaja junto com o contador de versões do formulário, deletar um campo afeta apenas submissões futuras, não as armazenadas (que capturam as respostas como dados no momento do envio).

Uploads de arquivos

Os uploads são verificados pelo tipo de conteúdo real (magic bytes), não pela extensão; a extensão do nome de arquivo armazenado sempre corresponde ao tipo de conteúdo.
SVG é deliberadamente não aceito por segurança (pode carregar conteúdo ativo).
Cada formulário tem uma configuração de cota total de upload; os uploads precisam, portanto, caber na cota do formulário.
Os uploads são armazenados no servidor do CMS. Se os arquivos enviados são publicamente acessíveis ou apenas para administradores é um alternador por formulário (prv acessível pela internet ou download apenas para administradores). Deletar uma submissão deleta também seus arquivos enviados.

Exibição condicional

Qualquer campo pode ser configurado para aparecer apenas quando outro campo carregar um valor específico, por exemplo, um campo "Nome da empresa" que aparece apenas quando "Organization = yes" está marcado. O campo controlador pode ser de qualquer tipo, incluindo um checkbox; os valores correspondidos para controladores do tipo checkbox-list são comparados após o clique. Campos ocultos por condição não são validados no envio, já que nunca foram exibidos.