CKTIS / HTML
selected — sélection par défaut d’une option
L’attribut booléen selected définit la sélection par défaut d’un élément option. Ce n’est pas un indicateur fiable du choix actuel : en JavaScript, selected décrit l’état actuel, tandis que defaultSelected reflète l’attribut.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<option selected>...</option>
<option selected="">...</option>
<option selected="selected">...</option>selected est un attribut booléen d’un élément option qui définit sa sélection par défaut. Placez-le sur option, et non sur select. Sans multiple, un élément select ne doit pas contenir plus d’une option portant cet attribut ; avec multiple, plusieurs sélections par défaut sont possibles.
Les formes selected, selected="" et selected="selected" sont équivalentes. Écrire selected="false" est incorrect et signifie tout de même que l’attribut est présent. Pour supprimer la sélection par défaut, omettez ou supprimez l’attribut.
En JavaScript, option.defaultSelected reflète l’attribut, tandis que option.selected indique la sélection actuelle. Une modification de la sélection par l’utilisateur ou une affectation à option.selected définit un indicateur interne de modification (dirtiness) ; ensuite, modifier l’attribut ne contrôle plus directement la sélection de cette option. Utilisez option.selected ou select.value pour modifier le choix actuel.
form.reset() rétablit les sélections à partir des attributs selected actuels, efface les indicateurs de modification et applique les règles de sélection de l’élément select. L’absence de l’attribut ne garantit pas qu’aucune option ne soit actuellement sélectionnée : une liste déroulante ordinaire peut sélectionner automatiquement sa première option activée.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>selected</title>
<form id="demo">
<label for="color">Color</label>
<select id="color" name="color">
<option value="red">Red</option>
<option value="blue" selected>Blue</option>
</select>
</form>
<pre id="output"></pre>
<script>
const form = document.getElementById('demo');
const select = document.getElementById('color');
const blue = select.options[1];
const lines = [];
function record() {
lines.push(`${select.value} ${blue.selected} ${blue.defaultSelected}`);
}
record();
select.value = 'red';
record();
form.reset();
record();
document.getElementById('output').textContent = lines.join('\n');
</script>Résultat
blue true true red false true blue true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.