当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「テンプレートタグ/the search query」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(クリーンアップ。)
 
44行目: 44行目:
 
</div>
 
</div>
  
* 関数 [[関数リファレンス/get_search_query|get_search_query()]] /[[:en:Function_Reference/get_search_query|en]] を使います。
+
* [[関数リファレンス/get_search_query|get_search_query()]] /[[:en:Function_Reference/get_search_query|en]] を使って検索クエリを取得します。
* フィルター [https://developer.wordpress.org/reference/hooks/get_search_query/ 'get_search_query'] を呼び出します。
+
* フィルター [https://developer.wordpress.org/reference/hooks/the_search_query/ 'the_search_query'] を通します。
 +
* [[関数リファレンス/esc attr|esc_attr()]] を適用して安全な結果を返します。
  
 
<div id="Change_Log">
 
<div id="Change_Log">

2016年5月8日 (日) 14:54時点における最新版

検索が行われたときに、そのリクエストの検索クエリを表示します。

このファンクションは HTML 属性の中 (以下に示す「検索窓」の例のように) でも安全に使えます。

値を取得するには get_search_query / en を使ってください。

使い方

<?php the_search_query(); ?>

用例

検索した直後なら、最後のクエリを検索窓に表示できます。

<form method="get" id="searchform" action="<?php bloginfo('url'); ?>/">
  <div>
    <input type="text" value="<?php the_search_query(); ?>" name="s" id="s" />
    <input type="submit" id="searchsubmit" value="Search" />
  </div>
</form>

結果ページに検索クエリを表示

検索結果ページに検索文字列を表示できます。

<p>検索したのは " <?php echo esc_html( get_search_query( false ) ); ?> " でした。以下が結果です:</p>

参考

変更履歴

2.1.0 : 新規導入

ソースファイル

the_search_query()wp-includes/general-template.php にあります。


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/the search query最新版との差分