Tipos de Pergunta de Entrada de Texto

Texto Curto

Uma entrada de texto de linha única para coletar respostas breves, como nomes, títulos ou respostas curtas.

Identificador de tipo: short_text

Propriedades

Propriedade	Tipo	Descrição	Padrão
`placeholder`	string	Texto de placeholder exibido no campo antes de o respondente digitar.	Nenhum
`maxLength`	number	Número máximo de caracteres permitidos.	Nenhum (ilimitado)
`minLength`	number	Número mínimo de caracteres exigidos.	Nenhum

Validação

Regra	Descrição
`minLength`	A resposta deve ter pelo menos esta quantidade de caracteres.
`maxLength`	A resposta não deve exceder esta quantidade de caracteres.
`pattern`	Um padrão regex ao qual a resposta deve corresponder.
`customMessage`	Mensagem de erro personalizada quando a validação falha.

Operadores de Salto de Lógica

equals, not_equals, contains, not_contains, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como uma string.

Texto Longo

Uma área de texto de várias linhas para coletar respostas mais longas, como feedback, descrições ou parágrafos.

Identificador de tipo: long_text

Propriedades

Propriedade	Tipo	Descrição	Padrão
`placeholder`	string	Texto de placeholder exibido na área de texto.	Nenhum
`maxLength`	number	Número máximo de caracteres permitidos.	Nenhum (ilimitado)
`minLength`	number	Número mínimo de caracteres exigidos.	Nenhum

Validação

Regra	Descrição
`minLength`	A resposta deve ter pelo menos esta quantidade de caracteres.
`maxLength`	A resposta não deve exceder esta quantidade de caracteres.
`pattern`	Um padrão regex ao qual a resposta deve corresponder.
`customMessage`	Mensagem de erro personalizada quando a validação falha.

Operadores de Salto de Lógica

equals, not_equals, contains, not_contains, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como uma string.

Os campos de texto longo se expandem verticalmente conforme o respondente digita. Diferentemente dos campos de texto curto, eles suportam entrada de várias linhas, e o respondente pode usar Shift+Enter para criar novas linhas.

E-mail

Um campo de endereço de e-mail com validação de formato integrada.

Identificador de tipo: email

Propriedades

Propriedade	Tipo	Descrição	Padrão
`placeholder`	string	Texto de placeholder exibido no campo.	Nenhum

Validação

O campo de e-mail valida automaticamente que a entrada corresponde a um formato de e-mail padrão (por exemplo, user@domain.com). Regras de validação adicionais podem ser incluídas:

Regra	Descrição
`pattern`	Um padrão regex personalizado para validação adicional.
`customMessage`	Mensagem de erro personalizada quando a validação falha.

Operadores de Salto de Lógica

equals, not_equals, contains, not_contains, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como uma string (o endereço de e-mail).

Telefone

Um campo de número de telefone com suporte a códigos de país internacionais.

Identificador de tipo: phone

Propriedades

Propriedade	Tipo	Descrição	Padrão
`placeholder`	string	Texto de placeholder exibido no campo.	Nenhum
`defaultCountryCode`	string	O código de país padrão a pré-selecionar (por exemplo, `"US"`, `"GB"`, `"DE"`).	Nenhum

Validação

A validação de número de telefone é integrada. O campo aceita formatos internacionais de número de telefone.

Operadores de Salto de Lógica

equals, not_equals, contains, not_contains, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como uma string (o número de telefone completo, incluindo o código do país).

O campo de telefone inclui um menu suspenso seletor de código de país. Quando defaultCountryCode está definido, o menu suspenso pré-seleciona esse país e exibe seu código de discagem.

Número

Um campo de entrada numérica para coletar números, com validação opcional de intervalo mín./máx.

Identificador de tipo: number

Propriedades

Propriedade	Tipo	Descrição	Padrão
`placeholder`	string	Texto de placeholder exibido no campo.	Nenhum
`min`	number	Valor mínimo permitido.	Nenhum
`max`	number	Valor máximo permitido.	Nenhum

Validação

Regra	Descrição
`min`	O número deve ser maior ou igual a este valor.
`max`	O número deve ser menor ou igual a este valor.
`customMessage`	Mensagem de erro personalizada quando a validação falha.

Operadores de Salto de Lógica

equals, not_equals, greater_than, less_than, greater_than_or_equals, less_than_or_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como um número (ou null se não for respondida).

Modo Quiz

Nos modos de quiz, o tipo de pergunta Número não é pontuável -- ele não participa da pontuação automatizada.

Site / URL

Um campo de URL para coletar endereços web. O NueForm trata os tipos url e website de forma idêntica.

Identificador de tipo: url ou website

Propriedades

Propriedade	Tipo	Descrição	Padrão
`placeholder`	string	Texto de placeholder exibido no campo.	Nenhum

Validação

O campo valida que a entrada é uma URL formatada corretamente.

Operadores de Salto de Lógica

equals, not_equals, contains, not_contains, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como uma string (a URL).

Informações de Contato

Um campo composto que coleta o nome, o endereço de e-mail e o número de telefone do respondente em uma única pergunta. É um tipo de conveniência que combina várias entradas de texto em uma única etapa do formulário.

Identificador de tipo: contact_info

Propriedades

Propriedade	Tipo	Descrição	Padrão
`defaultCountryCode`	string	Código de país padrão para o subcampo de número de telefone.	Nenhum
`fields`	FormQuestion[]	Definições opcionais de subcampos personalizados. Se fornecidas, substituem os campos padrão de nome/e-mail/telefone.	Subcampos padrão

Subcampos

A pergunta de Informações de Contato inclui três subcampos por padrão:

Nome -- Um campo de texto curto.
E-mail -- Um campo de e-mail com validação de formato.
Telefone -- Um campo de número de telefone com suporte a código de país.

O prefixo de número da pergunta fica oculto nas perguntas de Informações de Contato, pois elas exibem vários campos de entrada juntos.

Formato da Resposta

A resposta é armazenada como um objeto (Record<string, string>) com chaves para cada subcampo:

json

{
  "name": "John Smith",
  "email": "john@example.com",
  "phone": "+1 555-0123"
}

Endereço

Um campo de endereço postal completo com preenchimento automático opcional do Google Places.

Identificador de tipo: address

Propriedades

Propriedade	Tipo	Descrição	Padrão
`enableAddressAutocomplete`	boolean	Ativa o preenchimento automático do Google Places para ajudar os respondentes a preencher o endereço rapidamente.	Desativado
`fields`	FormQuestion[]	Definições opcionais de subcampos personalizados. Se fornecidas, substituem os campos de endereço padrão.	Subcampos padrão

Subcampos

A pergunta de Endereço inclui subcampos para:

Logradouro -- A linha do endereço da rua.
Cidade -- A cidade ou localidade.
Estado/Província -- O estado, província ou região.
CEP/Código Postal -- O código postal ou CEP.
País -- O país.

Preenchimento Automático de Endereço

Quando enableAddressAutocomplete está ativado, os respondentes podem começar a digitar o endereço e ver sugestões do Google Places. Selecionar uma sugestão preenche automaticamente todos os subcampos de endereço.

O preenchimento automático de endereço requer uma chave de API do Google Maps configurada nas configurações da sua conta NueForm. O prefixo de número da pergunta fica oculto nas perguntas de Endereço.

Formato da Resposta

A resposta é armazenada como um objeto (Record<string, string>) com chaves para cada subcampo:

json

{
  "street": "123 Main Street",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94105",
  "country": "United States"
}

Anexos de Mídia

Todos os tipos de pergunta de entrada de texto suportam anexos de mídia. Você pode adicionar uma imagem, um vídeo, um ícone ou um QR code a qualquer pergunta de texto. Veja o guia de Criando Formulários para detalhes sobre as opções de mídia e as configurações de layout.