Pular para o conteúdo principal

search_title()

search_title( array $args = [] ): void

Exibe o título da página de busca atual.

Parâmetros:
$args array (opcional)

  • attrs array
    Define atributos HTML adicionais para o elemento <h1>.
  • prefix string
    Texto exibido antes do termo pesquisado.
    Padrão: '<span class="query-label">Resultados de busca para:</span> '

Retorno: void
Imprime diretamente o título da busca atual dentro de um elemento HTML <h1>.

Exemplo de uso:

<?php search_title(); ?>

<?php
search_title([
    'attrs' => [
        'class' => 'search-title'
    ],

    'prefix' => '<span class="search-label">Pesquisando por:</span> '
]);
?>
Notas:
  • A função só executa em páginas identificadas pela condicional is_query().
  • O termo pesquisado é obtido automaticamente através do parâmetro q da URL.
  • Por padrão, o elemento gerado recebe o atributo id="master-title".
  • Se o termo pesquisado possuir menos de 3 caracteres, a função exibirá uma mensagem de aviso e renderizará automaticamente um novo formulário de busca.
  • Os atributos HTML informados em attrs são convertidos automaticamente para o elemento <h1>.