検索ワードを表示!the_search_queryについて詳細に解説【具体例あり】

Featured image of the post

概要

主に検索結果ページ「search.php」で使用する。

📄 WordPressの[検索結果ページ]を表示!初心者でもわかるsearch.php

検索結果のページで「前のページで指定した検索ワード」を表示するために使用する。

🚫 ただいま記事作成中です💭

※取得用関数get_search_query()も存在する。

💡
【補足】
厳密にはクエリパラメータs=〇〇の値を表示している。

関数の説明

引数・戻り値
the_search_query();

引数

なし

戻り値

なし

使用例
前提

キーワードを入力するフォームで「hoge」と検索する。

👇WordPress内の任意のページ

<form role="search" method="get" id="searchform" action="<?php echo esc_url( home_url( '/' ) ); ?>">
    <label for="s">キーワード</label>
    <input type="text" value="<?php echo get_search_query(); ?>" name="s" id="s" />
    <button type="submit">検索</button>
</form>

Image in a image block

⚠️
name属性は必ずname=”s”であること!

the_search_queryを使う

👇検索結果ページ(search.php)

<h2><?php the_search_query(); ?>」の検索結果</h2>

前のページで入力した「hoge」が表示される✅

Image in a image block

ポイント
  • 前のページで検索した文字が表示される。
  • ちなみに厳密にはクエリパラメータのs=〇〇が表示されている。