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 seuleitem
index
de type unsigned long
0
.
|
L'objet |
namedItem
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.
name
de type DOMString
Node
à 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. |
item
index
de type unsigned long
0
.
|
L'objet |
namedItem
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.
name
de type DOMString
Node
à 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 HTMLElement
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
cookies
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 DOMString
TITLE
dans l'en-tête du document.close
open()
et force la restitution.
getElementsByName
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.
elementName
de type DOMString
name
d'un élément.
|
Les éléments qui correspondent. |
open
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]).
write
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.
text
de type DOMString
writeln
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.
text
de type DOMString
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.
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 DOMString
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
id
de type DOMString
lang
de type DOMString
title
de type DOMString
La 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 DOMString
Les 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 DOMString
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]).
charset
de type DOMString
disabled
de type boolean
href
de type DOMString
hreflang
de type DOMString
media
de type DOMString
rel
de type DOMString
rev
de type DOMString
target
de type DOMString
type
de type DOMString
Le 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 DOMString
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.
interface HTMLMetaElement : HTMLElement { attribute DOMString content; attribute DOMString httpEquiv; attribute DOMString name; attribute DOMString scheme; };
content
de type DOMString
httpEquiv
de type DOMString
name
de type DOMString
scheme
de type DOMString
L'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 DOMString
target
de type DOMString
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.
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 DOMString
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].
interface HTMLStyleElement : HTMLElement { attribute boolean disabled; attribute DOMString media; attribute DOMString type; };
disabled
de type boolean
media
de type DOMString
type
de type DOMString
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.
interface HTMLBodyElement : HTMLElement { attribute DOMString aLink; attribute DOMString background; attribute DOMString bgColor; attribute DOMString link; attribute DOMString text; attribute DOMString vLink; };
aLink
de type DOMString
background
de type DOMString
bgColor
de type DOMString
link
de type DOMString
text
de type DOMString
vLink
de type DOMString
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.
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 DOMString
action
de type DOMString
elements
de type HTMLCollection
, en lecture seuleenctype
de type DOMString
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 seulemethod
de type DOMString
name
de type DOMString
target
de type DOMString
reset
reset
.
submit
submit
.
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 boolean
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.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 boolean
OPTION
dans cet élément SELECT
.
Cf. la définition de l'attribut multiple →vf
dans HTML 4.01.name
de type DOMString
options
de type HTMLOptionsCollection
, en lecture seule, modifié dans DOM niveau 2OPTION
contenue par cet élément.selectedIndex
de type long
size
de type long
tabIndex
de type long
type
de type DOMString
, en lecture seulemultiple
a la valeur true
et la chaîne "select-one" pour la valeur false
.value
de type DOMString
add
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
.
element
de type HTMLElement
before
de type HTMLElement
null
pour la queue de liste.
|
NOT_FOUND_ERR : Soulevée si |
blur
focus
remove
OPTION
de cet élément SELECT
.
Rien ne se passe si aucun élément n'a l'index fourni.
index
de type long
Regroupe 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 boolean
label
de type DOMString
Un 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 boolean
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.index
de type long
, en lecture seule, modifié dans DOM niveau 2OPTION
dans son parent SELECT
, commençant à "0".label
de type DOMString
selected
de type boolean
text
de type DOMString
, en lecture seulevalue
de type DOMString
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].
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 DOMString
accessKey
de type DOMString
align
de type DOMString
alt
de type DOMString
checked
de type boolean
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
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
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
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.maxLength
de type long
type
a la valeur "text" ou "password".
Cf. la définition de l'attribut maxlength →vf
dans HTML 4.01.name
de type DOMString
readOnly
de type boolean
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 2src
de type DOMString
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
type
de type DOMString
, modifié dans DOM niveau 2useMap
de type DOMString
value
de type DOMString
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.blur
click
INPUT
dont l'attribut type
a l'une des valeurs suivantes : "button", "checkbox", "radio", "reset" ou "submit".
focus
select
INPUT
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 DOMString
cols
de type long
defaultValue
de type DOMString
, modifié dans DOM niveau 2disabled
de type boolean
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.name
de type DOMString
readOnly
de type boolean
rows
de type long
tabIndex
de type long
type
de type DOMString
, en lecture seulevalue
de type DOMString
DOMString
, la mise en œuvre peut les tronquer.blur
focus
select
TEXTAREA
.
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 DOMString
disabled
de type boolean
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.name
de type DOMString
tabIndex
de type long
type
de type DOMString
, en lecture seulevalue
de type DOMString
L'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 DOMString
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.htmlFor
de type DOMString
id
.
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 DOMString
align
de type DOMString
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 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 boolean
type
de type DOMString
Une 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 boolean
start
de type long
type
de type DOMString
Une 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 boolean
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.
interface HTMLDirectoryElement : HTMLElement { attribute boolean compact; };
compact
de type boolean
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.
interface HTMLMenuElement : HTMLElement { attribute boolean compact; };
compact
de type boolean
Un é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 DOMString
value
de type long
OL
.
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 DOMString
Un paragraphe. Cf. la définition de l'élément P →vf dans HTML 4.01.
interface HTMLParagraphElement : HTMLElement { attribute DOMString align; };
align
de type DOMString
Pour 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 DOMString
Pour 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 DOMString
Un 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 long
Force 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 DOMString
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.
interface HTMLBaseFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; // Modifié dans DOM niveau 2 : attribute long size; };
color
de type DOMString
face
de type DOMString
size
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 DOMString
face
de type DOMString
size
de type DOMString
Cré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 DOMString
noShade
de type boolean
size
de type DOMString
width
de type DOMString
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.
interface HTMLModElement : HTMLElement { attribute DOMString cite; attribute DOMString dateTime; };
cite
de type DOMString
dateTime
de type DOMString
L'é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 DOMString
charset
de type DOMString
coords
de type DOMString
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
hreflang
de type DOMString
name
de type DOMString
rel
de type DOMString
rev
de type DOMString
shape
de type DOMString
coords
.
Cf. la définition de l'attribut shape →vf
dans HTML 4.01.tabIndex
de type long
target
de type DOMString
type
de type DOMString
Une 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 DOMString
alt
de type DOMString
border
de type DOMString
DOMString
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 boolean
longDesc
de type DOMString
name
de type DOMString
src
de type DOMString
useMap
de type DOMString
vspace
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 DOMString
archive
de type DOMString
border
de type DOMString
code
de type DOMString
code
pour l'objet HTMLAppletElement
.codeBase
de type DOMString
classid
, data
et archive
. Cf. la définition de l'attribut codebase →vf
dans HTML 4.01.codeType
de type DOMString
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 2null
sinon.data
de type DOMString
declare
de type boolean
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.height
de type DOMString
hspace
de type long
name
de type DOMString
standby
de type DOMString
tabIndex
de type long
type
de type DOMString
data
.
Cf. la définition de l'attribut type →vf
dans HTML 4.01.useMap
de type DOMString
vspace
de type long
width
de type DOMString
Les 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 DOMString
type
de type DOMString
value
lorsque l'attribut valuetype
vaut "ref".
Cf. la définition de l'attribut type →vf
dans HTML 4.01.value
de type DOMString
valueType
de type DOMString
value
.
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 DOMString
alt
de type DOMString
archive
de type DOMString
code
de type DOMString
codeBase
de type DOMString
height
de type DOMString
hspace
de type long
, modifié dans DOM niveau 2name
de type DOMString
object
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 DOMString
Des 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 DOMString
usemap
). 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 DOMString
alt
de type DOMString
coords
de type DOMString
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
noHref
de type boolean
shape
de type DOMString
coords
.
Cf. la définition de l'attribut shape →vf
dans HTML 4.01.tabIndex
de type long
target
de type DOMString
Les 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 DOMString
defer
de type boolean
event
de type DOMString
htmlFor
de type DOMString
src
de type DOMString
text
de type DOMString
type
de type DOMString
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.
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 DOMString
bgColor
de type DOMString
border
de type DOMString
caption
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 DOMString
cellSpacing
de type DOMString
frame
de type DOMString
rows
de type HTMLCollection
, en lecture seuleTHEAD
, TFOOT
, et tous les éléments TBODY
.rules
de type DOMString
summary
de type DOMString
tBodies
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 DOMString
createCaption
Un élément |
createTFoot
Un élément |
createTHead
Un élément |
deleteCaption
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". |
deleteTFoot
deleteTHead
insertRow
, 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 DOMString
Regroupe 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 DOMString
ch
de type DOMString
chOff
de type DOMString
span
de type long
vAlign
de type DOMString
width
de type DOMString
Les é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 DOMString
align
de l'objet HTMLTheadElement
pour le détail.ch
de type DOMString
chOff
de type DOMString
rows
de type HTMLCollection
, en lecture seulevAlign
de type DOMString
valign
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 DOMString
bgColor
de type DOMString
cells
de type HTMLCollection
, en lecture seule, modifié dans DOM niveau 2ch
de type DOMString
chOff
de type DOMString
rowIndex
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 DOMString
deleteCell
, 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 DOMString
align
de type DOMString
axis
de type DOMString
bgColor
de type DOMString
cellIndex
de type long
, en lecture seulech
de type DOMString
chOff
de type DOMString
colSpan
de type long
headers
de type DOMString
id
des cellules de rubrique. Cf. la
définition de l'attribut headers →vf
dans HTML 4.01.height
de type DOMString
noWrap
de type boolean
rowSpan
de type long
scope
de type DOMString
vAlign
de type DOMString
width
de type DOMString
Cré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 DOMString
rows
de type DOMString
Cré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 DOMString
longDesc
de type DOMString
marginHeight
de type DOMString
marginWidth
de type DOMString
name
de type DOMString
target
). Cf. la définition de l'attribut name →vf
dans HTML 4.01.noResize
de type boolean
scrolling
de type DOMString
src
de type DOMString
Les 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 DOMString
contentDocument
de type Document
, en lecture seule, introduit dans DOM niveau 2null
sinon.frameBorder
de type DOMString
height
de type DOMString
longDesc
de type DOMString
marginHeight
de type DOMString
marginWidth
de type DOMString
name
de type DOMString
target
).
Cf. la définition de l'attribut name →vf
dans HTML 4.01.scrolling
de type DOMString
src
de type DOMString
width
de type DOMString