• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/get search form

提供: WordPress Codex 日本語版
< 関数リファレンス
2010年11月14日 (日) 18:50時点におけるMizuno (トーク | 投稿記録)による版 (翻訳済み div無し)

移動先: 案内検索

説明

テーマの searchform.php を使用して検索フォームを表示します。

使い方

<?php get_search_form(); ?>

パラメータ

このタグには、パラメータはありません。

用例

テーマに searchform.php が無い場合は、WordPress はビルトインの検索フォームを表示します。

<form role="search" method="get" id="searchform" action="<?php bloginfo('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="'.get_bloginfo('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最新版との差分