WordPress模板标签：get_search_form

概述

显示主题目录下的searchform.php模版文件

用法

<?php get_search_form($echo); ?>

传入参数

$echo

（布尔值） （可选的） 值为真（true）时直接输出表单；值为假（false）时输出将表单以字符串的形式输出。
默认值：真

返回值

（字符串）

如果$echo为假（false）时表单将以HTML字符串形式输出。

例子

如果你没有在主题目录下建立searchform.php文件，WordPress将调用默认的搜索表单。

<form role="search" method="get" id="searchform" action="<?php echo home_url( '/' ); ?>">
<div><label class="screen-reader-text" for="s">Search for:</label>
<input type="text" value="" name="s" id="s" />
<input type="submit" id="searchsubmit" value="Search" />
</div>
</form>

以上表单适用于HTML4网站。如果你的主题支持HTML5，而且使用了add_theme_support(‘html5′, array(‘search-form’))，WordPress将输出以下表单，以下表单例子来自WordPress 3.6。

<form role="search" method="get" class="search-form" action="<?php echo home_url( '/' ); ?>">
<label>
<span class="screen-reader-text">Search for:</span>
<input type="search" class="search-field" placeholder="Search …" value="" name="s"title="Search for:" />
</label>
<input type="submit" class="search-submit" value="Search" />
</form>

以上HTML5代码和HTML4代码的区别是，class=”search-form”同时type=”search”而不是type=”text”，这意味着不再需要用JavaScript来显示占位符。如果你的主题目录下有searchform.php，将调用这个文件。如果没有，将显示如上例子。

下面是一个searchform.php的例子

<form action="/" method="get">
<fieldset>
<label for="search">Search in <?php echo home_url( '/' ); ?></label>
<input type="text" name="s" id="search" value="<?php the_search_query(); ?>" />
<input type="image" alt="Search" src="<?php bloginfo( 'template_url' ); ?>/images/search.png" alt="WordPress模板标签：get_search_form" />
</fieldset>
</form>

还有一个选择是在主题目录的functions.php文件新增一个钩子，如下所示。

function my_search_form( $form ) {
$form = '<form role="search" method="get" id="searchform" action="' . home_url( '/' ) . '" >
<div><label class="screen-reader-text" for="s">' . __( 'Search for:' ) . '</label>
<input type="text" value="' . get_search_query() . '" name="s" id="s" />
<input type="submit" id="searchsubmit" value="'. esc_attr__( 'Search' ) .'" />
</div>
</form>';
return $form;
}
add_filter( 'get_search_form', 'my_search_form' );

相关资料

如果 searchform.php 存在 $echo 将被忽略。

get_search_form() 还有一种解决方案是使用 get_search_form 过滤器。

如果你想显示当前搜索的关键词在搜索框请使用 value="<?php echo get_search_query(); ?>"

变更记录

起源于：2.7.0

源文件

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

如果本文对你有帮助，你可以扫描右边的二维码打赏，谢谢支持

联系优畅：uctheme#qq.com (#改为@)
微信订阅号：优畅主题（uctheme）
官网淘宝店：http://uctheme.taobao.com
版权声明：版权归 优畅主题 所有，转载请注明出处！
转载请保留链接： https://www.uctheme.com/front/1251.html