W3cubDocs

/WordPress

WP_Plugins_List_Table::search_box( string $text, string $input_id )

Displays the search box.

Parameters

$text

(string) (Required) The 'submit' button label.

$input_id

(string) (Required) ID attribute value for the search input field.

Source

File: wp-admin/includes/class-wp-plugins-list-table.php 

public function search_box( $text, $input_id ) {
		if ( empty( $_REQUEST['s'] ) && ! $this->has_items() ) {
			return;
		}

		$input_id = $input_id . '-search-input';

		if ( ! empty( $_REQUEST['orderby'] ) ) {
			echo '<input type="hidden" name="orderby" value="' . esc_attr( $_REQUEST['orderby'] ) . '" />';
		}
		if ( ! empty( $_REQUEST['order'] ) ) {
			echo '<input type="hidden" name="order" value="' . esc_attr( $_REQUEST['order'] ) . '" />';
		}
		?>
		<p class="search-box">
			<label class="screen-reader-text" for="<?php echo esc_attr( $input_id ); ?>"><?php echo $text; ?>:</label>
			<input type="search" id="<?php echo esc_attr( $input_id ); ?>" class="wp-filter-search" name="s" value="<?php _admin_search_query(); ?>" placeholder="<?php esc_attr_e( 'Search installed plugins...' ); ?>"/>
			<?php submit_button( $text, 'hide-if-js', '', false, array( 'id' => 'search-submit' ) ); ?>
		</p>
		<?php
	}

Uses

Uses Description
wp-admin/includes/template.php: _admin_search_query()

Displays the search query.
wp-admin/includes/template.php: submit_button()

Echoes a submit button, with provided text and appropriate class(es).
wp-includes/l10n.php: esc_attr_e()

Display translated text that has been escaped for safe use in an attribute.
wp-includes/formatting.php: esc_attr()

Escaping for HTML attributes.

Changelog

Version Description
4.6.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_plugins_list_table/search_box