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 :
HTMLDocument dérivée de l'interface principale Document.
L'interface HTMLDocument définit les opérations et les requêtes
qui peuvent se produire sur un document HTML ;HTMLElement dérivée de l'interface principale Element.
L'interface HTMLElement définit les opérations et les requêtes
qui peuvent se produire sur un élément HTML. L'interface HTMLElement
comprend des méthodes permettant de récupérer et de modifier les attributs qui s'appliquent à tous les éléments HTML ;HTMLElement. Pour tous ces attributs,
l'interface dérivée pour l'élément contient des méthodes explicites pour fixer ou obtenir leurs valeurs.
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.
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.
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).
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.
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.
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é.
interface HTMLCollection { readonly attribute unsigned long length; Node item(in unsigned long index); Node namedItem(in DOMString name); };
length de type unsigned long, en lecture seuleitemindex de type unsigned long0.
|
|
L'objet |
namedItemNode 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.
name de type DOMStringNode à récupérer.|
|
L'objet |
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é.
// 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); };
length de type unsigned long|
|
NOT_SUPPORTED_ERR : Soulevée si la mise en œuvre ne permet pas de fixer la longueur. |
itemindex de type unsigned long0.|
|
L'objet |
namedItemNode 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.
name de type DOMStringNode à récupérer.|
|
L'objet |
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 :
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.
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); };
URL de type DOMString, en lecture seuleanchors de type HTMLCollection, en lecture seuleA) 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 seuleOBJECT, y compris les appliquettes,
et les éléments
APPLET (déconseillés) dans un document.body de type HTMLElementBODY, il retourne
l'élément BODY. Dans les documents avec des cadres, il retourne l'élément FRAMESET le plus externe.cookie de type DOMStringcookies
de [IETF RFC 2965], section 4.2.2.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.
|
|
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 seulenull si le serveur ne peut pas être identifié
par un nom de domaine.forms de type HTMLCollection, en lecture seuleimages de type HTMLCollection, en lecture seuleIMG 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 seuleAREA et les éléments ancres (A), dont l'attribut href
a une valeur, dans un document.referrer de type DOMString, en lecture seuletitle de type DOMStringTITLE dans l'en-tête du document.closeopen()
et force la restitution.
getElementsByNamename
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.
elementName de type DOMStringname d'un élément.|
|
Les éléments qui correspondent. |
openRemarque : 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]).
writeopen().
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.
text de type DOMStringwritelnopen().
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.
text de type DOMStringLes 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.
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.
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.
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 :
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].
className de type DOMStringclass 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 DOMStringid de type DOMStringlang de type DOMStringtitle de type DOMStringLa racine d'un document HTML. Cf. la définition de l'élément HTML →vf dans HTML 4.01.
interface HTMLHtmlElement : HTMLElement { attribute DOMString version; };
version de type DOMStringLes informations de l'en-tête du document. Cf. la définition de l'élément HEAD →vf dans HTML 4.01.
interface HTMLHeadElement : HTMLElement { attribute DOMString profile; };
profile de type DOMStringL'é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]).
charset de type DOMStringdisabled de type booleanhref de type DOMStringhreflang de type DOMStringmedia de type DOMStringrel de type DOMStringrev de type DOMStringtarget de type DOMStringtype de type DOMStringLe titre du document. Cf. la définition de l'élément TITLE →vf dans HTML 4.01.
interface HTMLTitleElement : HTMLElement { attribute DOMString text; };
text de type DOMStringCet 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.
interface HTMLMetaElement : HTMLElement { attribute DOMString content; attribute DOMString httpEquiv; attribute DOMString name; attribute DOMString scheme; };
content de type DOMStringhttpEquiv de type DOMStringname de type DOMStringscheme de type DOMStringL'adresse URI de base du document [IETF RFC 2396]. Cf. la définition de l'élément BASE →vf dans HTML 4.01.
interface HTMLBaseElement : HTMLElement { attribute DOMString href; attribute DOMString target; };
href de type DOMStringtarget de type DOMStringCet é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.
interface HTMLIsIndexElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString prompt; };
form de type HTMLFormElement, en lecture seuleFORM qui contient cette commande. Retourne la valeur null si cette commande
ne se trouve pas dans le contexte d'un formulaire.prompt de type DOMStringL'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].
interface HTMLStyleElement : HTMLElement { attribute boolean disabled; attribute DOMString media; attribute DOMString type; };
disabled de type booleanmedia de type DOMStringtype de type DOMStringLe 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.
interface HTMLBodyElement : HTMLElement { attribute DOMString aLink; attribute DOMString background; attribute DOMString bgColor; attribute DOMString link; attribute DOMString text; attribute DOMString vLink; };
aLink de type DOMStringbackground de type DOMStringbgColor de type DOMStringlink de type DOMStringtext de type DOMStringvLink de type DOMStringL'é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.
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(); };
acceptCharset de type DOMStringaction de type DOMStringelements de type HTMLCollection, en lecture seuleenctype de type DOMStringRemarque : 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 seulemethod de type DOMStringname de type DOMStringtarget de type DOMStringresetreset.
submitsubmit.
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.
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(); };
disabled de type booleanform de type HTMLFormElement, en lecture seuleFORM 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 2SELECT.|
|
NOT_SUPPORTED_ERR : Soulevée si la mise en œuvre ne permet pas de fixer la longueur. |
multiple de type booleanOPTION dans cet élément SELECT.
Cf. la définition de l'attribut multiple →vf
dans HTML 4.01.name de type DOMStringoptions de type HTMLOptionsCollection, en lecture seule, modifié dans DOM niveau 2OPTION contenue par cet élément.selectedIndex de type longsize de type longtabIndex de type longtype de type DOMString, en lecture seulemultiple a la valeur true et la chaîne "select-one" pour la valeur false.value de type DOMStringaddOPTION 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.
element de type HTMLElementbefore de type HTMLElementnull pour la queue de liste.|
|
NOT_FOUND_ERR : Soulevée si |
blurfocusremoveOPTION de cet élément SELECT.
Rien ne se passe si aucun élément n'a l'index fourni.
index de type longRegroupe les options en sous-divisions logiques. Cf. la définition de l'élément OPTGROUP →vf dans HTML 4.01.
interface HTMLOptGroupElement : HTMLElement { attribute boolean disabled; attribute DOMString label; };
disabled de type booleanlabel de type DOMStringUn choix sélectionnable. Cf. la définition de l'élément OPTION →vf dans HTML 4.01.
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; };
defaultSelected de type boolean, modifié dans DOM niveau 2disabled de type booleanform de type HTMLFormElement, en lecture seuleFORM 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 2OPTION dans son parent SELECT, commençant à "0".label de type DOMStringselected de type booleantext de type DOMString, en lecture seulevalue de type DOMStringUne 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].
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(); };
accept de type DOMStringaccessKey de type DOMStringalign de type DOMStringalt de type DOMStringchecked de type booleantype 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 booleantype 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 DOMStringtype 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 booleanform de type HTMLFormElement, en lecture seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.maxLength de type longtype a la valeur "text" ou "password".
Cf. la définition de l'attribut maxlength →vf
dans HTML 4.01.name de type DOMStringreadOnly de type booleantype 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 2src de type DOMStringtype 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 longtype de type DOMString, modifié dans DOM niveau 2useMap de type DOMStringvalue de type DOMStringtype 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.blurclickINPUT dont l'attribut type
a l'une des valeurs suivantes : "button", "checkbox", "radio", "reset" ou "submit".
focusselectINPUT dont
l'attribut type a l'une des valeurs suivantes : "text", "file" ou "password".
Une zone de saisie multiligne. Cf. la définition de l'élément TEXTAREA →vf dans HTML 4.01.
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(); };
accessKey de type DOMStringcols de type longdefaultValue de type DOMString, modifié dans DOM niveau 2disabled de type booleanform de type HTMLFormElement, en lecture seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.name de type DOMStringreadOnly de type booleanrows de type longtabIndex de type longtype de type DOMString, en lecture seulevalue de type DOMStringDOMString, la mise en œuvre peut les tronquer.blurfocusselectTEXTAREA.
Un bouton à presser. Cf. la définition de l'élément BUTTON →vf dans HTML 4.01.
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; };
accessKey de type DOMStringdisabled de type booleanform de type HTMLFormElement, en lecture seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.name de type DOMStringtabIndex de type longtype de type DOMString, en lecture seulevalue de type DOMStringL'intitulé de l'étiquette d'un champ de formulaire. Cf. la définition de l'élément LABEL →vf dans HTML 4.01.
interface HTMLLabelElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString htmlFor; };
accessKey de type DOMStringform de type HTMLFormElement, en lecture seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.htmlFor de type DOMStringid.
Cf. la définition de l'attribut for →vf
dans HTML 4.01.Arrange les commandes de formulaire en groupes logiques. Cf. la définition de l'élément FIELDSET →vf dans HTML 4.01.
interface HTMLFieldSetElement : HTMLElement { readonly attribute HTMLFormElement form; };
form de type HTMLFormElement, en lecture seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.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.
interface HTMLLegendElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString align; };
accessKey de type DOMStringalign de type DOMStringFIELDSET.
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 seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.Une liste non ordonnée. Cf. la définition de l'élément UL →vf dans HTML 4.01.
interface HTMLUListElement : HTMLElement { attribute boolean compact; attribute DOMString type; };
compact de type booleantype de type DOMStringUne liste ordonnée. Cf. la définition de l'élément OL →vf dans HTML 4.01.
interface HTMLOListElement : HTMLElement { attribute boolean compact; attribute long start; attribute DOMString type; };
compact de type booleanstart de type longtype de type DOMStringUne liste de définitions. Cf. la définition de l'élément DL →vf dans HTML 4.01.
interface HTMLDListElement : HTMLElement { attribute boolean compact; };
compact de type booleanUne 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.
interface HTMLDirectoryElement : HTMLElement { attribute boolean compact; };
compact de type booleanUne 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.
interface HTMLMenuElement : HTMLElement { attribute boolean compact; };
compact de type booleanUn élément de liste. Cf. la définition de l'élément LI →vf dans HTML 4.01.
interface HTMLLIElement : HTMLElement { attribute DOMString type; attribute long value; };
type de type DOMStringvalue de type longOL.
Cf. la définition de l'attribut value →vf
dans HTML 4.01. Cet attribut est déconseillé dans HTML 4.01.Un bloc conteneur générique. Cf. la définition de l'élément DIV →vf dans HTML 4.01.
interface HTMLDivElement : HTMLElement { attribute DOMString align; };
align de type DOMStringUn paragraphe. Cf. la définition de l'élément P →vf dans HTML 4.01.
interface HTMLParagraphElement : HTMLElement { attribute DOMString align; };
align de type DOMStringPour les éléments H1 à H6.
Cf. la définition de l'élément H1 →vf
dans HTML 4.01.
interface HTMLHeadingElement : HTMLElement { attribute DOMString align; };
align de type DOMStringPour les éléments Q et BLOCKQUOTE.
Cf. les définitions des éléments Q et BLOCKQUOTE →vf
dans HTML 4.01.
interface HTMLQuoteElement : HTMLElement { attribute DOMString cite; };
cite de type DOMStringUn texte préformaté. Cf. la définition de l'élément PRE →vf dans HTML 4.01.
interface HTMLPreElement : HTMLElement { attribute long width; };
width de type longForce un saut de ligne. Cf. la définition de l'élément BR →vf dans HTML 4.01.
interface HTMLBRElement : HTMLElement { attribute DOMString clear; };
clear de type DOMStringLa 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.
interface HTMLBaseFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; // Modifié dans DOM niveau 2 : attribute long size; };
color de type DOMStringface de type DOMStringsize de type long, modifié dans DOM niveau 2Un 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.
interface HTMLFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; attribute DOMString size; };
color de type DOMStringface de type DOMStringsize de type DOMStringCrée une règle horizontale. Cf. la définition de l'élément HR →vf dans HTML 4.01.
interface HTMLHRElement : HTMLElement { attribute DOMString align; attribute boolean noShade; attribute DOMString size; attribute DOMString width; };
align de type DOMStringnoShade de type booleansize de type DOMStringwidth de type DOMStringUn 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.
interface HTMLModElement : HTMLElement { attribute DOMString cite; attribute DOMString dateTime; };
cite de type DOMStringdateTime de type DOMStringL'élément ancre. Cf. la définition de l'élément A →vf dans HTML 4.01.
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(); };
accessKey de type DOMStringcharset de type DOMStringcoords de type DOMStringshape pour la forme de la région.
Cf. la définition de l'attribut coords →vf
dans HTML 4.01.href de type DOMStringhreflang de type DOMStringname de type DOMStringrel de type DOMStringrev de type DOMStringshape de type DOMStringcoords.
Cf. la définition de l'attribut shape →vf
dans HTML 4.01.tabIndex de type longtarget de type DOMStringtype de type DOMStringUne image incorporée. Cf. la définition de l'élément IMG →vf dans HTML 4.01.
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; };
align de type DOMStringalt de type DOMStringborder de type DOMStringDOMString
dans DOM niveau 1 HTML [DOM niveau 1].height de type long, modifié dans DOM niveau 2DOMString dans DOM niveau 1 HTML [DOM niveau 1].hspace de type long, modifié dans DOM niveau 2DOMString
dans DOM niveau 1 HTML [DOM niveau 1].isMap de type booleanlongDesc de type DOMStringname de type DOMStringsrc de type DOMStringuseMap de type DOMStringvspace de type long, modifié dans DOM niveau 2DOMString
dans DOM niveau 1 HTML [DOM niveau 1].width de type long, modifié dans DOM niveau 2DOMString dans DOM niveau 1 HTML
[DOM niveau 1].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].
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; };
align de type DOMStringarchive de type DOMStringborder de type DOMStringcode de type DOMStringcode pour l'objet HTMLAppletElement.codeBase de type DOMStringclassid, data et archive. Cf. la définition de l'attribut codebase →vf
dans HTML 4.01.codeType de type DOMStringclassid.
Cf. la définition de l'attribut codetype →vf
dans HTML 4.01.contentDocument de type Document, en lecture seule, introduit dans DOM niveau 2null sinon.data de type DOMStringdeclare de type booleanform de type HTMLFormElement, en lecture seuleFORM contenant cette commande. Retourne la valeur null si cette commande ne se trouve pas
dans le contexte d'un formulaire.height de type DOMStringhspace de type longname de type DOMStringstandby de type DOMStringtabIndex de type longtype de type DOMStringdata.
Cf. la définition de l'attribut type →vf
dans HTML 4.01.useMap de type DOMStringvspace de type longwidth de type DOMStringLes paramètres fournis à l'élément OBJECT. Cf. la définition de l'élément PARAM →vf
dans HTML 4.01.
interface HTMLParamElement : HTMLElement { attribute DOMString name; attribute DOMString type; attribute DOMString value; attribute DOMString valueType; };
name de type DOMStringtype de type DOMStringvalue lorsque l'attribut valuetype vaut "ref".
Cf. la définition de l'attribut type →vf
dans HTML 4.01.value de type DOMStringvalueType de type DOMStringvalue.
Cf. la définition de l'attribut valuetype →vf
dans HTML 4.01.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.
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; };
align de type DOMStringalt de type DOMStringarchive de type DOMStringcode de type DOMStringcodeBase de type DOMStringheight de type DOMStringhspace de type long, modifié dans DOM niveau 2name de type DOMStringobject de type DOMString, modifié dans DOM niveau 2object. 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 2width de type DOMStringDes images cliquables côté client. Cf. la définition de l'élément MAP →vf dans HTML 4.01.
interface HTMLMapElement : HTMLElement { readonly attribute HTMLCollection areas; attribute DOMString name; };
areas de type HTMLCollection, en lecture seulename de type DOMStringusemap). Cf. la définition de l'attribut name →vf
dans HTML 4.01.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.
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; };
accessKey de type DOMStringalt de type DOMStringcoords de type DOMStringshape pour la forme de la région.
Cf. la définition de l'attribut coords →vf
dans HTML 4.01.href de type DOMStringnoHref de type booleanshape de type DOMStringcoords.
Cf. la définition de l'attribut shape →vf
dans HTML 4.01.tabIndex de type longtarget de type DOMStringLes déclarations de scripts. Cf. la définition de l'élément SCRIPT →vf dans HTML 4.01.
interface HTMLScriptElement : HTMLElement { attribute DOMString text; attribute DOMString htmlFor; attribute DOMString event; attribute DOMString charset; attribute boolean defer; attribute DOMString src; attribute DOMString type; };
charset de type DOMStringdefer de type booleanevent de type DOMStringhtmlFor de type DOMStringsrc de type DOMStringtext de type DOMStringtype de type DOMStringLes 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.
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); };
align de type DOMStringbgColor de type DOMStringborder de type DOMStringcaption de type HTMLTableCaptionElement, modifié dans DOM niveau 2CAPTION), ou la valeur null s'il n'y en a pas.|
|
HIERARCHY_REQUEST_ERR : Soulevée si ce n'est pas un élément |
cellPadding de type DOMStringcellSpacing de type DOMStringframe de type DOMStringrows de type HTMLCollection, en lecture seuleTHEAD, TFOOT, et tous les éléments TBODY.rules de type DOMStringsummary de type DOMStringtBodies de type HTMLCollection, en lecture seuletFoot de type HTMLTableSectionElement, modifié dans DOM niveau 2TFOOT de la table, ou la valeur null s'il n'y en a pas.|
|
HIERARCHY_REQUEST_ERR : Soulevée si ce n'est pas un élément |
tHead de type HTMLTableSectionElement, modifié dans DOM niveau 2THEAD de la table, ou la valeur null s'il n'y en a pas.|
|
HIERARCHY_REQUEST_ERR : Soulevée si ce n'est pas un élément |
width de type DOMStringcreateCaption|
Un élément |
createTFoot|
Un élément |
createTHead|
Un élément |
deleteCaptiondeleteRow, modifié dans DOM niveau 2index de type long|
|
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". |
deleteTFootdeleteTHeadinsertRow, modifié dans DOM niveau 2index 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].
index de type long|
La rangée qui vient d'être créée. |
|
|
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". |
Une légende de table. Cf. la définition de l'élément CAPTION →vf dans HTML 4.01.
interface HTMLTableCaptionElement : HTMLElement { attribute DOMString align; };
align de type DOMStringRegroupe les éléments COL et COLGROUP. Cf. la définition de l'élément COL →vf
dans HTML 4.01.
interface HTMLTableColElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute long span; attribute DOMString vAlign; attribute DOMString width; };
align de type DOMStringch de type DOMStringchOff de type DOMStringspan de type longvAlign de type DOMStringwidth de type DOMStringLes éléments THEAD, TFOOT et TBODY.
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); };
align de type DOMStringalign de l'objet HTMLTheadElement
pour le détail.ch de type DOMStringchOff de type DOMStringrows de type HTMLCollection, en lecture seulevAlign de type DOMStringvalign de l'objet HTMLTheadElement
pour des précisions.deleteRow, modifié dans DOM niveau 2index de type long|
|
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". |
insertRow, modifié dans DOM niveau 2index vaut "-1" ou est égale au nombre de rangées
dans cette section, la nouvelle rangée s'ajoute à la fin.
index de type long|
La rangée qui vient d'être créée. |
|
|
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". |
Une rangée dans une table. Cf. la définition de l'élément TR →vf dans HTML 4.01.
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); };
align de type DOMStringbgColor de type DOMStringcells de type HTMLCollection, en lecture seule, modifié dans DOM niveau 2ch de type DOMStringchOff de type DOMStringrowIndex de type long, en lecture seule, modifié dans DOM niveau 2rowIndex
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 2THEAD, TFOOT ou TBODY),
commençant à "0".vAlign de type DOMStringdeleteCell, modifié dans DOM niveau 2index de type long|
|
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". |
insertCell, modifié dans DOM niveau 2TD dans cette rangée. Si l'attribut index vaut "-1"
ou est égal au nombre des cellules, la nouvelle cellule s'ajoute à la fin.
index de type long|
La cellule qui vient d'être créée. |
|
|
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'objet servant à représenter les éléments TH et TD.
Cf. la définition de l'élément TD →vf
dans HTML 4.01.
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; };
abbr de type DOMStringalign de type DOMStringaxis de type DOMStringbgColor de type DOMStringcellIndex de type long, en lecture seulech de type DOMStringchOff de type DOMStringcolSpan de type longheaders de type DOMStringid des cellules de rubrique. Cf. la
définition de l'attribut headers →vf
dans HTML 4.01.height de type DOMStringnoWrap de type booleanrowSpan de type longscope de type DOMStringvAlign de type DOMStringwidth de type DOMStringCrée une grille de cadres. Cf. la définition de l'élément FRAMESET →vf dans HTML 4.01.
interface HTMLFrameSetElement : HTMLElement { attribute DOMString cols; attribute DOMString rows; };
cols de type DOMStringrows de type DOMStringCrée un cadre. Cf. la définition de l'élément FRAME →vf dans HTML 4.01.
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; };
contentDocument de type Document, en lecture seule, introduit dans DOM niveau 2null sinon.frameBorder de type DOMStringlongDesc de type DOMStringmarginHeight de type DOMStringmarginWidth de type DOMStringname de type DOMStringtarget). Cf. la définition de l'attribut name →vf
dans HTML 4.01.noResize de type booleanscrolling de type DOMStringsrc de type DOMStringLes sous-fenêtres en-ligne. Cf. la définition de l'élément IFRAME →vf dans HTML 4.01.
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; };
align de type DOMStringcontentDocument de type Document, en lecture seule, introduit dans DOM niveau 2null sinon.frameBorder de type DOMStringheight de type DOMStringlongDesc de type DOMStringmarginHeight de type DOMStringmarginWidth de type DOMStringname de type DOMStringtarget).
Cf. la définition de l'attribut name →vf
dans HTML 4.01.scrolling de type DOMStringsrc de type DOMStringwidth de type DOMString