- サイトデザイン工事中です。ご意見をお寄せください。
- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）
関数リファレンス/get search form
提供：WordPress Codex 日本語版
< 関数リファレンス
目次 |
説明
テーマの searchform.php を使用して検索フォームを表示します。
使い方
<?php get_search_form(); ?>
パラメータ
このタグには、パラメータはありません。
用例
テーマに 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>
テーマに searchform.php がある場合は、それを使用します。検索フォームは、ブログのホームページに GET を投げることに注意してください。入力テキストフィールドの名前は s にして、上述の例のように label を必ず含めてください。
以下は、カスタム searchform.php の例です。
<form action="/" method="get">
<fieldset>
<label for="search">Search in <?php bloginfo( 'name' ); ?></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" />
</fieldset>
</form>
(functions.php ファイル内に) カスタム関数を記述して、get_search_form アクションフックにこの関数をフックする、という方法もあります。
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' );
注意点
変更履歴
2.7.0 で新規追加。
ソースファイル
get_search_form() は wp-includes/general-template.php に含まれる。
関連情報
インクルードタグ: get_header, get_footer, get_sidebar, get_template_part, get_search_form, comments_template
最新英語版： WordPress Codex » Function Reference/get search form （最新版との差分）
