get_search_form() 函数 提取预设的搜索表单

admin

语法结构

1. <?php get_search_form($echo = true) ?>

复制代码

参数

$echo 布尔型，参数是可选的，如果是true则显示表单，如果是false则会返回一个字符串，默认是true。

实例

如果主题目录里没有searchform.php这个文件，那么WordPress将默认使用内置的搜索表单，其格式为

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

复制代码

如果主题文件里有searchform.php这个文件，那么WordPress就会使用指定的搜索表单模版。注意，搜索表单应该使用get方法指向主页，文本域的name应该是s，这是一个自定义searchform.php的例子：

1. <form action="/" method="get" id="searchform" action="<?php echo home_url( '/' ); ?>">
   
2.     <label for="search">Search</label>
   
3.     <input type="text" name="s" id="search" value="<?php the_search_query(); ?>" />
   
4.     <input type="image" alt="Search" src="<?php bloginfo( 'template_url' ); ?>/images/search.png" />
   
5. </form>

复制代码

如果不想用这种方法自定义搜索表单，还可以使用get_search_form钩子进行搜索表单的添加

1. function change_search_form( $form ) {
   
2.     $form = '<form role="search" method="get" class="search-form" action="' . esc_url( home_url( '/' ) ) . '">
   
3.         <label>
   
4.             <span class="screen-reader-text">' . _x( 'Search for:', 'label' ) . '</span>
   
5.             <input type="search" class="search-field" placeholder="' . esc_attr_x( 'Search for:', 'placeholder' ) . '" value="' . get_search_query()
   
6.         . '" name="s" title="' . esc_attr_x( 'Search for:', 'label' ) . '" />
   
7.         </label>
   
8.         <input type="submit" class="search-submit" value="' . esc_attr_x( 'Search', 'submit button' ) .'" /></form>';
   
9.     return $form;
   
10. }
    
11. add_filter( 'get_search_form', 'change_search_form' );

复制代码

这三种表单的级别从大到小依次是钩子方法>searchform.php>默认搜索表单