Propriétés HTML standard

Le tableau suivant dresse la liste des propriétés standard disponibles pour les objets HTML. Ces propriétés sont qualifiées de standard parce qu'elles offrent un moyen commun d'accès aux propriétés des objets HTML et à leurs valeurs avec différents navigateurs. La plupart d'entre elles reprennent comme modèle les attributs des éléments HTML définis par le W3C. Pour plus de détails, voir le site http://www.w3.org/TR/html401/index/attributes.html.

Propriété Utilisation

.align

Valeur de l'attribut align de l'élément. Valeurs admises : bottom, middle et top.

.alt

Valeur de l'attribut alt d'un élément. Abréviation du terme anglais "alternate", cet attribut contient le texte de remplacement de l'élément. Le navigateur l'affiche lorsque la souris survole l'élément.

.border

Valeur de l'attribut border de l'élément. Renvoie le nombre de pixels.

.bounds

Rectangle représentant les limites de l'objet, en coordonnées écran.

.caption

Pour les éléments TABLE, valeur de l'attribut caption. Pour une boîte de dialogue HTML, il s'agit de son nom.

.cellIndex

Index de cellule d'un élément par rapport à sa ligne (>=0).

.checked

Valeur booléenne indiquant si une case est cochée (true) ou non (false).

.class

Nom de classe de l'objet de test (TestObject) ; par exemple, "HtmlTable" pour un élément TABLE.

.className

Valeur de l'attribut class d'un élément (utilisé pour les feuilles de styles en HTML).

.clientRect

Rectangle de délimitation de l'élément en coordonnées client.

.code

Valeur de l'attribut code d'un élément APPLET.

.codeBase

Valeur de l'attribut codeBase d'un élément APPLET.

.colSpan

Valeur de l'attribut colSpan d'un élément.

.cookie

Valeur courante du cookie du document.

.coords

Valeur de l'attribut coords d'un élément. Il s'agit d'une chaîne contenant les coordonnées utilisées pour définir l'élément AREA d'une image cliquable côté client. Elle est de la forme x1, y1, x2, y2, et ainsi de suite.

.defaultChecked

Valeur booléenne de l'attribut defaultChecked de l'élément.

.defaultSelected

Valeur booléenne ; la valeur 'true' indique que l'élément OPTION contenu dans un élément SELECT (boîte à liste ou menu déroulant) est sélectionné par défaut au moment où la page est affichée.

.defaultValue

Valeur de l'attribut defaultValue de l'élément.

.disabled

Valeur de l'attribut disabled d'un élément, renvoyée sous forme de booléen. Si la valeur est 'true', cela signifie que l'entrée de données par l'utilisateur est actuellement désactivée pour l'élément concerné.

.hasFocus

Indique si l'élément courant est la cible des entrées (focus). Cet attribut n'est pas implémenté dans Netscape.

.hasScript

Valeur booléenne ; la valeur 'true' signifie qu'un script a été associé à des actions sur cet élément.

.height

Valeur de l'attribut height d'un élément. Pour un élément image (IMG), il s'agit de la hauteur d'affichage de l'image, en pixels.

.href

Valeur de l'attribut href d'un élément. Il s'agit d'une URL utilisée par les éléments ANCHOR et AREA pour indiquer le résultat d'un clic sur l'élément correspondant.

.hspace

Valeur de l'attribut hspace d'un élément. Il s'agit de l'espace (en pixels) inséré à gauche ou à droite d'un élément IMG, OBJECT ou APPLET.

.id

Valeur de l'attribut id d'un élément.

.indeterminate

Valeur booléenne ; 'true' lorsque l'état de la case à cocher a été changé.

.index

Index de l'élément OPTION dans une boîte à liste (listbox) ou une zone de liste modifiable (combo dropdown).

.isMap

Valeur booléenne ; pour un élément image (IMG), cette valeur est 'true' lorsque l'élément est une image cliquable côté serveur.

.length

Valeur de l'attribut length d'un élément. Pour un élément SELECT, elle indique le nombre d'articles dans la liste.

.maxLength

Pour un contrôle d'édition (Input type=Text ou TextArea), indique le nombre maximum de caractères que peut entrer l'utilisateur.

.multiple

Valeur booléenne ; pour un élément SELECT tel qu'une boîte à liste (listbox) ou une zone de liste modifiable (combo dropdown), la valeur 'true' indique que la liste admet la sélection de plusieurs articles à la fois.

.name

Valeur de l'attribut name (éléments Form et Frames uniquement).

.noHref

Valeur de l'attribut noHref d'un élément. Lorsqu'elle est définie dans un élément AREA, cela indique qu'il n'y a pas d'action associée à la région correspondante.

.offsetHeight

Hauteur de l'élément.

.offsetLeft

Ecart, en pixels, entre le bord gauche de l'élément et le bord gauche de son élément parent dans le DOM.

.offsetRight

Ecart, en pixels, entre le bord droit de l'élément et le bord droit de son élément parent dans le DOM.

.offsetTop

Position relative de l'élément par rapport au bord supérieur de son élément parent dans le DOM.

.offsetWidth

Largeur de l'élément.

.readOnly

Valeur de l'attribut readOnly d'un élément. Valeur booléenne ; 'true' lorsque l'élément FORM est en lecture seule.

.readyState

Etat courant d'un navigateur, indiquant s'il est en train de charger un document ou s'il est prêt à recevoir les entrées de l'utilisateur. Il s'agit d'un entier :

0 - Non initialisé

1 - Chargement en cours

2 - Document chargé

3 - Interactif

4 - Terminé (prêt)

.rowIndex

Index de ligne d'un élément dans une table (>=0 ).

.rows

Valeur de l'attribut rows d'un élément TEXTAREA, indiquant la taille du contrôle d'édition en nombre de lignes de texte.

.rowSpan

Valeur de l'attribut rowSpan d'un élément.

.screenLeft

Angle supérieur gauche du rectangle de délimitation, en coordonnées écran, composant x.

.screenTop

Angle supérieur gauche du rectangle de délimitation, en coordonnées écran, composant y.

.select

Valeur booléenne ; 'true' lorsque l'élément FORM est mis en évidence pour recevoir les entrées de l'utilisateur.

.selected

Valeur booléenne ; 'true' lorsque l'élément OPTION contenu dans un élément SELECT (boîte à liste ou menu déroulant) est sélectionné.

.selectedIndex

Valeur de l'attribut selectedIndex d'un élément. Pour un élément SELECT à sélection unique, indique quel élément OPTION est sélectionné. Entier >=0.

.shape

Valeur de l'attribut shape d'un élément. Utilisé pour les éléments AREA dans les images cliquables côté client. Valeurs possibles : default, rect, circle et poly.

.size

Valeur de l'attribut size d'un élément. Pour un élément SELECT, nombre d'articles visibles en même temps dans la liste. Si size > 1, l'élément est une boîte à liste (listbox) ; sinon, il s'agit d'une zone de liste modifiable (combo dropdown).

.src

Valeur de l'attribut src de l'élément. Pour une image ou un bouton image, il s'agit d'une URL spécifiant l'emplacement du fichier image.

.tag

Balise HTML de l'élément.

.target

Valeur de l'attribut target d'un élément. Pour une ancre, cet attribut indique le nom du cadre cible, c'est-à-dire le cadre (frame) dans lequel le document doit être ouvert.

.text

Texte à l'intérieur des balises HTML pour délimiter l'élément. Par exemple :

 <A>Ceci est une ancre<IMG src=map.gif></a>

La propriété text renvoie "Ceci est une ancre". Si des espaces consécutifs sont trouvés, ils sont combinés et réduits à un seul espace.

.title

Valeur de l'attribut title d'un élément. Il s'agit souvent du texte affiché lorsque le pointeur de la souris survole l'élément.

.type

Valeur de l'attribut type d'un élément. Par exemple, pour un élément INPUT, il peut s'agir de text, password, check box, radio, submit, image, reset, button, hidden ou file.

.url

URL du document.

.useMap

Valeur de l'attribut useMap d'un élément. Cette valeur est une chaîne spécifiant une URL. Elle est utilisée dans un élément image (IMG) pour indiquer une image cliquable côté client. L'URL pointe sur l'élément MAP associé à l'image cliquable. Souvent, il s'agit d'une référence relative (par rapport au document).

.value

Valeur de l'attribut value d'un élément. Dans le cas d'un élément de formulaire, il s'agit de la valeur envoyée lorsque le formulaire est soumis.

.vspace

Valeur de l'attribut vspace d'un élément. Il s'agit de l'espace (en pixels) inséré au-dessus ou en dessous d'un élément IMG, OBJECT ou APPLET.

.width

Valeur de l'attribut width d'un élément. Pour un élément image (IMG), il s'agit de la largeur d'affichage de l'image, en pixels.

.window

Fenêtre de "poids lourd" (heavy-weight window) de l'élément, renvoyée sous forme de 'long'. Pour un navigateur, il s'agit de la fenêtre de niveau supérieur.

 

 

Conditions d'utilisation | Appréciations en retour
(C) Copyright IBM Corporation 2002, 2004. All Rights Reserved.