### [Adicionar uma lista de bloqueio de palavras em tempo real a um campo de texto de linha única](https://wpforms.com/developers/add-a-real-time-keyword-blocklist-to-a-single-line-text-field/) **Publicado:** 11 de dezembro de 2025 **Autor:** Umair Majeed **Excerto:** Saiba como adicionar uma lista de bloqueio de palavras em tempo real a um campo de texto de linha única. **Conteúdo:** Gostaria de bloquear palavras específicas num campo de texto de linha única antes que um utilizador envie o seu formulário? Por defeito, a proteção contra spam do WPForms é executada quando o formulário é enviado. Com um pequeno trecho de JavaScript, pode adicionar uma lista de bloqueio de palavras em tempo real que mostra uma mensagem de erro assim que uma palavra restrita é introduzida. Neste tutorial, mostraremos como usar `wpforms_wp_footer_end` e jQuery Validate para adicionar validação de palavras-chave no lado do cliente que se comporta de forma semelhante a uma máscara de entrada. --- ## Criação do Formulário Primeiro, crie o seu formulário e adicione um campo de texto de linha única que deseja proteger com a lista de bloqueio de palavras. Também pode adicionar quaisquer outros campos de que necessite para o seu formulário. Se precisar de ajuda com este passo, consulte o nosso guia sobre como criar o seu primeiro formulário no WPForms. Anote: - O **ID do Formulário** - O **ID do Campo** do campo de texto de linha única que deseja validar Precisará destes valores ao configurar o trecho abaixo. ## Adicionar o Trecho de Código Para adicionar a lista de bloqueio de palavras em tempo real, utilize o seguinte trecho. Este exemplo imprime um pequeno bloco de JavaScript no rodapé do seu site usando a ação `wpforms_wp_footer_end`. Se precisar de ajuda para adicionar código personalizado, consulte o nosso tutorial sobre como[ adicionar PHP ou JavaScript personalizado para o WPForms](https://wpforms.com/developers/how-to-add-custom-php-or-javascript-for-wpforms/). Depois de adicionar e guardar este código, visite uma página com o seu formulário no front-end e teste o campo **Texto de Linha Única** digitando uma das palavras bloqueadas. Deverá ver uma mensagem de validação vermelha por baixo do campo assim que uma palavra-chave restrita for detetada, sem necessidade de enviar o formulário. ## Personalização do Trecho Para adaptar este exemplo ao seu formulário, edite a secção de configuração no topo do script usando os números das linhas da captura de ecrã. - **ID do Formulário** Na **linha 14**: `var targetFormID = 100; // Substitua pelo ID do seu Formulário` Altere `100` para o ID do formulário que contém o seu campo de texto de linha única. - **ID do Campo** Na **linha 15**: `var targetFieldID = 1; // Substitua pelo ID do seu Campo` Altere `1` para o ID do campo de texto de linha única que deve usar a lista de bloqueio de palavras. - **Palavras bloqueadas** Na **linha 16**: `var blockedWords = ['palavrama', 'spam', 'indesejada']; // Lista de palavras-chave a bloquear` Substitua as palavras de exemplo pela lista de palavras-chave que deseja bloquear. Pode adicionar ou remover itens do array conforme necessário. - **Mensagem de erro** Na **linha 17**: `var customError = 'Este conteúdo contém palavras-chave restritas.';` Atualize o texto entre aspas para alterar a mensagem que aparece por baixo do campo quando uma palavra-chave restrita é detetada. ## Perguntas Frequentes Abaixo, respondemos a algumas das principais perguntas sobre o uso deste filtro de palavras-chave personalizado. #### Qual é a diferença em relação ao filtro de palavras-chave integrado na Proteção contra Spam e Segurança? O filtro de palavras-chave integrado é configurado em **Definições » Proteção contra Spam e Segurança** e aplica-se a todos os formulários e campos do seu site quando o formulário é enviado. Este trecho visa apenas um campo de texto de linha única específico num formulário e mostra a mensagem de erro instantaneamente enquanto o utilizador está a digitar. O filtro de palavras-chave padrão é a principal forma de bloquear palavras proibidas em todos os seus formulários e ainda será executado na submissão, mesmo que o JavaScript esteja desativado. Este trecho é melhor usado como uma verificação adicional em tempo real para campos importantes onde deseja feedback imediato. Para mais informações, consulte a nossa documentação sobre [Filtros de Spam](https://wpforms.com/docs/adding-spam-filters/). É tudo. Agora aprendeu a adicionar uma lista de bloqueio de palavras em tempo real a um campo de texto de linha única usando uma regra de validação JavaScript personalizada. Gostaria de mostrar ou ocultar condicionalmente o botão **Enviar** num formulário com base num dos campos do seu formulário? Consulte o nosso tutorial sobre [Como Mostrar Condicionalmente o Botão Enviar](https://wpforms.com/developers/how-to-conditionally-show-the-submit-button/). ## Ação de Referência [wpforms\_wp\_footer\_end](https://wpforms.com/developers/wpforms_wp_footer/) **Categorias:** Tutoriais, Campos ---