Question

the_search_query()

Displays the contents of the search query variable.

---

description

The search query string is passed through esc_attr() to ensure that it is safe for placing in an html attribute.

---

源代码

File: wp-includes/general-template.php

function the_search_query() {
	/**
	 * Filters the contents of the search query variable for display.
	 *
	 * @since 2.3.0
	 *
	 * @param mixed $search Contents of the search query variable.
	 */
	echo esc_attr( apply_filters( 'the_search_query', get_search_query( false ) ) );
}

---

更新日志

Version	description
2.1.0	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: esc_attr()
• wp-includes/general-template.php: the_search_query
• wp-includes/general-template.php: get_search_query()
• wp-includes/plugin.php: apply_filters()

---

Used By

• wp-admin/includes/media.php: media_upload_library_form()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Show search query in search box
   If you have just performed a search, you can show the last query in the search box:

   
   <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>
   
   

Show search query in results page
You can display the search string on search result pages

<p>You searched for " <?php echo esc_html( get_search_query( false ) ); ?> ". Here are the results:</p>