Funções Wix: adicionar validações personalizadas aos formulários

6 min de leitura
Neste artigo
  • Adicionar validação personalizada aos formulários
  • Criar uma função para verificar endereços de email
  • Perguntas frequentes
Usando as funções, você pode adicionar sua própria validação personalizada para verificar as informações que os visitantes inserem antes de enviar seu formulário. Definir suas próprias regras garante que os dados atendam aos seus requisitos. Alguns motivos para adicionar uma validação personalizada incluem:
  • Verificar endereços de email e garantir que dois campos correspondam.
  • Restringir as entradas de endereço de email a apenas números e letras.
  • Limitar alias de email aceitos (por exemplo: apenas Gmail).
A primeira seção deste artigo explica como criar uma validação personalizada, e a segunda seção fornece um guia passo a passo para configurar uma verificação de endereço de email.
Captura de tela do formulário Wix, o campo de verificação de email tem campos que não correspondem.

Adicionar validação personalizada aos formulários

Adicione validação personalizada aos seus formulários para controlar os dados que os visitantes enviam. A função usa os dados de envio do formulário para verificar se o formulário é aprovado na validação definida e, se não, aplica sua mensagem de erro personalizada. 

Para adicionar uma validação personalizada aos seus formulários:

  1. Vá para Funções no painel de controle do seu site.
  2. Clique em Criar função em Validações de formulário.
  3. Clique em + Começar do zero.
  4. Clique na etapa Condição para adicionar parâmetros à sua função usando a lógica se/senão.
  5. Defina a saída da função:
    1. Clique na etapa Saída.
    2. Defina o erro de validação, incluindo:
      • Campo-chave do formulário (opcional): aplique a mensagem de erro a um campo específico. Se nenhum campo-chave for adicionado, a mensagem de erro será exibida abaixo do botão de envio. 
      • Mensagem de erro: insira a mensagem de erro mostrada quando a validação personalizada não é atendida. 
    3. Clique em Adicionar para adicionar o erro de validação.
    4. (Opcional) Clique em + Adicionar validação para definir outro erro de validação.
    5. Clique em Aplicar para salvar sua saída.  
  6. Continue criando sua função para que funcione para o seu negócio, adicionando condições ou ações relevantes. 
  7. Conecte esta função ao formulário relevante:
    1. Clique no ícone Mais ações no canto superior direito.
    2. Selecione Configuração da função.
    3. Clique em Formulário selecionado 1 e, em seguida, + Selecionar.
    4. Selecione o formulário relevante e clique em OK.
Uma captura de tela do dropdown de configuração da função no construtor de funções.
  1. Insira um nome para sua função no canto superior esquerdo.
    Dica: ele é visível apenas para você e ajuda a identificar a função no painel de controle.
  2. Clique em Ativar no canto superior direito.
Captura de tela do construtor de funções, o nome da função sem título está destacado.
Onde encontro o campo-chave do formulário?
Vá para o formulário relevante no criador de formulário. Clique na aba Avançado no painel de configurações do campo. Copie o campo-chave fornecido e adicione à saída da função.

Criar uma função para verificar endereços de email

Um cenário comum para criar uma função de validação personalizada é garantir que dois campos de endereço de email correspondam antes de permitir o envio de um formulário. As etapas descritas abaixo orientam você pelo processo de configuração dessa função específica.
Antes de começar:
Certifique-se de que seu formulário inclui dois campos de endereço de email para validação. Para esclarecer o propósito do segundo campo para os visitantes, sugerimos renomear o título do campo para algo como "Confirme seu email" ou "Verificação de email".

Para criar uma função que verifica endereços de email:

  1. Vá para Formulários no painel de controle do seu site.
  2. Clique em Editar ao lado do formulário que deseja atualizar ou crie um novo formulário.
  3. Clique na aba Configurações na parte superior.
  4. Role para baixo até Validações de formulário avançadas e clique em Criar validação para abrir o construtor de funções.
  5. Clique no ícone Adicionar etapa  e selecione Condição.
Adicione uma etapa de condição do criador de função.
  1. Clique em Selecione uma propriedade e escolha o primeiro campo de email que aparece no seu formulário.
Uma captura de tela do seletor de propriedades no primeiro campo de email.
  1. Clique no dropdown Selecione a lógica e escolha não é
  2. Clique em Personalizar ao lado de Insira texto e selecione o campo de confirmação por email.
    Dica: isso significa que a condição verifica se o texto inserido no primeiro campo de email "não é" o texto do campo de confirmação do email.
Painel de entrada de condição no criador de funções Wix. A opção Personalizar foi selecionada e abriu o seletor de campos.
  1. Clique em Aplicar para salvar a condição. 
  2. Clique na etapa Saída. Se a condição definida acima for atendida (o primeiro campo de email "não for" o texto do segundo campo de email), a saída aplicará um erro de validação.
    1. (Opcional) Insira um Campo-chave do formulário para aplicar a mensagem de erro a um campo específico.
      Observação: se nenhum campo-chave for adicionado, a mensagem de erro será exibida abaixo do botão de envio. 
    2. Insira a Mensagem de erro mostrada quando os emails não correspondem (por exemplo: "os campos não correspondem"). 
    3. Clique em Adicionar para adicionar o erro de validação.
    4. (Opcional) Clique em + Adicionar validação para definir outro erro de validação.
    5. Clique em Aplicar para salvar sua saída.  
Painel de saída no construtor de funções, erros de validação foram adicionados.
  1. Insira um nome para sua função no canto superior esquerdo.
    Dica: ele é visível apenas para você e ajuda a identificar a função no painel de controle.
  2. Clique em Ativar no canto superior direito.

Perguntas frequentes

Clique nas perguntas abaixo para saber mais sobre validações de formulários personalizados.