Exibe um formulário de busca.
Parâmetros:
$args array (opcional)
-
'placeholder'string
O texto exibido no campo de busca. Padrão: 'Pesquisar no site' -
'btntext'string
O texto exibido no button submit do form. Padrão: 'Procurar' -
'btnclass'string
O valor do atributo class do button. Padrão: Nenhum
Retorno: void
A função imprime o HTML com elemento <form> completo.
Exemplo de uso:
// Uso básico no template
<?php search_form() ?>
// alterando os padrões passando os argumentos
<?php
search_form([
'placeholder' => 'Digite o termo de busca',
'btntext' => 'Buscar',
'btnclass' => 'btn'
]);
?>
Notas:
-
A função gera o elemento
<form>completo e utiliza a classe.query.
Qualquer wrapper externo deve ser adicionado no template.
-
A tag
<label>utiliza a classe.sr, normalmente usada para ocultar elementos visualmente mantendo acessibilidade para leitores de tela. -
O campo de busca
<input type="search">é automaticamente preenchido com o termo de busca atual, mantendo o valor visível após o envio;
Utiliza oid="query"por padrão, mantendo acessibilidade e semântica com o elemento<label for="query">;
Utilizaminlength="3", e mesmo se alterando removido do DOM, a função search_title() para a execução exibindo aviso e renderizando um novo formulário de busca. - A classe
.querydoforme id#querydoinputainda não tem a opção de alteração pelo argumento.