Atenção!

Este artigo contém código PHP e destina-se a desenvolvedores. Oferecemos este código como uma cortesia, mas não fornecemos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação extra, consulte o tutorial do WPBeginner sobre como adicionar código personalizado.

Dispensar

Como Alterar o Texto "Nenhum Resultado Encontrado" no Campo Dropdown Moderno

Gostaria de personalizar o texto que aparece quando nenhum resultado é encontrado em um campo de Dropdown Moderno? Com um simples trecho de código, você pode modificar a mensagem padrão Nenhum resultado encontrado e torná-la traduzível para sites multilíngues. Este recurso é particularmente útil para melhorar a experiência do usuário, fornecendo feedback mais contextual quando os resultados da pesquisa estão vazios.

Por padrão, os visitantes verão a mensagem Nenhum resultado encontrado quando a pesquisa deles não retornar resultados no seu dropdown.

Uma mensagem de Nenhum Resultado Encontrado será exibida na caixa de pesquisa quando o termo não for encontrado no dropdown

Neste tutorial, forneceremos o código PHP necessário para alterar este texto e o guiaremos em cada etapa.

Configurando Seu Formulário

Primeiro, vamos criar um novo formulário e adicionar nossos campos, que incluirão pelo menos um campo Dropdown.

Depois de adicionar o campo de formulário Dropdown ao seu formulário, clique na aba Avançado e selecione Moderno no dropdown Estilo.

Adicione um campo dropdown moderno ao seu formulário

Se precisar de ajuda para criar um formulário, consulte nosso guia sobre como criar seu primeiro formulário.

Personalizando o Texto de Nenhum Resultado

Para alterar a mensagem padrão, adicione este código ao seu site. Se não tiver certeza de como adicionar código personalizado, consulte nosso guia sobre como adicionar trechos de código.

Este trecho será aplicado apenas ao ID do formulário 1369 e alterará a mensagem padrão noResultsText, substituindo-a pelo que adicionamos.

Se precisar de ajuda para encontrar o ID do seu formulário, confira nosso guia sobre como encontrar IDs de formulários e campos.

Personalizando o Texto de Nenhum Resultado e Seleção

Você também pode personalizar o texto de "Pressione para selecionar" ao mesmo tempo:

/**
 * Change both No Results Found and Press to select text
 *
 * @link https://wpforms.com/developers/how-to-change-the-no-results-found-text-in-the-modern-dropdown/
 */
function wpf_dev_change_modern_dropdown_noresults_text( $config, $forms ) {
    // Change 1369 to an ID of your actual form
    if ( array_key_exists( 1369, $forms ) ) {
        $config[ 'noResultsText' ] = __( 'Apologies, your search term was not found', 'your-text-domain' );
        $config[ 'itemSelectText' ] = __( 'Choose this option.', 'your-text-domain' );
    }
    return $config;
}
add_filter( 'wpforms_field_select_choicesjs_config', 'wpf_dev_change_modern_dropdown_noresults_text', 10, 2 );

E é tudo o que você precisa! Agora, em vez de ver Nenhum Resultado Encontrado, os usuários verão sua mensagem personalizada.

Em seguida, você gostaria de mostrar todos os seus campos de formulário preenchidos dentro da sua mensagem de confirmação? Dê uma olhada em nosso tutorial sobre Como Mostrar Todos os Campos na Sua Mensagem de Confirmação.

Filtro de Referência

wpforms_campo_selecionar_config_choicesjs