Pular para o conteúdo principal

search_form()

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 o id="query" por padrão, mantendo acessibilidade e semântica com o elemento <label for="query">;
    Utiliza minlength="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 .query do form e id #query do input ainda não tem a opção de alteração pelo argumento.