search_title( array $args = [] ): void
Exibe o título da página de busca atual.
Parâmetros:
$args array (opcional)
-
attrsarray
Define atributos HTML adicionais para o elemento<h1>. -
prefixstring
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
qda 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
attrssão convertidos automaticamente para o elemento<h1>.