Objet Window.document.Form.Select


SELECT (objet)

Cet objet représente une boîte liste ou une boîte à liste déroulante que l’on retrouve dans les formulaires HTML. Les boîtes liste permettent à l’usager de sélectionner un ou plusieurs éléments accessibles dans un menu. Les listes à liste déroulante sont utilisées pour laisser l'utilisateur sélectionner une option au maximum dans le menu déroulant.


Syntaxe:

Pour définir l’objet "select", il faut utiliser la syntaxe HTML habituelle:

<SELECT NAME="NomSelect"..> texte

<OPTION> texte
</SELECT>


Pour utiliser les propriétés et les méthodes de l’objet "select":

1. nomSelect.nomPropriété
2. nomSelect.nomMéthode(paramètres)
3. nomFormulaire.elements[index].nomPropriété
4. nomFormulaire.elements[index].nomMéthode(paramètres)

nomSelect est la valeur de l’attribut NAME d’un objet "select".
nomFormulaire est soit la valeur de l’attribut NAME d’un objet "form" ou un élément dans le tableau de formulaire.

index est un entier représentant un objet "select" dans un formulaire.


Le tableau d’options:

Il est possible de faire référence à une option d’un objet "select" dans votre code en utilisant le tableau d’options. Ce tableau possède une entrée pour chaque option dans l’objet "select" (marqueur <OPTION>) dans l’ordre du code.

Pour utiliser une option de l’objet "select":

1. nomSelect.options{index1].nomPropriété
2. nomFormulaire.elements[index2].options[index1].nomPropriété

3. nomSelect.options.length

index1 est un entier représentant une option dans l’objet "select".
index2 est un entier représentant un objet "select" dans un formulaire.
Pour avoir le nombre d’options dans un objet "select", il faut utiliser la propriété "length".


Pour créer une option:

nomOption = new Option([texteOption, valeurOption, sélectionDéfaut, sélectionner])


Pour ajouter une nouvelle option à un objet "select" existant:

nomSelect.options[index]=nomOption


Pour effacer une option d'un objet "select":

nomSelect.options[index] = null

nomOption est soit le nom d'un nouvel objet ou une propriété d'un objet existant.
texteOption spécifie le texte à afficher dans la boîte liste.
valeurOption spécifie une valeur qui sera retournée au serveur lorsqu'une option est sélectionnée et le formulaire est soumis.
sélectionDéfaut spécifie si l'option est initialement sélectionnée (vrai ou faux).

sélectionner spécifie le statut courant de sélection d'une option (vrai ou faux).
nomSelect est le nom d'un objet "select" existant.
index est un entier représentant une option de l'objet "select".


Objet utilisé:

form


Propriété utilisée:

L’objet "select" possède les propriétés suivantes:

length (représente le nombre d’options dans un objet "select")
name (représente l’attribut NAME)

options (représente le marqueur <OPTION>)
selectedIndex (représente l’index de l’option sélectionnée)
text
type


Le tableau d’options possède les propriétés suivantes:

defaultSelected (représente l’attribut SELECTED)
index (représente l’index d’une option)
length (représente le nombre d’options dans un objet "select")
name (représente l’attribut NAME)

selected (permet de sélectionner une option par défaut)
selectedIndex (représente l’index d’une option sélectionnée)
text (représente le texte à afficher qui suit le marqueur <OPTION>)
value (représente la valeur de l’attribut VALUE)


Méthode utilisée:

blur
focus


Événement utilisé:

onBlur
onChange
onFocus

Exemple SELECT (objet)

<FORM>
<SELECT NAME="liste" SIZE=1>
<OPTION SELECTED VALUE="">Choisissez
<OPTION VALUE="index.htm">Index
<OPTION VALUE="suscribe.htm">Inscription
<OPTION VALUE="aparaitr.htm">A paraître
</SELECT>
<INPUT TYPE="button" VALUE="Allez" onClick="if (form.liste.selectedIndex != 0) window.open(form.liste.options[form.liste.selectedIndex].value, 'Abonnement', 'scrollbars=yes,status=yes,width=500,height=300'); else alert('Veuillez faire un choix')">
</FORM>


Christophe Merlet
redfox@redfoxcenter.org
©Tous droits réservés
21 novembre 1998