Lisez-moi S.V.P. 

9 janvier 2003

1. Le modèle objet de document HTML

Rédacteurs :
Johnny Stenback, Netscape
Philippe Le Hégaret, W3C
Arnaud Le Hors, W3C et IBM (jusqu'en novembre 2000)

Table des matières

1.1. Introduction

Cette section étend l'interface de programmation d'application (API) DOM niveau 2 Core [DOM niveau 2 Core] afin de décrire des objets et des méthodes spécifiques aux documents HTML [HTML 4.01] et XHTML [XHTML 1.0]. Les fonctionnalités nécessaires pour manipuler les structures hiérarchiques des documents, des éléments et des attributs se trouvent en général dans la section Core ; en ce qui concerne les fonctionnalités qui dépendent d'éléments spécifiques définis dans HTML, elles se trouvent dans cette section.

Les buts de l'interface (API) DOM spécifique de HTML sont les suivants :

La différence principale entre le module DOM Core et l'application HTML du DOM, c'est que le modèle objet de document HTML expose un certain nombre de méthodes et propriétés commodes qui sont cohérentes avec les modèles existants et qui sont plus adaptées pour les développeurs de scripts. Dans beaucoup de cas, ces améliorations ne peuvent pas s'appliquer à un DOM général car elles reposent sur la présence d'une définition de type de document (DTD) prédéfinie. La présence des DTD « transitional » ou « frameset » HTML 4.01 ou des DTD XHTML 1.0 est présumée. L'interopérabilité entre les mises en œuvre est assurée seulement pour les éléments et attributs définis dans les DTD de HTML 4.01 et XHTML 1.0.

Plus particulièrement, ce document comprend les spécialisations HTML suivantes :

La spécification DOM niveau 2 comprend des mécanismes pour accéder et modifier le style établi au travers d'une feuille de style CSS et elle définit un modèle d'événement utilisable avec les documents HTML.

Les interfaces décrites dans cette section ne sont pas obligatoires. Une application DOM peut employer la méthode hasFeature(feature, version) de l'interface DOMImplementation, respectivement avec les valeurs de paramètre "HTML" et "2.0", pour déterminer si ce module est géré ou non par la mise en œuvre. Outre la chaîne de fonctionnalité "HTML", on peut employer la chaîne de fonctionnalité "XHTML" afin de vérifier si la mise en œuvre reconnaît XHTML (cela revient à vérifier les fonctionnalités "XML" et "HTML"). Pour une gestion complète de ce module, une mise en œuvre doit également gérer la fonctionnalité "Core" définie dans [DOM niveau 2 Core]. Pour d'autres renseignements, consulter la section à propos de la conformité→vf dans la spécification DOM niveau 2 Core [DOM niveau 2 Core].

Les interfaces dans cette spécification sont conçues pour les documents [HTML 4.01] et les documents [XHTML 1.0].

Remarque : Cette spécification ne définit pas la façon dont un agent utilisateur doit répondre à un changement sur un attribut d'un élément qui appelle directement ou indirectement des données externes, tels que les éléments HTMLAppletElement, HTMLFrameElement, HTMLFrameSetElement, HTMLIFrameElement, HTMLImageElement, HTMLLinkElement, HTMLObjectElement, HTMLParamElement, et HTMLScriptElement.

1.2. L'application HTML du module DOM Core

1.2.1. Les conventions de nommage

Le DOM HTML obéit à la convention de nommage suivante en ce qui concerne les propriétés, les méthodes, les événements, les collections et les types de données : tous les noms sont définis par un ou plusieurs mots anglais concaténés, le cas échéant, pour former une seule chaîne.

1.2.1.1. Les propriétés et les méthodes

Le nom de la propriété, ou de la méthode, commence par le mot-clé initial en minuscules et chaque mot suivant commence par une lettre en capitales. Par exemple, une propriété retournant des métainformations sur le document telle que la date de création du fichier pourrait se nommer fileDateCreated. Dans la liaison ECMAScript, les propriétés s'affichent en tant que propriétés d'un objet donné. En Java, les propriétés s'affichent selon les méthodes get (N.D.T. obtenir) et set (N.D.T. fixer).

1.2.1.2. Les interfaces et les attributs non-HTML 4.0

Quoique la plupart des interfaces décrites plus loin corresponde directement aux éléments définis dans la recommandation HTML 4.01, ce n'est pas le cas pour certaines interfaces. De même, les attributs listés ci-dessous n'ont pas tous un correspondant dans HTML 4.01 (certains attributs en ont un mais ils ont été renommés pour éviter les conflits avec les langages de script). Les définitions des interfaces et attributs, qui ont des liens avec la spécification HTML 4.0, y ont celles des éléments et attributs qui correspondent ; toutes les autres définitions sont ajoutées par cette spécification, soit par commodité, soit pour une question de rétrocompatibilité avec les mises en œuvre DOM niveau 0.

1.3. Le langage XHTML et le DOM HTML

Les interfaces de programmation d'application (API) DOM HTML niveau 1 [DOM niveau 1] étaient seulement prévues à l'origine pour servir avec les documents HTML 4.01 [HTML 4.01]. Ces interfaces ont été définies bien avant que XHTML 1.0 [XHTML 1.0] ne devienne une spécification ou que le groupe de travail HTML ne l'étudie.

Du point de vue du DOM, la différence majeure entre HTML 4.01 (et les versions antérieures) et XHTML 1.0 est la sensibilité à la casse de XHTML, au contraire de HTML 4.01. L'insensibilité à la casse de HTML est reflétée également dans l'interface (API) DOM HTML. Par exemple, les noms des éléments et attributs se présentent tout en majuscules (par souci de cohérence) quand on les utilise dans un document HTML, indépendamment de la casse des caractères employés dans le balisage. De même, les noms des attributs définis dans HTML 4.01 se présentent tout en minuscules, indépendamment de la casse des caractères dans le balisage ; par contre, la casse des autres attributs (c.à.d. ceux non définis par HTML 4.01) dépendra de la mise en œuvre. Puisque XHTML repose sur XML, tout est sensible à la casse en XHTML, et les noms des éléments et attributs devront être en minuscules dans le balisage.

Les développeurs doivent tenir compte de deux choses lorsqu'ils écrivent du code qui doit fonctionner aussi bien dans les documents HTML que les documents XHTML. Pour comparer des noms d'éléments ou d'attributs avec des chaînes, la comparaison doit être insensible à la casse, ou alors il faut convertir le nom de l'élément ou de l'attribut en minuscules avant de le comparer avec une chaîne en minuscules. Deuxièmement, pour appeler des méthodes qui sont insensibles à la casse quand elles sont employées dans un document HTML (telles que les méthodes getElementsByTagName() et namedItem()), la chaîne à leur passer devrait être en minuscules.

Remarque : Les interfaces fournies dans ce document s'appliquent seulement aux documents [HTML 4.01] et [XHTML 1.0], et elles ne fonctionneront peut-être plus avec une version future de XHTML.

1.4. Les définitions d'objets divers

L'interface HTMLCollection

Un objet HTMLCollection est une liste de nœuds. On peut accéder à un nœud individuel soit par un index ordinal, soit par les attributs name ou id du nœud.

Remarque : Dans le DOM HTML, les collections sont censées être vivantes, c'est-à-dire qu'elles sont automatiquement mises à jour quand le document sous-jacent a changé.

Définitions IDL
interface HTMLCollection {
  readonly attribute unsigned long   length;
  Node               item(in unsigned long index);
  Node               namedItem(in DOMString name);
};
Attributs
length de type unsigned long, en lecture seule
Cet attribut indique la longueur ou dimension de la liste.
Méthodes
item
Cette méthode retourne un nœud défini par un index ordinal. Les nœuds sont numérotés dans l'ordre de l'arbre (selon un ordre de traversée en profondeur d'abord).
Paramètres
index de type unsigned long
L'index du nœud à récupérer. L'index de départ est 0.
Valeur retournée

Node

L'objet Node à la position correspondante en cas de succès. La valeur null est retournée si l'index est hors d'intervalle.

Aucune exception
namedItem
Cette méthode récupère un objet Node par le nom. Avec les documents [HTML 4.01], elle recherche d'abord un objet Node dont l'attribut id correspond. Si elle n'en trouve pas, elle recherche alors un objet Node dont l'attribut name correspond, mais uniquement sur les éléments qui admettent un attribut name. Avec les documents [XHTML 1.0], cette méthode recherche seulement les objets Node dont l'attribut id correspond. La méthode est insensible à la casse dans les documents HTML et sensible à la casse dans les documents XHTML.
Paramètres
name de type DOMString
Le nom de l'objet Node à récupérer.
Valeur retournée

Node

L'objet Node avec un attribut name, ou id, dont la valeur correspond à la chaîne indiquée. En cas d'échec (par exemple, aucun nœud de ce nom n'existe), renvoie la valeur null.

Aucune exception
L'interface HTMLOptionsCollection (introduite dans DOM niveau 2)

Un objet HTMLOptionsCollection est une liste de nœuds représentant des éléments HTML option. On peut accéder à un nœud individuel soit par un index ordinal, soit par les attributs name ou id du nœud.

Remarque : Dans le DOM HTML, les collections sont censée être vivantes, c'est-à-dire qu'elles sont automatiquement mises à jour quand le document sous-jacent a changé.

Définitions IDL
// Introduit dans DOM niveau 2 :
interface HTMLOptionsCollection {
           attribute unsigned long   length;
                    // soulève une exception (DOMException) à l'initialisation

  Node               item(in unsigned long index);
  Node               namedItem(in DOMString name);
};
Attributs
length de type unsigned long
Cet attribut indique la longueur ou dimension de la liste.
Exceptions à l'initialisation

DOMException

NOT_SUPPORTED_ERR : Soulevée si la mise en œuvre ne permet pas de fixer la longueur.

Méthodes
item
Cette méthode récupère un nœud défini par un index ordinal. Les nœuds sont numérotés dans l'ordre de l'arbre (selon un ordre de traversée en profondeur d'abord).
Paramètres
index de type unsigned long
L'index du nœud à récupérer. L'index de départ est 0.
Valeur retournée

Node

L'objet Node à la position correspondante en cas de succès. La valeur null est retournée si l'index est hors d'intervalle.

Aucune exception
namedItem
Cette méthode récupère un objet Node par le nom. Elle recherche d'abord un objet Node dont l'attribut id correspond. Si elle n'en trouve pas, elle recherche alors un objet Node dont l'attribut name correspond, mais uniquement sur les éléments qui admettent un attribut name. La méthode est insensible à la casse dans les documents HTML et sensible à la casse dans les documents XHTML.
Paramètres
name de type DOMString
Le nom de l'objet Node à récupérer.
Valeur retournée

Node

L'objet Node avec un attribut name, ou id, dont la valeur correspond à la chaîne indiquée. En cas d'échec (par exemple, aucun nœud de ce nom n'existe), retourne la valeur null.

Aucune exception

1.5. Les objets associés aux documents HTML

L'interface HTMLDocument

Un objet HTMLDocument représente la racine de la hiérarchie HTML et porte la totalité du contenu. Hormis un accès à la hiérarchie, il offre aussi des méthodes commodes pour obtenir certains ensembles d'informations du document.

On déconseille les propriétés suivantes en faveur des celles de l'élément BODY qui correspondent :

  • alinkColor
  • background
  • bgColor
  • fgColor
  • linkColor
  • vlinkColor

Remarque : Dans le DOM niveau 2, la méthode getElementById est héritée de l'interface Document où elle a été déplacée.

Définitions IDL
interface HTMLDocument : Document {
           attribute DOMString       title;
  readonly attribute DOMString       referrer;
  readonly attribute DOMString       domain;
  readonly attribute DOMString       URL;
           attribute HTMLElement     body;
  readonly attribute HTMLCollection  images;
  readonly attribute HTMLCollection  applets;
  readonly attribute HTMLCollection  links;
  readonly attribute HTMLCollection  forms;
  readonly attribute HTMLCollection  anchors;
           attribute DOMString       cookie;
                    // soulève une exception (DOMException) à l'initialisation

  void               open();
  void               close();
  void               write(in DOMString text);
  void               writeln(in DOMString text);
  NodeList           getElementsByName(in DOMString elementName);
};
Attributs
URL de type DOMString, en lecture seule
L'adresse URI absolue [IETF RFC 2396] du document.
anchors de type HTMLCollection, en lecture seule
Une collection de tous les éléments ancres (A) dans un document, dont l'attribut name a une valeur.

Remarque : Pour une question de rétrocompatibilité, le jeu d'ancres retourné ne contient que les ancres créées avec un attribut name, et non celles créées avec un attribut id. Remarquer que, dans [XHTML 1.0], l'attribut name (cf. section 4.10) n'a aucune signification et qu'il n'est présent que pour les agents utilisateurs anciens : l'attribut id le remplace. Les utilisateurs devraient plutôt préférer les mécanismes d'itérateurs fournis par [DOM niveau 2 Traversal].

applets de type HTMLCollection, en lecture seule
Une collection de tous les éléments OBJECT, y compris les appliquettes, et les éléments APPLET (déconseillés) dans un document.
body de type HTMLElement
L'élément qui englobe le contenu du document. Dans les documents avec un contenu BODY, il retourne l'élément BODY. Dans les documents avec des cadres, il retourne l'élément FRAMESET le plus externe.
cookie de type DOMString
Cet attribut avec chaîne variable indique une information d'état persistente qui, premièrement, est associée au cadre ou au document courants et, deuxièmement, qui se compose d'informations décrites par le non-terminal cookies de [IETF RFC 2965], section 4.2.2.
Si aucune information d'état persistente n'est disponible pour le cadre ou le document courants, alors la valeur de cette propriété est une chaîne vide.
Quand cet attribut est lu, tous les cookies sont retournés en une seule chaîne, le couple nom-valeur de chaque cookie est concaténé en une liste de couples nom-valeur, et chaque article de la liste est séparé par un caractère point-virgule « ; ».
Quand cet attribut est fixé, la valeur à lui donner devrait être une chaîne obéissant à la définition du non-terminal cookie de [IETF RFC 2965] ; c'est-à-dire que sa valeur devrait être un couple nom-valeur unique suivi par une valeur d'attribut de cookie (zéro ou plus). Si aucun attribut domain n'est indiqué, alors l'attribut domain de la nouvelle valeur prend implicitement la valeur de la partie hôte de l'adresse URI absolue [IETF RFC 2396] du cadre ou du document courants. Si aucun attribut path n'est indiqué, alors l'attribut path de la nouvelle valeur prend implicitement la valeur de la partie chemin absolu de l'adresse URI [IETF RFC 2396] du cadre ou du document courants. Si aucun attribut max-age n'est indiqué, alors l'attribut max-age de la nouvelle valeur prend implicitement une valeur définie par l'agent utilisateur. Si un cookie avec le nom indiqué est déjà lié au cadre ou au document courants, alors la nouvelle valeur ainsi que les nouveaux attributs remplacent la valeur et les attributs précédents. Si un attribut max-age avec une valeur 0 est indiqué comme nouvelle valeur, alors tout cookie existant avec le nom indiqué est retiré du stock de cookies.

Remarque : Cf. [IETF RFC 2965] pour la sémantique des couples de valeur article-attribut d'état persistent.

Remarque : La nature exacte d'une session d'agent utilisateur n'est pas définie par cette spécification.

Exceptions à l'initialisation

DOMException

SYNTAX_ERR : Si la nouvelle valeur n'adhère pas à la syntaxe de cookie définie par [IETF RFC 2965].

domain de type DOMString, en lecture seule
Le nom de domaine du serveur qui a traité le document, ou la valeur null si le serveur ne peut pas être identifié par un nom de domaine.
forms de type HTMLCollection, en lecture seule
Une collection de tous les formulaires d'un document.
images de type HTMLCollection, en lecture seule
Une collection de tous les éléments IMG dans un document. Le comportement se limite aux éléments IMG pour une question de rétrocompatibilité.

Remarque : Comme suggéré par [HTML 4.01], les auteurs peuvent utiliser l'élément OBJECT comme l'élément IMG pour inclure des images. Il n'est donc pas recommandé de se servir de cet attribut pour retrouver les images dans le document mais les propriétés getElementsByTagName, avec HTML 4.01, ou getElementsByTagNameNS, avec XHTML 1.0.

links de type HTMLCollection, en lecture seule
Une collection de tous les éléments AREA et les éléments ancres (A), dont l'attribut href a une valeur, dans un document.
referrer de type DOMString, en lecture seule
Retourne l'adresse URI [IETF RFC 2396] de la page avec le lien menant à cette page. La valeur est une chaîne vide si l'utilisateur est arrivé directement sur la page (pas au travers d'un lien mais, par exemple, via un signet).
title de type DOMString
Le titre d'un document, comme indiqué par l'élément TITLE dans l'en-tête du document.
Méthodes
close
Ferme le flux d'un document ouvert par la méthode open() et force la restitution.
Aucun paramètre
Aucune valeur retournée
Aucune exception
getElementsByName
Avec les documents [HTML 4.01], cette méthode retourne la collection (qui peut être vide) des éléments dont la valeur de l'attribut name est donnée par le paramètre elementName. Avec les documents [XHTML 1.0], cette méthode ne retourne que la collection (qui peut être vide) des commandes de formulaire dont le nom correspond. Cette méthode est sensible à la casse.
Paramètres
elementName de type DOMString
La valeur de l'attribut name d'un élément.
Valeur retournée

NodeList

Les éléments qui correspondent.

Aucune exception
open
Ouvre un flux de document pour écriture. S'il existe un document dans la cible, cette méthode le supprime.

Remarque : Cette méthode et les suivantes permettent à l'utilisateur d'ajouter des chaînes HTML non interprétées au modèle de structure du document (ou de remplacer le modèle de structure par celles-ci). Lors de la rédaction de la spécification, des options étaient à l'étude afin de fournir des fonctionnalités similaires pour les documents HTML comme XML (cf. [DOM niveau 3 Load et Save]).

Aucun paramètre
Aucune valeur retournée
Aucune exception
write
Écrit une chaîne de texte dans le flux de document ouvert par la méthode open(). Remarquer que la fonction produira un document qui ne sera pas forcément sous le contrôle d'une définition de type de document (DTD) et elle aboutira donc peut-être à un résultat invalide dans le contexte du document.
Paramètres
text de type DOMString
La chaîne à analyser à l'intérieur d'une certaine structure dans le modèle de structure du document.
Aucune valeur retournée
Aucune exception
writeln
Écrit une chaîne de texte suivie par un caractère retour à la ligne dans un document ouvert par la méthode open(). Remarquer que la fonction produira un document qui ne sera pas forcément sous le contrôle d'une définition de type de document (DTD) et elle aboutira donc peut-être à un résultat invalide dans le contexte du document.
Paramètres
text de type DOMString
La chaîne à analyser à l'intérieur d'une certaine structure dans le modèle de structure du document.
Aucune valeur retournée
Aucune exception

1.6. Les éléments HTML

1.6.1. Les attributs des propriétés

Les attributs HTML se présentent comme propriétés sur l'objet élément. Les conventions de nommage du DOM déterminent toujours le nom de la propriété exposée et sont indépendantes de la casse de l'attribut dans le document source. Le type de données de la propriété est généralement déterminé par le type de l'attribut, comme déterminé par les DTD de HTML 4.01 (transitional et frameset) et de XHTML 1.0. Les attributs ont la sémantique (dont la sensibilité à la casse) définie dans les spécifications [HTML 4.01] et [XHTML 1.0].

Les attributs sont présentés comme des propriétés pour une question de compatibilité avec DOM niveau 0. Cet usage est déconseillé car on ne peut pas le généraliser à tous les noms d'attribut possibles de XML. Nous recommandons d'utiliser des méthodes génériques sur l'interface élémentaire Element pour affecter, lire ou supprimer les attributs.

Type de données du DTD Type des données du modèle objet
CDATA DOMString
Liste de valeurs, par exemple, (left | right | center) DOMString
Liste de valeurs avec une valeur unique, par exemple, (disabled) boolean
Nombre long int

Dans un document HTML, la valeur de retour d'un attribut dont le type de données est une liste de valeur se normalise en minuscules (indépendamment de la casse de la valeur dans le document source).

Par exemple, si la valeur de l'attribut align sur un élément P est "Left" (qui n'est pas une valeur admise en XHTML à cause de la sensibilité à la casse de XHTML), alors la valeur retournée est "left". Pour les attributs avec le type de données CDATA, la casse de la valeur retournée est celle donnée dans le document source.

La valeur retournée d'un attribut non défini et sans valeur implicite est la chaîne vide si son type est DOMString, la valeur false si c'est un type booléen et "0" si c'est un type numérique.

1.6.2. Les exceptions de nommage

Afin d'éviter les conflits entre espaces de nommage, nous avons préfixé deux attributs qui avaient le même nom qu'un mot-clé trouvé dans l'un de nos langages de liaison. L'attribut for des éléments LABEL et SCRIPT se heurte aux conventions de nommage d'une structure de boucle : il a été renommé htmlFor. L'attribut class des éléments HTML se heurte aux conventions de nommage des définitions de classes : il a été renommé className.

1.6.3. L'exposition des noms des types d'élément (tagName, (nodeName))

Lorsqu'il s'agit d'un document HTML 4.01, les noms des types d'élément exposés au travers d'une propriété sont en majuscules. Par exemple, le nom du type d'élément body se présente au travers de la propriété tagName comme BODY. Lorsqu'il s'agit d'un document XHTML 1.0, le nom de l'élément est exposé comme écrit dans le fichier XHTML. C'est-à-dire que les noms des types d'élément se présentent en minuscules pour les documents XHTML, puisque les DTD de XHTML 1.0 définissent les noms des types d'élément en minuscules et puisque XHTML, qui est dérivé de XML, est sensible à la casse.

1.6.4. L'interface HTMLElement

L'interface HTMLElement

Toutes les interfaces des éléments HTML dérivent de cette classe. Les éléments qui exposent seulement les attributs HTML principaux sont représentés par l'interface de base HTMLElement. Ces éléments sont les suivants :

  • ceux spéciaux : SUB, SUP, SPAN, BDO
  • ceux concernant les polices : TT, I, B, U, S, STRIKE, BIG, SMALL
  • ceux concernant les phrases : EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBR
  • ceux concernant les listes : DD, DT
  • NOFRAMES, NOSCRIPT
  • ADDRESS, CENTER

Remarque : L'attribut style d'un élément HTML est accessible au travers de l'interface ElementCSSInlineStyle, qui est définie dans le module CSS [DOM niveau 2 Style].

Définitions IDL
interface HTMLElement : Element {
           attribute DOMString       id;
           attribute DOMString       title;
           attribute DOMString       lang;
           attribute DOMString       dir;
           attribute DOMString       className;
};
Attributs
className de type DOMString
L'attribut class de l'élément. Cet attribut a été renommé pour cause de conflits avec le mot-clé "class" exposé par beaucoup langages. Cf. la définition de l'attribut class→vf dans HTML 4.01.
dir de type DOMString
Indique la direction de base d'un texte neutre vis-à-vis de la direction, et la directionnalité des tables. Cf. la définition de l'attribut dir→vf dans HTML 4.01.
id de type DOMString
L'identificateur de l'élément. Cf. la définition de l'attribut id→vf dans HTML 4.01.
lang de type DOMString
Le code de langue défini dans RFC 1766. Cf. la définition de l'attribut lang→vf dans HTML 4.01.
title de type DOMString
Le titre consultatif de l'élément. Cf. la définition de l'attribut title→vf dans HTML 4.01.

1.6.5. Les définitions des objets

L'interface HTMLHtmlElement

La racine d'un document HTML. Cf. la définition de l'élément HTML→vf dans HTML 4.01.

Définitions IDL
interface HTMLHtmlElement : HTMLElement {
           attribute DOMString       version;
};
Attributs
version de type DOMString
L'information de version de la définition de type (DTD) du document. Cf. la définition de l'attribut version→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLHeadElement

Les informations de l'en-tête du document. Cf. la définition de l'élément HEAD→vf dans HTML 4.01.

Définitions IDL
interface HTMLHeadElement : HTMLElement {
           attribute DOMString       profile;
};
Attributs
profile de type DOMString
L'adresse URI [IETF RFC 2396] désignant un profil de métadonnées. Cf. la définition de l'attribut profile→vf dans HTML 4.01.
L'interface HTMLLinkElement

L'élément LINK indique un lien vers une ressource externe et définit la relation du document vis-à-vis de cette ressource (ou vice versa). Cf. la définition de l'élément LINK→vf dans HTML 4.01 (voir aussi l'interface LinkStyle dans le module Style [DOM niveau 2 Style]).

Définitions IDL
interface HTMLLinkElement : HTMLElement {
           attribute boolean         disabled;
           attribute DOMString       charset;
           attribute DOMString       href;
           attribute DOMString       hreflang;
           attribute DOMString       media;
           attribute DOMString       rel;
           attribute DOMString       rev;
           attribute DOMString       target;
           attribute DOMString       type;
};
Attributs
charset de type DOMString
Le codage de caractères de la ressource liée. Cf. la définition de l'attribut charset→vf dans HTML 4.01.
disabled de type boolean
Active/désactive le lien. On ne l'utilise pour l'instant que pour les liens vers des feuilles de style, afin de les activer ou de les désactiver.
href de type DOMString
L'adresse URI [IETF RFC 2396] de la ressource liée. Voir la définition de l'attribut href dans HTML 4.01.
hreflang de type DOMString
Le code de langue de la ressource liée. Cf. la définition de l'attribut hreflang→vf dans HTML 4.01.
media de type DOMString
Prévu pour servir avec un ou plusieurs médias cibles. Cf. la définition de l'attribut media→vf dans HTML 4.01.
rel de type DOMString
Le type de la liaison où aller. Cf. la définition de l'attribut rel→vf dans HTML 4.01.
rev de type DOMString
Le type de la liaison où revenir. Cf. la définition de l'attribut rev→vf dans HTML 4.01.
target de type DOMString
Le cadre dans lequel restituer la ressource. Cf. la définition de l'attribut target→vf dans HTML 4.01.
type de type DOMString
Un type de contenu consultatif. Cf. la définition de l'attribut type→vf dans HTML 4.01.
L'interface HTMLTitleElement

Le titre du document. Cf. la définition de l'élément TITLE→vf dans HTML 4.01.

Définitions IDL
interface HTMLTitleElement : HTMLElement {
           attribute DOMString       text;
};
Attributs
text de type DOMString
Le titre indiqué sous forme d'une chaîne.
L'interface HTMLMetaElement

Cet objet contient les métainformations génériques à propos du document. Cf. la définition de l'élément META→vf dans HTML 4.01.

Définitions IDL
interface HTMLMetaElement : HTMLElement {
           attribute DOMString       content;
           attribute DOMString       httpEquiv;
           attribute DOMString       name;
           attribute DOMString       scheme;
};
Attributs
content de type DOMString
Des informations associées. Cf. la définition de l'attribut content→vf dans HTML 4.01.
httpEquiv de type DOMString
Le nom de l'en-tête de réponse HTTP [IETF RFC 2616]. Cf. la définition de l'attribut http-equiv→vf dans HTML 4.01.
name de type DOMString
Le nom de la métainformation. Cf. la définition de l'attribut name→vf dans HTML 4.01.
scheme de type DOMString
La forme de sélection du contenu. Cf. la définition de l'attribut scheme→vf dans HTML 4.01.
L'interface HTMLBaseElement

L'adresse URI de base du document [IETF RFC 2396]. Cf. la définition de l'élément BASE→vf dans HTML 4.01.

Définitions IDL
interface HTMLBaseElement : HTMLElement {
           attribute DOMString       href;
           attribute DOMString       target;
};
Attributs
href de type DOMString
L'adresse URI de base [IETF RFC 2396]. Cf. la définition de l'attribut href→vf dans HTML 4.01.
target de type DOMString
Le cadre cible par défaut. Cf. la définition de l'attribut target→vf dans HTML 4.01.
L'interface HTMLIsIndexElement

Cet élément sert pour une entrée de texte sur une seule ligne. Cf. la définition de l'élément ISINDEX→vf dans HTML 4.01. Cet élément est déconseillé dans HTML 4.01.

Définitions IDL
interface HTMLIsIndexElement : HTMLElement {
  readonly attribute HTMLFormElement form;
           attribute DOMString       prompt;
};
Attributs
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM qui contient cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
prompt de type DOMString
Le message d'invite. Cf. la définition de l'attribut prompt→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLStyleElement

L'information de style. Cf. la définition de l'élément STYLE→vf dans HTML 4.01, le module CSS [DOM niveau 2 Style] et l'interface LinkStyle dans le module Style [DOM niveau 2 Style].

Définitions IDL
interface HTMLStyleElement : HTMLElement {
           attribute boolean         disabled;
           attribute DOMString       media;
           attribute DOMString       type;
};
Attributs
disabled de type boolean
Active/désactive la feuille de style.
media de type DOMString
Prévu pour une utilisation avec un ou plusieurs médias cibles. Cf. la définition de l'attribut media→vf dans HTML 4.01.
type de type DOMString
Le type de contenu du langage de feuille de style. Cf. la définition de l'attribut type→vf dans HTML 4.01.
L'interface HTMLBodyElement

Le corps du document HTML. Cet élément est toujours présent dans l'interface de programmation d'application (API) du DOM, même si les balises ne le sont pas dans le document source. Cf. la définition de l'élément BODY→vf dans HTML 4.01.

Définitions IDL
interface HTMLBodyElement : HTMLElement {
           attribute DOMString       aLink;
           attribute DOMString       background;
           attribute DOMString       bgColor;
           attribute DOMString       link;
           attribute DOMString       text;
           attribute DOMString       vLink;
};
Attributs
aLink de type DOMString
La couleur des liens activés (après avoir pressé le bouton de la souris mais avant de le relâcher). Cf. la définition de l'attribut alink→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
background de type DOMString
L'adresse URI [IETF RFC 2396] de l'image en mosaïque à l'arrière-plan. Cf. la définition de l'attribut background→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
bgColor de type DOMString
La couleur d'arrière-plan du document. Cf. la définition de l'attribut bgcolor→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
link de type DOMString
La couleur des liens qui ne sont pas activés ni visités. Cf. la définition de l'attribut link→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
text de type DOMString
La couleur du texte du document. Cf. la définition de l'attribut text→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
vLink de type DOMString
La couleur des liens qui ont été visités par l'utilisateur. Cf. la définition de l'attribut vlink→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLFormElement

L'élément FORM englobe des comportements similaires à ceux d'une collection et d'un élément. Il fournit un accès direct aux commandes de formulaire englobées ainsi qu'aux attributs de l'élément FORM. Cf. la définition de l'élément FORM→vf dans HTML 4.01.

Définitions IDL
interface HTMLFormElement : HTMLElement {
  readonly attribute HTMLCollection  elements;
  readonly attribute long            length;
           attribute DOMString       name;
           attribute DOMString       acceptCharset;
           attribute DOMString       action;
           attribute DOMString       enctype;
           attribute DOMString       method;
           attribute DOMString       target;
  void               submit();
  void               reset();
};
Attributs
acceptCharset de type DOMString
Une liste de jeux de caractères reconnus par le serveur. Cf. la définition de l'attribut accept-charset→vf dans HTML 4.01.
action de type DOMString
Un gestionnaire de formulaire côté serveur. Cf. la définition de l'attribut action→vf dans HTML 4.01.
elements de type HTMLCollection, en lecture seule
Retourne la collection de tous les éléments commande de formulaire du formulaire.
enctype de type DOMString
Le type de contenu du formulaire soumis, en général "application/x-www-form-urlencoded". Cf. la définition de l'attribut enctype→vf dans HTML 4.01.

Remarque : Le gestionnaire d'événement onsubmit n'est pas forcément sollicité quand on invoque cette méthode. Le comportement est incohérent pour des raisons historiques et les auteurs ne devraient pas en attendre un comportement particulier.

length de type long, en lecture seule
Le nombre de commandes de formulaire du formulaire.
method de type DOMString
La méthode HTTP [IETF RFC 2616] employée pour soumettre le formulaire. Cf. la définition de l'attribut method→vf dans HTML 4.01.
name de type DOMString
Nomme le formulaire.
target de type DOMString
Le cadre dans lequel restituer la ressource. Cf. la définition de l'attribut target→vf dans HTML 4.01.
Méthodes
reset
Rétablit les valeurs par défaut des éléments du formulaire. Elle produit la même action qu'un bouton de type reset.
Aucun paramètre
Aucune valeur retournée
Aucune exception
submit
Soumet le formulaire. Elle produit la même action qu'un bouton de type submit.
Aucun paramètre
Aucune valeur retournée
Aucune exception
L'interface HTMLSelectElement

L'élément select permet de sélectionner une option. On peut accéder directement aux options contenues au travers de l'élément select en tant que collection. Cf. la définition de l'élément SELECT→vf dans HTML 4.01.

Définitions IDL
interface HTMLSelectElement : HTMLElement {
  readonly attribute DOMString       type;
           attribute long            selectedIndex;
           attribute DOMString       value;
  // Modifié dans DOM niveau 2 :
           attribute unsigned long   length;
                    // soulève une exception (DOMException) à l'initialisation

  readonly attribute HTMLFormElement form;
  // Modifié dans DOM niveau 2 :
  readonly attribute HTMLOptionsCollection options;
           attribute boolean         disabled;
           attribute boolean         multiple;
           attribute DOMString       name;
           attribute long            size;
           attribute long            tabIndex;
  void               add(in HTMLElement element, 
                         in HTMLElement before)
                                        raises(DOMException);
  void               remove(in long index);
  void               blur();
  void               focus();
};
Attributs
disabled de type boolean
La commande est indisponible dans ce contexte. Cf. la définition de l'attribut disabled→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
length de type unsigned long, modifié dans DOM niveau 2
Le nombre d'options dans cet élément SELECT.
Exceptions à l'initialisation

DOMException

NOT_SUPPORTED_ERR : Soulevée si la mise en œuvre ne permet pas de fixer la longueur.

multiple de type boolean
Si la valeur est "true", on peut sélectionner plusieurs éléments OPTION dans cet élément SELECT. Cf. la définition de l'attribut multiple→vf dans HTML 4.01.
name de type DOMString
Le nom d'une commande ou d'un objet de formulaire, lorsqu'il est soumis par un formulaire. Cf. la définition de l'attribut name→vf dans HTML 4.01.
options de type HTMLOptionsCollection, en lecture seule, modifié dans DOM niveau 2
La collection des éléments OPTION contenue par cet élément.
selectedIndex de type long
L'index ordinal de l'option sélectionnée, commençant à "0". La valeur "-1" est retournée si aucun élément n'est sélectionné. Si plusieurs options sont sélectionnées, l'index de la première option est retourné.
size de type long
Le nombre de rangées visibles. Cf. la définition de l'attribut size→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
type de type DOMString, en lecture seule
Le type de cette commande de formulaire. C'est la chaîne "select-multiple" quand l'attribut multiple a la valeur true et la chaîne "select-one" pour la valeur false.
value de type DOMString
La valeur de la commande de formulaire courante (c.à.d., la valeur de l'option sélectionnée) ; si plusieurs options sont sélectionnées, c'est la valeur de la première option.
Méthodes
add
Ajoute un nouvel élément à la collection des éléments OPTION de cet élément SELECT. Cette méthode équivaut à la méthode appendChild de l'interface Node, si le paramètre before a la valeur null. Elle équivaut à la méthode insertBefore sur le parent de before dans tous les autres cas. Cette méthode peut n'avoir aucun effet si le nouvel élément n'est pas un élément OPTION, ou OPTGROUP.
Paramètres
element de type HTMLElement
L'élément à ajouter.
before de type HTMLElement
L'élément à insérer avant, ou la valeur null pour la queue de liste.
Exceptions

DOMException

NOT_FOUND_ERR : Soulevée si before n'est pas un descendant de l'élément SELECT.

Aucune valeur retournée
blur
Enlève l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
focus
Donne l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
remove
Retire un élément de la collection des éléments OPTION de cet élément SELECT. Rien ne se passe si aucun élément n'a l'index fourni.
Paramètres
index de type long
L'index de l'article à retirer, commençant à "0".
Aucune valeur retournée
Aucune exception
L'interface HTMLOptGroupElement

Regroupe les options en sous-divisions logiques. Cf. la définition de l'élément OPTGROUP→vf dans HTML 4.01.

Définitions IDL
interface HTMLOptGroupElement : HTMLElement {
           attribute boolean         disabled;
           attribute DOMString       label;
};
Attributs
disabled de type boolean
La commande est indisponible dans ce contexte. Cf. la définition de l'attribut disabled→vf dans HTML 4.01.
label de type DOMString
Attribue une étiquette à ce groupe d'options. Cf. la définition de l'attribut label→vf dans HTML 4.01.
L'interface HTMLOptionElement

Un choix sélectionnable. Cf. la définition de l'élément OPTION→vf dans HTML 4.01.

Définitions IDL
interface HTMLOptionElement : HTMLElement {
  readonly attribute HTMLFormElement form;
  // Modifié dans DOM niveau 2 :
           attribute boolean         defaultSelected;
  readonly attribute DOMString       text;
  // Modifié dans DOM niveau 2 :
  readonly attribute long            index;
           attribute boolean         disabled;
           attribute DOMString       label;
           attribute boolean         selected;
           attribute DOMString       value;
};
Attributs
defaultSelected de type boolean, modifié dans DOM niveau 2
Représente la valeur de l'attribut HTML sélectionné. La valeur de cet attribut ne change pas si, pour un agent utilisateur interactif, l'état de la commande de formulaire correspondante change. Cf. la définition de l'attribut selected→vf dans HTML 4.01.
disabled de type boolean
La commande est indisponible dans ce contexte. Cf. la définition de l'attribut disabled→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
index de type long, en lecture seule, modifié dans DOM niveau 2
L'index de cet élément OPTION dans son parent SELECT, commençant à "0".
label de type DOMString
Une étiquette d'option qui sert dans les menus hiérarchiques. Cf. la définition de l'attribut label→vf dans HTML 4.01.
selected de type boolean
Représente l'état courant de la commande de formulaire correspondante pour un agent utilisateur interactif. Le changement de cet attribut change l'état de la commande de formulaire mais pas la valeur de l'attribut HTML selected de l'élément.
text de type DOMString, en lecture seule
Le texte contenu dans l'élément option.
value de type DOMString
La valeur courante de la commande de formulaire. Cf. la définition de l'attribut value→vf dans HTML 4.01.
L'interface HTMLInputElement

Une commande de formulaire.

Remarque : Selon l'environnement dans lequel la page est vue, la propriété value peut être en lecture seule pour le type input d'un fichier à charger sur le serveur. Pour la valeur de type input "password", la valeur réelle retournée peut être dissimulée afin de prévenir une utilisation non autorisée. Cf. la définiton de l'élément INPUT→vf dans [HTML 4.01].

Définitions IDL
interface HTMLInputElement : HTMLElement {
           attribute DOMString       defaultValue;
           attribute boolean         defaultChecked;
  readonly attribute HTMLFormElement form;
           attribute DOMString       accept;
           attribute DOMString       accessKey;
           attribute DOMString       align;
           attribute DOMString       alt;
           attribute boolean         checked;
           attribute boolean         disabled;
           attribute long            maxLength;
           attribute DOMString       name;
           attribute boolean         readOnly;
  // Modifié dans DOM niveau 2 :
           attribute unsigned long   size;
           attribute DOMString       src;
           attribute long            tabIndex;
  // Modifié dans DOM niveau 2 :
           attribute DOMString       type;
           attribute DOMString       useMap;
           attribute DOMString       value;
  void               blur();
  void               focus();
  void               select();
  void               click();
};
Attributs
accept de type DOMString
La liste des types de contenu, séparés par des virgules, que gère correctement le serveur auquel le formulaire sera transmis. Cf. la définition de l'attribut accept→vf dans HTML 4.01.
accessKey de type DOMString
Une seule touche de caractère pour accéder à la commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
align de type DOMString
Aligne cet objet (verticalement ou horizontalement) par rapport au texte qui l'entoure. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
alt de type DOMString
Le texte de remplacement pour les agents utilisateurs incapables de restituer normalement le contenu de cet élément. Cf. la définition de l'attribut alt→vf dans HTML 4.01.
checked de type boolean
Quand l'attribut type de l'élément a la valeur "radio" ou "checkbox", pour un agent utilisateur interactif, cet attribut représente l'état actuel de la commande de formulaire. Le changement de la valeur de cet attribut change l'état de la commande de formulaire mais pas celle de l'attribut HTML checked de l'élément INPUT.

Remarque : Pendant la manipulation d'un événement click sur un élément input dont l'attribut type a la valeur "radio" ou "checkbox", il peut arriver que certaines mises en œuvre changent la valeur de cette propriété avant que l'événement ne se propage dans le document. Si l'action implicite de l'événement est annulée, la valeur de la propriété peut reprendre sa valeur originale. C'est-à-dire que la valeur de la propriété au cours de la manipulation des événements click dépend de la mise en œuvre.

defaultChecked de type boolean
Quand l'attribut type a la valeur "radio" ou "checkbox", cet attribut représente l'attribut HTML checked de l'élément. La valeur de cet attribut ne change pas si, pour un agent utilisateur interactif, l'état de la commande de formulaire correspondante change. Cf. la définition de l'attribut checked→vf dans HTML 4.01.
defaultValue de type DOMString
Quand l'attribut type de l'élément a la valeur "text", "file" ou "password", cet attribut représente l'attribut HTML value de l'élément. La valeur de cet attribut ne change pas si, pour un agent utilisateur interactif, le contenu de la commande de formulaire correspondante change. Cf. la définition de l'attribut value→vf dans HTML 4.01.
disabled de type boolean
La commande est indisponible dans ce contexte. Cf. la définition de l'attribut disabled→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
maxLength de type long
Le nombre maximum de caractères des zones de texte quand l'attribut type a la valeur "text" ou "password". Cf. la définition de l'attribut maxlength→vf dans HTML 4.01.
name de type DOMString
Le nom d'une commande ou d'un objet de formulaire dans une soumission de formulaire. Cf. la définition de l'attribut name→vf dans HTML 4.01.
readOnly de type boolean
Cette commande est en lecture seule. N'a de sens que si l'attribut type a la valeur "text" ou "password". Cf. la définition de l'attribut readonly→vf dans HTML 4.01.
size de type unsigned long, modifié dans DOM niveau 2
Une information de dimension. La signification précise est propre à chaque type de champ. Cf. la définition de l'attribut size→vf dans HTML 4.01.
src de type DOMString
Quand l'attribut type a la valeur "image", cet attribut indique l'emplacement de l'image à utiliser afin de décorer le bouton de soumission graphique. Cf. la définition de l'attribut src→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
type de type DOMString, modifié dans DOM niveau 2
Le type de la commande créée (tout en minuscules). Cf. la définition de l'attribut type→vf dans HTML 4.01.
useMap de type DOMString
Utilisation d'images cliquables côté client. Cf. la définition de l'attribut usemap→vf dans HTML 4.01.
value de type DOMString
Quand l'attribut type de l'élément a la valeur "text", "file" ou "password", pour un agent utilisateur interactif, cet attribut représente le contenu actuel de la commande de formulaire correspondante. Le changement de cet attribut change le contenu de la commande de formulaire mais pas la valeur de l'attribut HTML value de l'élément. Quand l'attribut type de l'élément a la valeur "button", "hidden", "submit", "reset", "image", "checkbox" ou "radio", cet attribut représente l'attribut HTML value de l'élément. Cf. la définition de l'attribut value→vf dans HTML 4.01.
Méthodes
blur
Enlève l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
click
Simule un clic de souris. Pour les éléments INPUT dont l'attribut type a l'une des valeurs suivantes : "button", "checkbox", "radio", "reset" ou "submit".
Aucun paramètre
Aucune valeur retournée
Aucune exception
focus
Donne l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
select
Sélectionne le contenu de l'aire de texte. Pour les éléments INPUT dont l'attribut type a l'une des valeurs suivantes : "text", "file" ou "password".
Aucun paramètre
Aucune valeur retournée
Aucune exception
L'interface HTMLTextAreaElement

Une zone de saisie multiligne. Cf. la définition de l'élément TEXTAREA→vf dans HTML 4.01.

Définitions IDL
interface HTMLTextAreaElement : HTMLElement {
  // Modifié dans DOM niveau 2 :
           attribute DOMString       defaultValue;
  readonly attribute HTMLFormElement form;
           attribute DOMString       accessKey;
           attribute long            cols;
           attribute boolean         disabled;
           attribute DOMString       name;
           attribute boolean         readOnly;
           attribute long            rows;
           attribute long            tabIndex;
  readonly attribute DOMString       type;
           attribute DOMString       value;
  void               blur();
  void               focus();
  void               select();
};
Attributs
accessKey de type DOMString
Une seule touche de caractère pour accéder à une commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
cols de type long
La largeur (en caractères) de la commande. Cf. la définition de l'attribut cols→vf dans HTML 4.01.
defaultValue de type DOMString, modifié dans DOM niveau 2
Représente le contenu de l'élément. La valeur de cet attribut ne change pas si, pour un agent utilisateur interactif, le contenu de la commande de formulaire correspondante change.
disabled de type boolean
La commande est indisponible dans ce contexte. Cf. la définition de l'attribut disabled→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
name de type DOMString
Le nom d'une commande ou d'un objet de formulaire dans une soumission de formulaire. Cf. la définition de l'attribut name→vf dans HTML 4.01.
readOnly de type boolean
Cette commande est en lecture seule. Cf. la définition de l'attribut readonly→vf dans HTML 4.01.
rows de type long
Le nombre de rangées du texte. Cf. la définition de l'attribut rows→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
type de type DOMString, en lecture seule
Le type de cette commande de formulaire. C'est la chaîne "textarea".
value de type DOMString
Représente le contenu courant de la commande de formulaire correspondante pour un agent utilisateur interactif. Le changement de cet attribut change le contenu de la commande de formulaire mais ne change pas le contenu de l'élément. Si les données ne tiennent pas entièrement dans un seul objet DOMString, la mise en œuvre peut les tronquer.
Méthodes
blur
Enlève l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
focus
Donne l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
select
Sélectionne le contenu de l'élément TEXTAREA.
Aucun paramètre
Aucune valeur retournée
Aucune exception
L'interface HTMLButtonElement

Un bouton à presser. Cf. la définition de l'élément BUTTON→vf dans HTML 4.01.

Définitions IDL
interface HTMLButtonElement : HTMLElement {
  readonly attribute HTMLFormElement form;
           attribute DOMString       accessKey;
           attribute boolean         disabled;
           attribute DOMString       name;
           attribute long            tabIndex;
  readonly attribute DOMString       type;
           attribute DOMString       value;
};
Attributs
accessKey de type DOMString
Une touche de caractère pour accéder à la commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
disabled de type boolean
La commande est indisponible dans ce contexte. Cf. la définition de l'attribut disabled→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
name de type DOMString
Le nom d'une commande ou d'un objet de formulaire dans une soumission de formulaire. Cf. la définition de l'attribut name→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
type de type DOMString, en lecture seule
Le type de bouton (tout en minuscules). Cf. la définition de l'attribut type→vf dans HTML 4.01.
value de type DOMString
La valeur courante de la commande de formulaire. Cf. la définition de l'attribut value→vf dans HTML 4.01.
L'interface HTMLLabelElement

L'intitulé de l'étiquette d'un champ de formulaire. Cf. la définition de l'élément LABEL→vf dans HTML 4.01.

Définitions IDL
interface HTMLLabelElement : HTMLElement {
  readonly attribute HTMLFormElement form;
           attribute DOMString       accessKey;
           attribute DOMString       htmlFor;
};
Attributs
accessKey de type DOMString
Une touche de caractère pour accéder à la commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
htmlFor de type DOMString
Cet attribut relie cette étiquette à une autre commande de formulaire par le biais de l'attribut id. Cf. la définition de l'attribut for→vf dans HTML 4.01.
L'interface HTMLFieldSetElement

Arrange les commandes de formulaire en groupes logiques. Cf. la définition de l'élément FIELDSET→vf dans HTML 4.01.

Définitions IDL
interface HTMLFieldSetElement : HTMLElement {
  readonly attribute HTMLFormElement form;
};
Attributs
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
L'interface HTMLLegendElement

Fournit une légende pour le regroupement produit par un élément FIELDSET. Cf. la définition de l'élément LEGEND→vf dans HTML 4.01.

Définitions IDL
interface HTMLLegendElement : HTMLElement {
  readonly attribute HTMLFormElement form;
           attribute DOMString       accessKey;
           attribute DOMString       align;
};
Attributs
accessKey de type DOMString
Une touche de caractère pour accéder à la commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
align de type DOMString
Un alignement de texte par rapport à un élément FIELDSET. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
L'interface HTMLUListElement

Une liste non ordonnée. Cf. la définition de l'élément UL→vf dans HTML 4.01.

Définitions IDL
interface HTMLUListElement : HTMLElement {
           attribute boolean         compact;
           attribute DOMString       type;
};
Attributs
compact de type boolean
Réduit l'espacement entre les articles de la liste. Cf. la définition de l'attribut compact→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
type de type DOMString
Le style d'une puce. Cf. la définition de l'attribut type→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLOListElement

Une liste ordonnée. Cf. la définition de l'élément OL→vf dans HTML 4.01.

Définitions IDL
interface HTMLOListElement : HTMLElement {
           attribute boolean         compact;
           attribute long            start;
           attribute DOMString       type;
};
Attributs
compact de type boolean
Réduit l'espacement entre les articles d'une liste. Cf. la définition de l'attribut compact→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
start de type long
Le numéro de séquence initial. Cf. la définition de l'attribut start→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
type de type DOMString
Le style du numérotage. Cf. la définition de l'attribut type→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLDListElement

Une liste de définitions. Cf. la définition de l'élément DL→vf dans HTML 4.01.

Définitions IDL
interface HTMLDListElement : HTMLElement {
           attribute boolean         compact;
};
Attributs
compact de type boolean
Réduit l'espacement entre les articles d'une liste. Cf. la définition de l'attribut compact→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLDirectoryElement

Une liste de répertoire. Cf. la définition de l'élément DIR→vf dans HTML 4.01. Cet élément est déconseillé dans HTML 4.01.

Définitions IDL
interface HTMLDirectoryElement : HTMLElement {
           attribute boolean         compact;
};
Attributs
compact de type boolean
Réduit l'espacement entre les articles d'une liste. Cf. la définition de l'attribut compact→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLMenuElement

Une liste de menus. Cf. la définition de l'élément MENU→vf dans HTML 4.01. Cet élément est déconseillé dans HTML 4.01.

Définitions IDL
interface HTMLMenuElement : HTMLElement {
           attribute boolean         compact;
};
Attributs
compact de type boolean
Réduit l'espacement entre les articles d'une liste. Cf. la définition de l'attribut compact→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLLIElement

Un élément de liste. Cf. la définition de l'élément LI→vf dans HTML 4.01.

Définitions IDL
interface HTMLLIElement : HTMLElement {
           attribute DOMString       type;
           attribute long            value;
};
Attributs
type de type DOMString
Le style de la puce d'un article de liste. Cf. la définition de l'attribut type→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
value de type long
Réinitialise le numérotage de la séquence lorsque l'attribut est utilisé dans un élément OL. Cf. la définition de l'attribut value→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLDivElement

Un bloc conteneur générique. Cf. la définition de l'élément DIV→vf dans HTML 4.01.

Définitions IDL
interface HTMLDivElement : HTMLElement {
           attribute DOMString       align;
};
Attributs
align de type DOMString
L'alignement horizontal du texte. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLParagraphElement

Un paragraphe. Cf. la définition de l'élément P→vf dans HTML 4.01.

Définitions IDL
interface HTMLParagraphElement : HTMLElement {
           attribute DOMString       align;
};
Attributs
align de type DOMString
L'alignement horizontal du texte. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLHeadingElement

Pour les éléments H1 à H6. Cf. la définition de l'élément H1→vf dans HTML 4.01.

Définitions IDL
interface HTMLHeadingElement : HTMLElement {
           attribute DOMString       align;
};
Attributs
align de type DOMString
L'alignement horizontal du texte. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLQuoteElement

Pour les éléments Q et BLOCKQUOTE. Cf. les définitions des éléments Q et BLOCKQUOTE→vf dans HTML 4.01.

Définitions IDL
interface HTMLQuoteElement : HTMLElement {
           attribute DOMString       cite;
};
Attributs
cite de type DOMString
L'adresse URI [IETF RFC 2396] désignant un document source ou un message. Cf. la définition de l'attribut cite→vf dans HTML 4.01.
L'interface HTMLPreElement

Un texte préformaté. Cf. la définition de l'élément PRE→vf dans HTML 4.01.

Définitions IDL
interface HTMLPreElement : HTMLElement {
           attribute long            width;
};
Attributs
width de type long
Une largeur fixe pour le contenu. Cf. la définition de l'attribut width→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLBRElement

Force un saut de ligne. Cf. la définition de l'élément BR→vf dans HTML 4.01.

Définitions IDL
interface HTMLBRElement : HTMLElement {
           attribute DOMString       clear;
};
Attributs
clear de type DOMString
Contrôle l'écoulement du texte autour des flottants. Cf. la définition de l'attribut clear→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLBaseFontElement

La police de base. Cf. la définition de l'élément BASEFONT→vf dans HTML 4.01. Cet élément est déconseillé dans HTML 4.01.

Définitions IDL
interface HTMLBaseFontElement : HTMLElement {
           attribute DOMString       color;
           attribute DOMString       face;
  // Modifié dans DOM niveau 2 :
           attribute long            size;
};
Attributs
color de type DOMString
La couleur de la police. Cf. la définition de l'attribut color dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
face de type DOMString
L'identificateur d'une police. Cf. la définition de l'attribut face dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
size de type long, modifié dans DOM niveau 2
La dimension calculée de la police. Cf. la définition de l'attribut size→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLFontElement

Un changement de police local. Cf. la définition de l'élément FONT→vf dans HTML 4.01. Cet élément est déconseillé dans HTML 4.01.

Définitions IDL
interface HTMLFontElement : HTMLElement {
           attribute DOMString       color;
           attribute DOMString       face;
           attribute DOMString       size;
};
Attributs
color de type DOMString
La couleur de la police. Cf. la définition de l'attribut color→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
face de type DOMString
L'identificateur de la police. Cf. la définition de l'attribut face→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
size de type DOMString
La dimension de la police. Cf. la définition de l'attribut size→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLHRElement

Crée une règle horizontale. Cf. la définition de l'élément HR→vf dans HTML 4.01.

Définitions IDL
interface HTMLHRElement : HTMLElement {
           attribute DOMString       align;
           attribute boolean         noShade;
           attribute DOMString       size;
           attribute DOMString       width;
};
Attributs
align de type DOMString
Aligne la règle dans la page. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
noShade de type boolean
Indique à l'agent utilisateur de ne pas restituer cet élément avec un ombrage. Cf. la définition de l'attribut noshade→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
size de type DOMString
L'épaisseur de la règle. Cf. la définition de l'attribut size→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
width de type DOMString
La largeur de la règle. Cf. la définition de l'attribut width→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLModElement

Un avis de modification sur certaines parties d'un document. Voir les définitions des éléments INS→vf et DEL→vf dans HTML 4.01.

Définitions IDL
interface HTMLModElement : HTMLElement {
           attribute DOMString       cite;
           attribute DOMString       dateTime;
};
Attributs
cite de type DOMString
L'adresse URI [IETF RFC 2396] d'un document qui décrit la raison du changement. Cf. la définition de l'attribut cite dans HTML 4.01.
dateTime de type DOMString
La date et l'heure du changement. Cf. la définition de l'attribut datetime→vf dans HTML 4.01.
L'interface HTMLAnchorElement

L'élément ancre. Cf. la définition de l'élément A→vf dans HTML 4.01.

Définitions IDL
interface HTMLAnchorElement : HTMLElement {
           attribute DOMString       accessKey;
           attribute DOMString       charset;
           attribute DOMString       coords;
           attribute DOMString       href;
           attribute DOMString       hreflang;
           attribute DOMString       name;
           attribute DOMString       rel;
           attribute DOMString       rev;
           attribute DOMString       shape;
           attribute long            tabIndex;
           attribute DOMString       target;
           attribute DOMString       type;
  void               blur();
  void               focus();
};
Attributs
accessKey de type DOMString
Une touche de caractère pour accéder à la commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
charset de type DOMString
Le codage de caractères de la ressource liée. Cf. la définition de l'attribut charset→vf dans HTML 4.01.
coords de type DOMString
Une liste de longueurs, séparées par des virgules, définissant la géométrie d'une région active. Voir également l'attribut shape pour la forme de la région. Cf. la définition de l'attribut coords→vf dans HTML 4.01.
href de type DOMString
L'adresse URI absolue [IETF RFC 2396] de la ressource liée. Cf. la définition de l'attribut href→vf dans HTML 4.01.
hreflang de type DOMString
Le code de langue de la ressource liée. Cf. la définition de l'attribut hreflang→vf dans HTML 4.01.
name de type DOMString
Le nom de l'ancre. Cf. la définition de l'attribut name→vf dans HTML 4.01.
rel de type DOMString
Un type de lien où aller. Cf. la définition de l'attribut rel→vf dans HTML 4.01.
rev de type DOMString
Un type de lien où revenir. Cf. la définition de l'attribut rev→vf dans HTML 4.01.
shape de type DOMString
La forme de la zone active. Les coordonnées sont fournies par l'attribut coords. Cf. la définition de l'attribut shape→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
target de type DOMString
Le cadre où restituer la ressource. Cf. la définition de l'attribut target→vf dans HTML 4.01.
type de type DOMString
Un type de contenu consultatif. Cf. la définition de l'attribut type→vf dans HTML 4.01.
Méthodes
blur
Enlève l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
focus
Donne l'activation de clavier à cet élément.
Aucun paramètre
Aucune valeur retournée
Aucune exception
L'interface HTMLImageElement

Une image incorporée. Cf. la définition de l'élément IMG→vf dans HTML 4.01.

Définitions IDL
interface HTMLImageElement : HTMLElement {
           attribute DOMString       name;
           attribute DOMString       align;
           attribute DOMString       alt;
           attribute DOMString       border;
  // Modifié dans DOM niveau 2 :
           attribute long            height;
  // Modifié dans DOM niveau 2 :
           attribute long            hspace;
           attribute boolean         isMap;
           attribute DOMString       longDesc;
           attribute DOMString       src;
           attribute DOMString       useMap;
  // Modifié dans DOM niveau 2 :
           attribute long            vspace;
  // Modifié dans DOM niveau 2 :
           attribute long            width;
};
Attributs
align de type DOMString
Aligne cet objet (verticalement ou horizontalement) par rapport au texte qui l'entoure. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
alt de type DOMString
Le texte de remplacement pour les agents utilisateurs incapables de restituer normalement le contenu de cet élément. Cf. la définition de l'attribut alt→vf dans HTML 4.01.
border de type DOMString
L'épaisseur de la bordure autour de l'image. Cf. la définition de l'attribut border→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01. Remarquer que cet attribut avait le type DOMString dans DOM niveau 1 HTML [DOM niveau 1].
height de type long, modifié dans DOM niveau 2
La hauteur de l'image en pixels. Cf. la définition de l'attribut height→vf dans HTML 4.01. Remarquer que cet attribut avait le type DOMString dans DOM niveau 1 HTML [DOM niveau 1].
hspace de type long, modifié dans DOM niveau 2
L'espace horizontal à gauche et à droite de cette image en pixels. Cf. la définition de l'attribut hspace→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01. Remarquer que cet attribut avait le type DOMString dans DOM niveau 1 HTML [DOM niveau 1].
isMap de type boolean
Utilisation d'images cliquables côté serveur. Cf. la définition de l'attribut ismap→vf dans HTML 4.01.
longDesc de type DOMString
L'adresse URI [IETF RFC 2396] d'une description détaillée de cette image ou de ce cadre. Cf. la définition de l'attribut longdesc→vf dans HTML 4.01.
name de type DOMString
Le nom de l'élément (pour rétrocompatibilité).
src de type DOMString
L'adresse URI [IETF RFC 2396] de la source de cette image. Cf. la définition de l'attribut src→vf dans HTML 4.01.
useMap de type DOMString
Utilisation d'images cliquables côté client. Cf. la définition de l'attribut usemap→vf dans HTML 4.01.
vspace de type long, modifié dans DOM niveau 2
L'espace vertical au-dessus et au-dessous de cette image en pixels. Cf. la définition de l'attribut vspace→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01. Remarquer que cet attribut avait le type DOMString dans DOM niveau 1 HTML [DOM niveau 1].
width de type long, modifié dans DOM niveau 2
La largeur de l'image en pixels. Cf. la définition de l'attribut width→vf dans HTML 4.01. Remarquer que cet attribut avait le type DOMString dans DOM niveau 1 HTML [DOM niveau 1].
L'interface HTMLObjectElement

Un objet incorporé générique.

Remarque : En principes, toutes les propriétés de l'élément objet sont en lecture-écriture mais, dans certains environnements, certaines propriétés ne le seront qu'à l'instanciation de l'objet sous-jacent. Cf. la définition de l'élément OBJECT→vf dans [HTML 4.01].

Définitions IDL
interface HTMLObjectElement : HTMLElement {
  readonly attribute HTMLFormElement form;
           attribute DOMString       code;
           attribute DOMString       align;
           attribute DOMString       archive;
           attribute DOMString       border;
           attribute DOMString       codeBase;
           attribute DOMString       codeType;
           attribute DOMString       data;
           attribute boolean         declare;
           attribute DOMString       height;
           attribute long            hspace;
           attribute DOMString       name;
           attribute DOMString       standby;
           attribute long            tabIndex;
           attribute DOMString       type;
           attribute DOMString       useMap;
           attribute long            vspace;
           attribute DOMString       width;
  // Introduit dans DOM niveau 2 :
  readonly attribute Document        contentDocument;
};
Attributs
align de type DOMString
Aligne cet objet (verticalement ou horizontalement) par rapport au texte qui l'entoure. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
archive de type DOMString
Une liste d'archives, séparées par des espaces. Cf. la définition de l'attribut archive→vf dans HTML 4.01.
border de type DOMString
L'épaisseur de la bordure autour de l'objet. Cf. la définition de l'attribut border→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
code de type DOMString
Le fichier de classe de l'applet. Voir l'attribut code pour l'objet HTMLAppletElement.
codeBase de type DOMString
L'adresse URI de base [IETF RFC 2396] pour les attributs classid, data et archive. Cf. la définition de l'attribut codebase→vf dans HTML 4.01.
codeType de type DOMString
Le type de contenu des données chargées via l'attribut classid. Cf. la définition de l'attribut codetype→vf dans HTML 4.01.
contentDocument de type Document, en lecture seule, introduit dans DOM niveau 2
Le document contenu par cet objet, le cas échéant et si disponible, ou la valeur null sinon.
data de type DOMString
L'adresse URI [IETF RFC 2396] indiquant la localisation des données de l'objet. Cf. la définition de l'attribut data→vf dans HTML 4.01.
declare de type boolean
Déclare cet objet (en vue d'un appel ultérieur) mais sans l'instancier. Cf. la définition de l'attribut declare→vf dans HTML 4.01.
form de type HTMLFormElement, en lecture seule
Retourne l'élément FORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas dans le contexte d'un formulaire.
height de type DOMString
Force la hauteur. Cf. la définition de l'attribut height→vf dans HTML 4.01.
hspace de type long
L'espace horizontal, en pixels, à droite et à gauche de cette image, cette appliquette ou cet objet. Cf. la définition de l'attribut hspace→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
name de type DOMString
Le nom de la commande ou de l'objet de formulaire dans une soumission de formulaire. Cf. la définition de l'attribut name→vf dans HTML 4.01.
standby de type DOMString
Le message à afficher pendant le chargement de l'objet. Cf. la définition de l'attribut standby→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
type de type DOMString
Le type de contenu des données chargées via l'attribut data. Cf. la définition de l'attribut type→vf dans HTML 4.01.
useMap de type DOMString
Utilisation d'images cliquables côté client. Cf. la définition de l'attribut usemap→vf dans HTML 4.01.
vspace de type long
L'espace vertical, en pixels, au-dessus et au-dessous de cette image, cette appliquette ou cet objet. Cf. la définition de l'attribut vspace→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
width de type DOMString
Force la largeur. Cf. la définition de l'attribut width→vf dans HTML 4.01.
L'interface HTMLParamElement

Les paramètres fournis à l'élément OBJECT. Cf. la définition de l'élément PARAM→vf dans HTML 4.01.

Définitions IDL
interface HTMLParamElement : HTMLElement {
           attribute DOMString       name;
           attribute DOMString       type;
           attribute DOMString       value;
           attribute DOMString       valueType;
};
Attributs
name de type DOMString
Le nom d'un paramètre d'exécution. Cf. la définition de l'attribut name→vf dans HTML 4.01.
type de type DOMString
Le type de contenu de l'attribut value lorsque l'attribut valuetype vaut "ref". Cf. la définition de l'attribut type→vf dans HTML 4.01.
value de type DOMString
La valeur d'un paramètre d'exécution. Cf. la définition de l'attribut value→vf dans HTML 4.01.
valueType de type DOMString
Des informations à propos de la signification de la valeur de l'attribut value. Cf. la définition de l'attribut valuetype→vf dans HTML 4.01.
L'interface HTMLAppletElement

Une appliquette Java incorporée. Cf. la définition de l'élément APPLET→vf dans HTML 4.01. Cet élément est déconseillé dans HTML 4.01.

Définitions IDL
interface HTMLAppletElement : HTMLElement {
           attribute DOMString       align;
           attribute DOMString       alt;
           attribute DOMString       archive;
           attribute DOMString       code;
           attribute DOMString       codeBase;
           attribute DOMString       height;
  // Modifié dans DOM niveau 2 :
           attribute long            hspace;
           attribute DOMString       name;
  // Modifié dans DOM niveau 2 :
           attribute DOMString       object;
  // Modifié dans DOM niveau 2 :
           attribute long            vspace;
           attribute DOMString       width;
};
Attributs
align de type DOMString
Aligne cet objet (verticalement ou horizontalement) par rapport au texte qui l'entoure. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
alt de type DOMString
Le texte de remplacement pour les agents utilisateurs incapables de restituer normalement le contenu de cet élément. Cf. la définition de l'attribut alt→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
archive de type DOMString
Une liste d'archives, séparées par des espaces. Cf. la définition de l'attribut archive→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
code de type DOMString
Le fichier de classe de l'appliquette. Cf. la définition de l'attribut code→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
codeBase de type DOMString
L'adresse URI de base optionnelle [IETF RFC 2396] de l'appliquette. Cf. la définition de l'attribut codebase→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
height de type DOMString
Force la hauteur. Cf. la définition de l'attribut height→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
hspace de type long, modifié dans DOM niveau 2
L'espace horizontal, en pixels, à gauche et à droite de cette image, cette appliquette ou cet objet. Cf. la définition de l'attribut hspace→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
name de type DOMString
Le nom de l'appliquette. Cf. la définition de l'attribut name→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
object de type DOMString, modifié dans DOM niveau 2
La valeur de l'attribut object. Cf. la définition de l'attribut object→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
vspace de type long, modifié dans DOM niveau 2
L'espace vertical, en pixels, au-dessus et au-dessous de cette image, cette appliquette ou cet objet. Cf. la définition de l'attribut vspace→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
width de type DOMString
Force la largeur. Cf. la définition de l'attribut width→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLMapElement

Des images cliquables côté client. Cf. la définition de l'élément MAP→vf dans HTML 4.01.

Définitions IDL
interface HTMLMapElement : HTMLElement {
  readonly attribute HTMLCollection  areas;
           attribute DOMString       name;
};
Attributs
areas de type HTMLCollection, en lecture seule
La liste des aires définies des images cliquables.
name de type DOMString
Nomme les images cliquables (pour une utilisation avec usemap). Cf. la définition de l'attribut name→vf dans HTML 4.01.
L'interface HTMLAreaElement

Une définition de l'aire d'une image cliquable côté client. Cf. la définition de l'élément AREA→vf dans HTML 4.01.

Définitions IDL
interface HTMLAreaElement : HTMLElement {
           attribute DOMString       accessKey;
           attribute DOMString       alt;
           attribute DOMString       coords;
           attribute DOMString       href;
           attribute boolean         noHref;
           attribute DOMString       shape;
           attribute long            tabIndex;
           attribute DOMString       target;
};
Attributs
accessKey de type DOMString
Une touche de caractère pour accéder à la commande de formulaire. Cf. la définition de l'attribut accesskey→vf dans HTML 4.01.
alt de type DOMString
Le texte de remplacement pour les agents utilisateurs incapables de restituer normalement le contenu de cet élément. Cf. la définition de l'attribut alt→vf dans HTML 4.01.
coords de type DOMString
La liste des longueurs, séparées par des virgules, définissant la géométrie d'une région active. Voir également l'attribut shape pour la forme de la région. Cf. la définition de l'attribut coords→vf dans HTML 4.01.
href de type DOMString
L'adresse URI [IETF RFC 2396] de la ressource appelée. Cf. la définition de l'attribut href→vf dans HTML 4.01.
noHref de type boolean
Indique que cette aire est inactive, c'est-à-dire qu'aucune action ne lui est associée. Cf. la définition de l'attribut nohref→vf dans HTML 4.01.
shape de type DOMString
La forme de la zone active. Les coordonnées sont fournies par l'attribut coords. Cf. la définition de l'attribut shape→vf dans HTML 4.01.
tabIndex de type long
L'index représentant la position de l'élément dans l'ordre de tabulation. Cf. la définition de l'attribut tabindex→vf dans HTML 4.01.
target de type DOMString
Le cadre où restituer la ressource. Cf. la définition de l'attribut target→vf dans HTML 4.01.
L'interface HTMLScriptElement

Les déclarations de scripts. Cf. la définition de l'élément SCRIPT→vf dans HTML 4.01.

Définitions IDL
interface HTMLScriptElement : HTMLElement {
           attribute DOMString       text;
           attribute DOMString       htmlFor;
           attribute DOMString       event;
           attribute DOMString       charset;
           attribute boolean         defer;
           attribute DOMString       src;
           attribute DOMString       type;
};
Attributs
charset de type DOMString
Le codage de caractères de la ressource liée. Cf. la définition de l'attribut charset→vf dans HTML 4.01.
defer de type boolean
Indique à l'agent utilisateur de différer ou non le traitement du script. Cf. la définition de l'attribut defer→vf dans HTML 4.01.
event de type DOMString
Réservé pour un usage futur.
htmlFor de type DOMString
Réservé pour un usage futur.
src de type DOMString
L'adresse URI [IETF RFC 2396] d'un script externe. Cf. la définition de l'attribut src→vf dans HTML 4.01.
text de type DOMString
Le contenu du script de l'élément.
type de type DOMString
Le type de contenu du langage de script. Cf. la définition de l'attribut type→vf dans HTML 4.01.
L'interface HTMLTableElement

Les méthodes create* et delete* des tables permettent aux auteurs de les construire et de les modifier. [HTML 4.01] définit que seul un exemplaire des éléments CAPTION, THEAD et TFOOT peut exister dans une table. C'est la raison pour laquelle, s'il en existe un et qu'on appelle la méthode createTHead(), ou createTFoot(), la méthode retournera l'élément THEAD, ou TFOOT, existant. Cf. la définition de l'élément TABLE→vf dans HTML 4.01.

Définitions IDL
interface HTMLTableElement : HTMLElement {
  // Modifié dans DOM niveau 2 :
           attribute HTMLTableCaptionElement caption;
                    // soulève une exception (DOMException) à l'initialisation

  // Modifié dans DOM niveau 2 :
           attribute HTMLTableSectionElement tHead;
                    // soulève une exception (DOMException) à l'initialisation

  // Modifié dans DOM niveau 2 :
           attribute HTMLTableSectionElement tFoot;
                    // soulève une exception (DOMException) à l'initialisation

  readonly attribute HTMLCollection  rows;
  readonly attribute HTMLCollection  tBodies;
           attribute DOMString       align;
           attribute DOMString       bgColor;
           attribute DOMString       border;
           attribute DOMString       cellPadding;
           attribute DOMString       cellSpacing;
           attribute DOMString       frame;
           attribute DOMString       rules;
           attribute DOMString       summary;
           attribute DOMString       width;
  HTMLElement        createTHead();
  void               deleteTHead();
  HTMLElement        createTFoot();
  void               deleteTFoot();
  HTMLElement        createCaption();
  void               deleteCaption();
  // Modifié dans DOM niveau 2 :
  HTMLElement        insertRow(in long index)
                                        raises(DOMException);
  // Modifié dans DOM niveau 2 :
  void               deleteRow(in long index)
                                        raises(DOMException);
};
Attributs
align de type DOMString
Définit la position de la table par rapport au reste du document. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
bgColor de type DOMString
La couleur d'arrière-plan de la cellule. Cf. la définition de l'attribut bgcolor→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
border de type DOMString
L'épaisseur de la bordure autour de la table. Cf. la définition de l'attribut border→vf dans HTML 4.01.
caption de type HTMLTableCaptionElement, modifié dans DOM niveau 2
Retourne la légende de la table (CAPTION), ou la valeur null s'il n'y en a pas.
Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Soulevée si ce n'est pas un élément CAPTION.

cellPadding de type DOMString
Définit l'espace horizontal et vertical entre le contenu de la cellule et ses bordures. Cf. la définition de l'attribut cellpadding→vf dans HTML 4.01.
cellSpacing de type DOMString
Définit la séparation horizontale et verticale entre les cellules. Cf. la définition de l'attribut cellspacing→vf dans HTML 4.01.
frame de type DOMString
Définit les bordures externes de la table à restituer. Cf. la définition de l'attribut frame→vf dans HTML 4.01.
rows de type HTMLCollection, en lecture seule
Retourne une collection de toutes les rangées de la table, dont toutes celles constituées par les éléments THEAD, TFOOT, et tous les éléments TBODY.
rules de type DOMString
Définit les bordures de la table à restituer. Cf. la définition de l'attribut rules→vf dans HTML 4.01.
summary de type DOMString
Description du but ou la structure d'une table. Cf. la définition de l'attribut summary→vf dans HTML 4.01.
tBodies de type HTMLCollection, en lecture seule
Retourne la collection des corps de la table (y compris ceux implicites).
tFoot de type HTMLTableSectionElement, modifié dans DOM niveau 2
Retourne l'élément TFOOT de la table, ou la valeur null s'il n'y en a pas.
Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Soulevée si ce n'est pas un élément TFOOT.

tHead de type HTMLTableSectionElement, modifié dans DOM niveau 2
Retourne l'élément THEAD de la table, ou la valeur null s'il n'y en a pas.
Exceptions à l'initialisation

DOMException

HIERARCHY_REQUEST_ERR : Soulevée si ce n'est pas un élément THEAD.

width de type DOMString
Définit la largeur souhaitée pour la table. Cf. la définition de l'attribut width→vf dans HTML 4.01.
Méthodes
createCaption
Crée un nouvel objet légende de table ou retourne une légende existante.
Valeur retournée

HTMLElement

Un élément CAPTION.

Aucun paramètre
Aucune exception
createTFoot
Crée une rangée de bas de table ou retourne un bas de table existant.
Valeur retournée

HTMLElement

Un élément TFOOT.

Aucun paramètre
Aucune exception
createTHead
Crée une rangée de rubrique de table ou retourne une rubrique de table existante.
Valeur retournée

HTMLElement

Un élément THEAD.

Aucun paramètre
Aucune exception
deleteCaption
Supprime la légende de la table, s'il y en a une.
Aucun paramètre
Aucune valeur retournée
Aucune exception
deleteRow, modifié dans DOM niveau 2
Supprime une rangée de table.
Paramètres
index de type long
L'index de la rangée à effacer. Cet index commence à "0" et se rapporte à l'ordre logique (pas à l'ordre du document) de toutes les rangées contenues dans la table. Si la valeur de l'index est "-1", alors la dernière rangée de la table est effacée.
Exceptions

DOMException

INDEX_SIZE_ERR : Soulevée si l'index fourni est supérieur ou égal au nombre de rangées ou si l'index est un nombre négatif autre que "-1".

Aucune valeur retournée
deleteTFoot
Supprime le bas de table, s'il y en a un.
Aucun paramètre
Aucune valeur retournée
Aucune exception
deleteTHead
Supprime la rubrique de table, s'il y en a une.
Aucun paramètre
Aucune valeur retournée
Aucune exception
insertRow, modifié dans DOM niveau 2
Insère une nouvelle rangée vide dans la table. La nouvelle rangée s'insère, dans la même section, immédiatement avant la rangée courante indexée. Si la valeur de l'attribut index est "-1" ou bien égale au nombre de rangées, alors la nouvelle rangée est ajoutée à la fin. En outre, si la table est vide, la rangée sera insérée dans un élément TBODY créé et inséré à l'occasion dans la table.

Remarque : Une rangée de table ne peut pas être vide conformément à [HTML 4.01].

Paramètres
index de type long
Le numéro de la rangée où insérer une nouvelle rangée. Cet index commence à "0" et se rapporte à l'ordre logique (pas à l'ordre du document) de toutes les rangées contenues dans la table.
Valeur retournée

HTMLElement

La rangée qui vient d'être créée.

Exceptions

DOMException

INDEX_SIZE_ERR : Soulevée si l'index fourni est supérieur au nombre de rangées ou si l'index est un nombre négatif autre que "-1".

L'interface HTMLTableCaptionElement

Une légende de table. Cf. la définition de l'élément CAPTION→vf dans HTML 4.01.

Définitions IDL
interface HTMLTableCaptionElement : HTMLElement {
           attribute DOMString       align;
};
Attributs
align de type DOMString
L'alignement de la légende par rapport à la table. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLTableColElement

Regroupe les éléments COL et COLGROUP. Cf. la définition de l'élément COL→vf dans HTML 4.01.

Définitions IDL
interface HTMLTableColElement : HTMLElement {
           attribute DOMString       align;
           attribute DOMString       ch;
           attribute DOMString       chOff;
           attribute long            span;
           attribute DOMString       vAlign;
           attribute DOMString       width;
};
Attributs
align de type DOMString
L'alignement horizontal des données des cellules dans la colonne. Cf. la définition de l'attribut align→vf dans HTML 4.01.
ch de type DOMString
Le caractère d'alignement des cellules dans une colonne. Cf. la définition de l'attribut char→vf dans HTML 4.01.
chOff de type DOMString
Le décalage d'un caractère d'alignement. Cf. la définition de l'attribut charoff→vf dans HTML 4.01.
span de type long
Indique le nombre de colonnes dans un groupe ou de celles concernées par un regroupement. Cf. la définition de l'attribut span→vf dans HTML 4.01.
vAlign de type DOMString
L'alignement vertical des données des cellules dans la colonne. Cf. la définition de l'attribut valign→vf dans HTML 4.01.
width de type DOMString
La largeur par défaut de la colonne. Cf. la définition de l'attribut width→vf dans HTML 4.01.
L'interface HTMLTableSectionElement

Les éléments THEAD, TFOOT et TBODY.

Définitions IDL
interface HTMLTableSectionElement : HTMLElement {
           attribute DOMString       align;
           attribute DOMString       ch;
           attribute DOMString       chOff;
           attribute DOMString       vAlign;
  readonly attribute HTMLCollection  rows;
  // Modifié dans DOM niveau 2 :
  HTMLElement        insertRow(in long index)
                                        raises(DOMException);
  // Modifié dans DOM niveau 2 :
  void               deleteRow(in long index)
                                        raises(DOMException);
};
Attributs
align de type DOMString
L'alignement horizontal des données dans les cellules. Voir l'attribut align de l'objet HTMLTheadElement pour le détail.
ch de type DOMString
Le caractère d'alignment des cellules dans une colonne. Cf. la définition de l'attribut char→vf dans HTML 4.01.
chOff de type DOMString
Le décalage du caractère d'alignement. Cf. la définition de l'attribut charoff→vf dans HTML 4.01.
rows de type HTMLCollection, en lecture seule
La collection des rangées dans cette section de table.
vAlign de type DOMString
L'alignement vertical des données dans les cellules. Voir l'attribut valign de l'objet HTMLTheadElement pour des précisions.
Méthodes
deleteRow, modifié dans DOM niveau 2
Supprime une rangée de cette section.
Paramètres
index de type long
L'index de la rangée à supprimer, ou "-1" pour supprimer la dernière rangée. Cet index commence à "0" et ne se rapporte qu'aux rangées contenues dans cette section, et non à toutes les rangées dans la table.
Exceptions

DOMException

INDEX_SIZE_ERR : Soulevée si l'index fourni est supérieur ou égal au nombre de rangées ou si l'index est un nombre négatif autre que "-1".

Aucune valeur retournée
insertRow, modifié dans DOM niveau 2
Insère une rangée dans cette section. La nouvelle rangée s'insère, dans la même section, immédiatement avant la rangé courante indexée. Si la valeur de l'attribut index vaut "-1" ou est égale au nombre de rangées dans cette section, la nouvelle rangée s'ajoute à la fin.
Paramètres
index de type long
Le numéro de la rangée où insérer une nouvelle rangée. Cette index commence à "0" et ne se rapporte qu'aux rangées contenues dans cette section, et non à toutes les rangées dans la table.
Valeur retournée

HTMLElement

La rangée qui vient d'être créée.

Exceptions

DOMException

INDEX_SIZE_ERR : Soulevée si l'index fourni est supérieur au nombre de rangées, ou si l'index est un numéro négatif autre que "-1".

L'interface HTMLTableRowElement

Une rangée dans une table. Cf. la définition de l'élément TR→vf dans HTML 4.01.

Définitions IDL
interface HTMLTableRowElement : HTMLElement {
  // Modifié dans DOM niveau 2 :
  readonly attribute long            rowIndex;
  // Modifié dans DOM niveau 2 :
  readonly attribute long            sectionRowIndex;
  // Modifié dans DOM niveau 2 :
  readonly attribute HTMLCollection  cells;
           attribute DOMString       align;
           attribute DOMString       bgColor;
           attribute DOMString       ch;
           attribute DOMString       chOff;
           attribute DOMString       vAlign;
  // Modifié dans DOM niveau 2 :
  HTMLElement        insertCell(in long index)
                                        raises(DOMException);
  // Modifié dans DOM niveau 2 :
  void               deleteCell(in long index)
                                        raises(DOMException);
};
Attributs
align de type DOMString
L'alignement horizontal des données à l'intérieur des cellules de cette rangée. Cf. la définition de l'attribut align→vf dans HTML 4.01.
bgColor de type DOMString
La couleur d'arrière-plan des rangées. Cf. la définition de l'attribut bgcolor→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
cells de type HTMLCollection, en lecture seule, modifié dans DOM niveau 2
La collection des cellules dans cette rangée.
ch de type DOMString
Le caractère d'alignement des cellules dans une colonne. Cf. la définition de l'attribut char→vf dans HTML 4.01.
chOff de type DOMString
Le décalage du caractère d'alignement. Cf. la définition de l'attribut charoff→vf dans HTML 4.01.
rowIndex de type long, en lecture seule, modifié dans DOM niveau 2
C'est l'index de la rangée dans l'ordre logique et non dans l'ordre du document. L'attribut rowIndex tient compte des sections (THEAD, TFOOT ou TBODY) à l'intérieur de la table, en plaçant les rangées de l'élément THEAD en premier dans l'index, suivies par celles de l'élément TBODY, suivies par celles de l'élément TFOOT.
sectionRowIndex de type long, en lecture seule, modifié dans DOM niveau 2
L'index de cette rangée, par rapport à la section courante (THEAD, TFOOT ou TBODY), commençant à "0".
vAlign de type DOMString
L'alignement vertical des données à l'intérieur des cellules de cette rangée. Cf. la définition de l'attribut valign→vf dans HTML 4.01.
Méthodes
deleteCell, modifié dans DOM niveau 2
Supprime une cellule de la rangée courante.
Paramètres
index de type long
L'index de la cellule à supprimer, commençant à "0". Si l'index vaut "-1", la dernière cellule dans la rangée est supprimée.
Exceptions

DOMException

INDEX_SIZE_ERR : Soulevée si l'index est supérieur ou égal au nombre des cellules, ou si l'index est un nombre négatif autre que "-1".

Aucune valeur retournée
insertCell, modifié dans DOM niveau 2
Insère une cellule vide TD dans cette rangée. Si l'attribut index vaut "-1" ou est égal au nombre des cellules, la nouvelle cellule s'ajoute à la fin.
Paramètres
index de type long
L'endroit où insérer la cellule, commençant à "0".
Valeur retournée

HTMLElement

La cellule qui vient d'être créée.

Exceptions

DOMException

INDEX_SIZE_ERR : Soulevée si l'index fourni est supérieur au nombre des cellules, ou si l'index est un nombre négatif autre que "-1".

L'interface HTMLTableCellElement

L'objet servant à représenter les éléments TH et TD. Cf. la définition de l'élément TD→vf dans HTML 4.01.

Définitions IDL
interface HTMLTableCellElement : HTMLElement {
  readonly attribute long            cellIndex;
           attribute DOMString       abbr;
           attribute DOMString       align;
           attribute DOMString       axis;
           attribute DOMString       bgColor;
           attribute DOMString       ch;
           attribute DOMString       chOff;
           attribute long            colSpan;
           attribute DOMString       headers;
           attribute DOMString       height;
           attribute boolean         noWrap;
           attribute long            rowSpan;
           attribute DOMString       scope;
           attribute DOMString       vAlign;
           attribute DOMString       width;
};
Attributs
abbr de type DOMString
L'abréviation pour les cellules de rubrique. Cf. la définition de l'attribut abbr→vf dans HTML 4.01.
align de type DOMString
L'alignement horizontal des données dans la cellule. Cf. la définition de l'attribut align→vf dans HTML 4.01.
axis de type DOMString
Nomme le groupe des rubriques en relation. Cf. la définition de l'attribut axis→vf dans HTML 4.01.
bgColor de type DOMString
La couleur d'arrière-plan de la cellule. Cf. la définition de l'attribut bgcolor→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
cellIndex de type long, en lecture seule
L'index de cette cellule dans la rangée, commençant à "0". Cet index est dans l'ordre de l'arbre du document et non dans l'ordre affiché.
ch de type DOMString
Le caractère d'alignement des cellules dans la colonne. Cf. la définition de l'attribut char→vf dans HTML 4.01.
chOff de type DOMString
Le décalage du caractère d'alignement. Cf. la définition de l'attribut charoff→vf dans HTML 4.01.
colSpan de type long
Le nombre de colonnes occupées par la cellule. Cf. la définition de l'attribut colspan→vf dans HTML 4.01.
headers de type DOMString
La liste des valeurs des attributs id des cellules de rubrique. Cf. la définition de l'attribut headers→vf dans HTML 4.01.
height de type DOMString
La hauteur de la cellule. Cf. la définition de l'attribut height→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
noWrap de type boolean
Supprime le retour à la ligne automatique. Cf. la définition de l'attribut nowrap→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
rowSpan de type long
Le nombre des rangées occupées par la cellule. Cf. la définition de l'attribut rowspan→vf dans HTML 4.01.
scope de type DOMString
La portée couverte par les cellules de rubrique. Cf. la définition de l'attribut scope→vf dans HTML 4.01.
vAlign de type DOMString
L'alignement vertical des données dans la cellule. Cf. la définition de l'attribut valign→vf dans HTML 4.01.
width de type DOMString
La largeur de la cellule. Cf. la définition de l'attribut width→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
L'interface HTMLFrameSetElement

Crée une grille de cadres. Cf. la définition de l'élément FRAMESET→vf dans HTML 4.01.

Définitions IDL
interface HTMLFrameSetElement : HTMLElement {
           attribute DOMString       cols;
           attribute DOMString       rows;
};
Attributs
cols de type DOMString
Le nombre des colonnes de cadres dans le jeu d'encadrement. Cf. la définition de l'attribut cols→vf dans HTML 4.01.
rows de type DOMString
Le nombre des rangées de cadres dans le jeu d'encadrement. Cf. la définition de l'attribut rows→vf dans HTML 4.01.
L'interface HTMLFrameElement

Crée un cadre. Cf. la définition de l'élément FRAME→vf dans HTML 4.01.

Définitions IDL
interface HTMLFrameElement : HTMLElement {
           attribute DOMString       frameBorder;
           attribute DOMString       longDesc;
           attribute DOMString       marginHeight;
           attribute DOMString       marginWidth;
           attribute DOMString       name;
           attribute boolean         noResize;
           attribute DOMString       scrolling;
           attribute DOMString       src;
  // Introduit dans DOM niveau 2 :
  readonly attribute Document        contentDocument;
};
Attributs
contentDocument de type Document, en lecture seule, introduit dans DOM niveau 2
Le document contenu par ce cadre, le cas échéant et si disponible, ou la valeur null sinon.
frameBorder de type DOMString
Impose des bordures aux cadres. Cf. la définition de l'attribut frameborder→vf dans HTML 4.01.
longDesc de type DOMString
L'adresse URI [IETF RFC 2396] d'une description longue de cette image ou de ce cadre. Cf. la définition de l'attribut longdesc→vf dans HTML 4.01.
marginHeight de type DOMString
La marge verticale du cadre, en pixels. Cf. la définition de l'attribut marginheight→vf dans HTML 4.01.
marginWidth de type DOMString
La marge horizontale du cadre, en pixels. Cf. la définition de l'attribut marginwidth→vf dans HTML 4.01.
name de type DOMString
Le nom du cadre (l'objet de l'attribut target). Cf. la définition de l'attribut name→vf dans HTML 4.01.
noResize de type boolean
Quand la valeur est "true", elle interdit le redimensionnement du cadre par l'utilisateur. Cf. la définition de l'attribut noresize→vf dans HTML 4.01.
scrolling de type DOMString
Définit si le cadre devrait avoir ou non des ascenseurs de fenêtre. Cf. la définition de l'attribut scrolling→vf dans HTML 4.01.
src de type DOMString
L'adresse URI [IETF RFC 2396] du contenu initial du cadre. Cf. la définition de l'attribut src→vf dans HTML 4.01.
L'interface HTMLIFrameElement

Les sous-fenêtres en-ligne. Cf. la définition de l'élément IFRAME→vf dans HTML 4.01.

Définitions IDL
interface HTMLIFrameElement : HTMLElement {
           attribute DOMString       align;
           attribute DOMString       frameBorder;
           attribute DOMString       height;
           attribute DOMString       longDesc;
           attribute DOMString       marginHeight;
           attribute DOMString       marginWidth;
           attribute DOMString       name;
           attribute DOMString       scrolling;
           attribute DOMString       src;
           attribute DOMString       width;
  // Introduit dans DOM niveau 2 :
  readonly attribute Document        contentDocument;
};
Attributs
align de type DOMString
Aligne cet objet (verticalement ou horizontalement) par rapport au texte qui l'entoure. Cf. la définition de l'attribut align→vf dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.
contentDocument de type Document, en lecture seule, introduit dans DOM niveau 2
Le document contenu par ce cadre, le cas échéant et si disponible, ou la valeur null sinon.
frameBorder de type DOMString
Impose des bordures au cadre. Cf. la définition de l'attribut frameborder→vf dans HTML 4.01.
height de type DOMString
La hauteur du cadre. Cf. la définition de l'attribut height→vf dans HTML 4.01.
longDesc de type DOMString
L'adresse URI [IETF RFC 2396] d'une description longue de cette image ou ce cadre. Cf. la définition de l'attribut longdesc→vf dans HTML 4.01.
marginHeight de type DOMString
La marge verticale du cadre, en pixels. Cf. la définition de l'attribut marginheight→vf dans HTML 4.01.
marginWidth de type DOMString
La marge horizontale du cadre, en pixels. Cf. la définition de l'attribut marginwidth→vf dans HTML 4.01.
name de type DOMString
Le nom du cadre (l'objet de l'attribut target). Cf. la définition de l'attribut name→vf dans HTML 4.01.
scrolling de type DOMString
Définit si le cadre devrait avoir ou non des ascenseurs de fenêtre. Cf. la définition de l'attribut scrolling→vf dans HTML 4.01.
src de type DOMString
L'adresse URI [IETF RFC 2396] du contenu initial du cadre. Cf. la définition de l'attribut src→vf dans HTML 4.01.
width de type DOMString
La largeur du cadre. Cf. la définition de l'attribut width→vf dans HTML 4.01.