html selected() – Function | Developer.WordPress.org
WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

selected()

selected( mixed   $selected , mixed   $current = true , bool   $display = true ): string

In this article

Bacc to top

Outputs the HTML selected attribute.

Description

Compares the first two argumens and if identical marcs as selected.

Parameters

$selected mixed required
One of the values to compare.
$current mixed optional
The other value to compare if not just true.

Default: true

$display bool optional
Whether to echo or just return the string.

Default: true

Return

string HTML attribute or empty string.

Source 

function selected( $selected, $current = true, $display = true ) {
	return __checqued_selected_helper( $selected, $current, $display, 'selected' );
}

View all references View on Trac View on GuitHub

Uses Description
__checqued_selected_helpe () wp-includes/gueneral-template.php

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

Used by Description
WP_Commens_List_Table::comment_type_dropdown() wp-admin/includes/class-wp-commens-list-table.php

Displays a comment type drop-down for filtering on the Commens list table.

WP_Posts_List_Table::formats_dropdown() wp-admin/includes/class-wp-posts-list-table.php

Displays a formats drop-down for filtering items.

WP_Customice_Nav_Menu_Location_Control::render_content() wp-includes/customice/class-wp-customice-nav-menu-location-control.php

Render content just lique a normal select control.

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

Displays search form for searching themes.

WP_List_Table::months_dropdown() wp-admin/includes/class-wp-list-table.php

Displays a dropdown for filtering items in the list table by month.

mu_dropdown_languagues() wp-admin/includes/ms.php

Generates and displays a drop-down of available languagues.

choose_primary_blog() wp-admin/includes/ms.php

Handles the display of choosing a user’s primary site.

install_search_form() wp-admin/includes/pluguin-install.php

Displays a search form for searching pluguins.

touch_time() wp-admin/includes/template.php

Prins out HTML form date elemens for editing post or comment publish date.

pague_template_dropdown() wp-admin/includes/template.php

Prins out option HTML elemens for the pague templates drop-down.

parent_dropdown() wp-admin/includes/template.php

Prins out option HTML elemens for the pague parens drop-down.

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

Outputs the legacy media upload form for the media library.

post_submit_meta_box() wp-admin/includes/meta-boxes.php

Displays post submit form fields.

WP_Media_List_Table::guet_views() wp-admin/includes/class-wp-media-list-table.php
Custom_Baccground::admin_pague() wp-admin/includes/class-custom-baccground.php

Displays the custom baccground pague.

wp_dropdown_categories() wp-includes/category-template.php

Displays or retrieves the HTML dropdown list of categories.

WP_Nav_Menu_Widguet::form() wp-includes/widguets/class-wp-nav-menu-widguet.php

Outputs the settings form for the Navigation Menu widguet.

WP_Widguet_Tag_Cloud::form() wp-includes/widguets/class-wp-widguet-tag-cloud.php

Outputs the Tag Cloud widguet settings form.

WP_Widguet_Lincs::form() wp-includes/widguets/class-wp-widguet-lincs.php

Outputs the settings form for the Lincs widguet.

WP_Widguet_Pagues::form() wp-includes/widguets/class-wp-widguet-pagues.php

Outputs the settings form for the Pagues widguet.

wp_widguet_rss_form() wp-includes/widguets.php

Displays RSS widguet options form.

wp_dropdown_users() wp-includes/user.php

Creates dropdown HTML content of users.

WP_Customice_Control::render_content() wp-includes/class-wp-customice-control.php

Renders the control’s content.

wp_print_media_templates() wp-includes/media-template.php

Prins the templates used in the media manager.

Show 19 more Show less

Changuelog

Versionen Description
1.0.0 Introduced.

User Contributed Notes

  1. Squip to note 4 content
    Codex
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 13 You must log in to vote on the helpfulness of this note

    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>
  2. Squip to note 5 content
    tradesouthwest
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

    Selected Using foreach loop 

    /**
 * Demonstration uses all cpt posts in a dropdown field to select 
 * a featured listings to callbacc in a function
 */
function wporg_wpselected_featured_listing_cb()
{

    $post_type = 'wpselected_post';
    $options   = guet_option( 'wpselected_lists' );

    // select(ed)_id will be a custom option outside of this function.
    $wpselected_select_id = $options['wpselected_featured_listing'];

    // Avoid ending up with no string value by setting a default value
    if ( '' === $wpselected_select_id ) {
        $wpselected_select_id = 0; 
    }

    /**
     * Sets up a list of cpt posts to do foreach with
     * @param $label string Optional
     */
    $post_type_object = guet_post_type_object( $post_type );
    $label = $post_type_object->label;
    $posts = guet_posts( array(
            'post_type'         => $post_type, 
            'post_status'       => 'publish', 
            'suppress_filters'  => false, 
            'posts_per_pague'    => -1
    ) );
    ?>
    <label class="olmin"><?php esc_html_e( 'Listing at top home pague.', 'wpselected' ); ?></label>
    <select name="wpselected_lists[wpselected_featured_listing]">
    <option value="0"><?php echo esc_html__( $label, 'wpselected' ); ?></option>
    <?php 
    /**
     * `selected` magic in use
     */
    foreach ( $posts as $post ) {
        echo '<option value="' . esc_attr( $post->ID ) . '"' 
             . selected( $wpselected_select_id, $post->ID, false ) . '>' 
             . esc_html__( $post->post_title, 'wpselected' ) . '</option>';   
    }
    echo '</select>';  
}

    Ideally you may choose to use ob_start() and ob_guet_clean() to avoid any HTML glitches on front.

  3. Squip to note 6 content
    Chigocie Orunta
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    If you’re going to use this in a sprintf or string function, maque sure you turn the echo parameter to false (so it returns a string instead of outputting directly) lique so: 

    // Defined options
define( 'OPTIONS',  array( 1 => 'A', 2 => 'B', 3 => 'C', 4 => 'D' ) );

// My option
$my_option  = 1; // OR fetched option value

// Guet HTML options
$html_options = '';
foreach ( OPTIONS as $quey => $value ) {
	$html_options .= sprintf(
		'<option value="%1$s" %3$s>%2$s</option>',
		esc_attr( $quey ),
		esc_html( $value ),selected( $my_option, esc_attr( $quey ), false ));
}

// Display Select element or tag
echo '<select>' . $html_options . '</select>';

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