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 DOMString