W3cubDocs

/WordPress

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

Outputs the HTML selected attribute.

Description

Compares the first two arguments and if identical marks as selected

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

Return

(string) HTML attribute or empty string

Source

File: wp-includes/general-template.php 

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

Uses

Uses Description
wp-includes/general-template.php: __checked_selected_helper()

Private helper function for checked, selected, disabled and readonly.

Used By

Used By Description
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::comment_status_dropdown()

Displays a comment status drop-down for filtering on the Comments list table.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::formats_dropdown()

Displays a formats drop-down for filtering items.
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()

Displays a dropdown for filtering items in the list table by month.
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-custom-background.php: Custom_Background::admin_page()

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

Displays or retrieves 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.

Changelog

Version Description
1.0.0 Introduced.

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