Como alterar o texto "Nenhum resultado encontrado" no campo suspenso Moderno

Gostaria de personalizar o texto que aparece quando nenhum resultado é encontrado em um campo do Modern Dropdown? Com um simples snippet de código, você pode modificar a mensagem padrão Nenhum resultado encontrado e torná-la traduzível para sites em vários idiomas. Esse 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 gerar resultados em seu menu suspenso.

Uma mensagem de Nenhum resultado encontrado será exibida na caixa de pesquisa quando o termo não for encontrado no menu suspenso

Neste tutorial, forneceremos o código PHP de que você precisa para alterar esse texto e o orientaremos em cada etapa.

Configuração de seu formulário

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

Depois de adicionar o campo de formulário Dropdown ao formulário, clique na guia Advanced (Avançado ) e selecione Modern (Moderno ) no menu suspenso Style (Estilo ).

Adicione um campo suspenso moderno ao seu formulário

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

Personalização do texto Sem resultados

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.

Esse snippet será aplicado somente ao formulário ID 1369 e alterará a mensagem padrão noResultsText e a substituirá pela que adicionamos.

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

Personalização do texto sem resultados e do texto de seleção

Você também pode personalizar o texto de foco "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 isso é 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 campos do formulário preenchidos dentro da mensagem de confirmação? Dê uma olhada no nosso tutorial sobre Como mostrar todos os campos na sua mensagem de confirmação.

Filtro de referência

wpforms_field_select_choicesjs_config