get_search_form

WordPress模板标签get_search_form用于加载搜索表单,首先会尝试加载模板文件searchform.php,如果该文件不存在,则输出默认的搜索表单HTML。

get_search_form( bool $echo = true )

函数参数

$echo

布尔值,默认为true,即输出表单内容,如果为false,则只返回结果而不输出。

get_search_form默认输出XHTML版本的标签,如果要输出HTML5版本的标签,需要在主题文件中加入以下代码:

add_theme_support( 'html5', array(
	'search-form',
) );

XHTML版本的输出结果如下:

<form role="search" method="get" id="searchform" class="searchform" action="https://www.beizigen.com/">
	<div>
		<label class="screen-reader-text" for="s">搜索:</label>
		<input type="text" value="" name="s" id="s" />
		<input type="submit" id="searchsubmit" value="搜索" />
	</div>
</form>

HTML5版本的输出结果如下:

<form role="search" method="get" class="search-form" action="https://www.beizigen.com/">
	<label>
		<span class="screen-reader-text">搜索:</span>
		<input type="search" class="search-field" placeholder="搜索&hellip;" value="" name="s" />
	</label>
	<input type="submit" class="search-submit" value="搜索" />
</form>

扩展阅读

get_search_form()函数位于:wp-includes/general-template.php

相关函数:

  • get_header()
  • get_sidebar()
  • get_template_part()
  • comments_template()
  • get_footer()