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

Retourne l'attribut HTML 'selected' en comparant les deux premiers arguments.

Paramètres

$selected(mixed)requis

Une des valeurs à comparer.

$current(mixed)optionnel

L'autre valeur à comparer. Si elle vaut true, pas besoin de la renseigner.

Valeur par défaut : true

$echo(bool)optionnel

Pour afficher ou juste retourner la chaîne 'selected'.

Valeur par défaut : true

Retourne

(string) Retourne l'attribut HTML 'selected' ou une chaîne vide.

Déclaration et structure de la fonction selected()

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

Fonction utilisée pour générer les attributs HTML 'checked', 'selected', 'disabled' et 'readonly' en comparant les deux premiers arguments.

Où est utilisée la fonction selected() dans le CMS WordPress

Exemples

Tester les valeurs avec if :
$ech .= '<select name="options[foo]">';
foreach($options as $key => $val){
    $selected = '';
    if ( $infos_post[$key] == $val )  $selected = ' selected="selected"';
    $ech .= '<option value="'.$val.'"'.$selected.'>'.$val.'</option>';
}
$ech .= '</select>';

echo $ech;
Tester les valeurs en utilisant selected() :
$ech .= '<select name="options[foo]">';
foreach($options as $key => $val){
    $ech .= '<option value="'.$val.'"'.selected($infos_post[$key], $val, false).'>'.$val.'</option>';
}
$ech .= '</select>';

echo $ech;

Sources

Codex WordPress : selected()

Autres fonctions dans le même fichier : wp-includes/general-template.php

Retour