optionsNN 2 IE 3 DOM 1

Tableau d'éléments option imbriqués dans un objet select.

 
Référence de modèle d'objet
  
[window.]document.formName.selectName.options
[window.]document.forms[i].elements[i].options
[window.]document.getElementById("selectElementID").options
 
Propriétés spécifiques à l´objet
 
length
 
Méthodes spécifiques à l´objet
 
add()item()namedItem()remove()tags()urns()
lengthNN 2 IE 3 DOM 1

Lecture seule

Renvoie le nombre d'éléments de la collection.
 
Exemple
  
var howMany = document.forms[0].mySelect.options.length;
 
Valeur

Nombre entier.

add()NN s.o. IE 4 DOM s.o.

add(elementRef[, index])

Ajoute un élément créé précédemment (à l'aide de la méthode createElement()) à la collection courante. L'élément doit être du type option. Par défaut, le nouvel élément est ajouté comme dernier élément de la collection, à moins de spécifier une valeur d'index comme second paramètre (auquel cas tous les éléments existants à partir de cette position d´index sont déplacés d´une position vers le bas). L'exemple suivant illustre l'ajout d'un nouvel élément à un objet select: 

var newElem = document.createElement("option");
newElem.text = "Freddy";
newElem.value = "Freddy Mercury";
document.forms[1].rockers.options.add(newElem);
 

Notez qu'un objet générique est d'abord créé. Puis, des valeurs sont insérées dans ses propriétés et le nouvel élément est ajouté à l´élément select.

 

Pour un exemple d´approche compatible avec tous les navigateurs et assurant la compatibilité ascendante, reportez-vous à la section consacrée à l´objet option. Reportez-vous également à la méthode select.add() pour une approche du DOM W3C qui fonctionne avec Netscape 6.

 
Paramètres
 
  • Référence de l'objet élément complète, généralement créée par la méthode createElement().
  • Nombre entier facultatif indiquant l'emplacement que devrait occuper le nouvel élément dans la collection.
 
Valeur renvoyée

Aucune.
item()NN 6 IE 4 DOM 1

item(index[, subindex]) item(index)

Renvoie un objet ou une collection d'objets pour l'élément correspondant à la valeur d'index (ou éventuellement aux valeurs d'index et de sous-index).

 
Paramètres
 
  • Lorsque le paramètre est un nombre entier à base zéro, la valeur renvoyée est un élément unique correspondant à l'élément spécifié dans l'ordre du code source (imbriqué dans le document courant); lorsque le paramètre est une chaîne (IE uniquement), la valeur renvoyée constitue une collection d'éléments dont les propriétés id correspondent à cette chaîne.
  • Dans IE uniquement, si vous spécifiez une valeur sous forme de chaîne pour le premier paramètre, vous pouvez utiliser le second pour spécifier un nombre entier à base zéro afin d'extraire un élément spécifique de la collection dont les propriétés id correspondent à la valeur contenue dans la chaîne du premier paramètre.
 
Valeur renvoyée

Objet ou collection d'objets (tableau). A défaut de correspondance avec les paramètres, la valeur renvoyée est null.

namedItem()NN 6 IE 6 DOM 1

namedItem(ID)

Renvoie un objet option pour l'élément correspondant à la valeur de chaîne de paramètre.

 
Paramètres
 
  • La chaîne contenant la même valeur que l´attribut id de l´élément désiré.
 
Valeur renvoyée

Un objet option. A défaut de correspondance avec les paramètres, la valeur renvoyée est null.

remove()NN s.o. IE 4 DOM s.o.

remove(index)

Supprime un élément de la collection courante. Vous devez simplement spécifier la valeur d'index à base zéro de l'élément option que vous voulez supprimer de la collection appartenant à l'élément select. L'exemple suivant illustre la suppression du premier élément d'un objet select: 

document.forms[1].rockers.options.remove(0);
 

Le processus que Navigator utilise pour supprimer un élément option est radicalement différent. Pour supprimer un élément, affectez la valeur null à l'élément de la collection. La version Navigator de l'exemple Internet Explorer précédent serait la suivante: 

document.forms[1].rockers.options[0] = null;
 

Indépendamment des spécificités propres à chaque navigateur concernant la suppression d'une option de l'objet select, la longueur du tableau options est adaptée à l'espace.

 
Paramètres
 
  • Nombre entier à base zéro indiquant l'élément de la collection à supprimer.
 
Valeur renvoyée

Aucune.
tags()NN s.o. IE 4 DOM s.o.

tags("tagName")

Renvoie une collection d'objets (parmi tous les objets imbriqués dans la collection actuelle) dont les balises correspondent au paramètre tagName. Implémenté dans toutes les collections IE (voir la méthode all.tags()), mais redondant pour les collections du même type d´élément.

urns()NN s.o. IE 5 (Win) DOM s.o.

urns(URN)

Reportez-vous à la méthode all.urns().