selected( mixed $selected, mixed $current = true, bool $echo = true )

Outputs the html selected attribute.

Contents

Description Description

Compares the first two arguments and if identical marks as selected

Parameters Parameters

$selected

(mixed) (Required) One of the values to compare

$current

(mixed) (Optional) (true) The other value to compare if not just true

Default value: true

$echo

(bool) (Optional) Whether to echo or just return the string

Default value: true

Top ↑

Return Return

(string) html attribute or empty string

Top ↑

Source Source

File: wp-includes/general-template.php 

function selected( $selected, $current = true, $echo = true ) {
	return __checked_selected_helper( $selected, $current, $echo, 'selected' );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
1.0.0 Introduced.

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/customize/class-wp-customize-nav-menu-location-control.php: WP_Customize_Nav_Menu_Location_Control::render_content()

Render content just like a normal select control.
wp-includes/l10n.php: wp_dropdown_languages()

Language selector.
wp-admin/includes/theme-install.php: install_theme_search_form()

Display search form for searching themes.
wp-admin/includes/class-wp-list-table.php: WP_List_Table::months_dropdown()

Display a monthly dropdown for filtering items
wp-admin/includes/ms.php: mu_dropdown_languages()

Generates and displays a drop-down of available languages.
wp-admin/includes/ms.php: choose_primary_blog()

Handles the display of choosing a user’s primary site.
wp-admin/includes/plugin-install.php: install_search_form()

Displays a search form for searching plugins.
wp-admin/includes/template.php: touch_time()

Print out HTML form date elements for editing post or comment publish date.
wp-admin/includes/template.php: page_template_dropdown()

Print out option HTML elements for the page templates drop-down.
wp-admin/includes/template.php: parent_dropdown()

Print out option HTML elements for the page parents drop-down.
wp-admin/includes/media.php: media_upload_library_form()

Outputs the legacy media upload form for the media library.
wp-admin/includes/meta-boxes.php: post_submit_meta_box()

Displays post submit form fields.
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::get_views()
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::extra_tablenav()
wp-admin/custom-background.php: Custom_Background::admin_page()

Display the custom background page.
wp-includes/category-template.php: wp_dropdown_categories()

Display or retrieve the HTML dropdown list of categories.
wp-includes/widgets/class-wp-nav-menu-widget.php: WP_Nav_Menu_Widget::form()

Outputs the settings form for the Navigation Menu widget.
wp-includes/widgets/class-wp-widget-tag-cloud.php: WP_Widget_Tag_Cloud::form()

Outputs the Tag Cloud widget settings form.
wp-includes/widgets/class-wp-widget-pages.php: WP_Widget_Pages::form()

Outputs the settings form for the Pages widget.
wp-includes/widgets/class-wp-widget-links.php: WP_Widget_Links::form()

Outputs the settings form for the Links widget.
wp-includes/widgets.php: wp_widget_rss_form()

Display RSS widget options form.
wp-includes/user.php: wp_dropdown_users()

Create dropdown HTML content of users.
wp-includes/class-wp-customize-control.php: WP_Customize_Control::render_content()

Render the control’s content.
wp-includes/media-template.php: wp_print_media_templates()

Prints the templates used in the media manager.
Show 19 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

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

    Example

    <!-- Testing the values with if() -->
<select name="options[foo]">
	<option value="1" <?php if ( $options['foo'] == 1 ) echo 'selected="selected"'; ?>>1</option>
	<option value="2" <?php if ( $options['foo'] == 2 ) echo 'selected="selected"'; ?>>2</option>
	<option value="3" <?php if ( $options['foo'] == 3 ) echo 'selected="selected"'; ?>>3</option>
</select>
 
<!-- Using selected() instead -->
<select name="options[foo]">
	<option value="1" <?php selected( $options['foo'], 1 ); ?>>1</option>
	<option value="2" <?php selected( $options['foo'], 2 ); ?>>2</option>
	<option value="3" <?php selected( $options['foo'], 3 ); ?>>3</option>
</select>

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.