Copyright ©2001 W3C® (MIT, INRIA, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply.
This specification defines the Document Object Model Level 2 HTML, a platform- and language-neutral interface that allows programs and scripts to dynamically access and update the content and structure of HTML 4.0 and XHTML 1.0 documents. The Document Object Model Level 2 HTML builds on the Document Object Model Level 2 Core [DOM Level 2 Core].
The DOM Level 2 HTML is made of a set of specific interfaces to manipulate the structure and contents of an HTML document.
This section describes the status of this document at the time of its publication. Other documents may supersede this document. The latest status of this document series is maintained at the W3C.
This is a W3C Last Call Working Draft for review by W3C members and other interested parties. The Last Call review period ends on 7 January 2002. Please send review comments before the review period ends to www-dom@w3.org (archive).
It is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to use W3C Working Drafts as reference material or to cite them as other than "work in progress". This is work in progress and does not imply endorsement by, or the consensus of, either W3C or members of the DOM Working Group or members of the HTML Working Group.
This document has been produced as part of the W3C DOM Activity. The authors of this document are the DOM Working Group members.
A list of current W3C Recommendations and other technical documents can be found at http://www.w3.org/TR.
Copyright © 2001 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved.
This document is published under the W3C Document Copyright Notice and License. The bindings within this document are published under the W3C Software Copyright Notice and License. The software license requires "Notice of any changes or modifications to the W3C files, including the date changes were made." Consequently, modified versions of the DOM bindings must document that they do not conform to the W3C standard; in the case of the IDL definitions, the pragma prefix can no longer be 'w3c.org'; in the case of the Java Language binding, the package names can no longer be in the 'org.w3c' package.
Note: This section is a copy of the W3C Document Notice and License and could be found at http://www.w3.org/Consortium/Legal/copyright-documents-19990405.
Copyright © 1994-2001 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved.
http://www.w3.org/Consortium/Legal/
Public documents on the W3C site are provided by the copyright holders under the following license. The software or Document Type Definitions (DTDs) associated with W3C specifications are governed by the Software Notice. By using and/or copying this document, or the W3C document from which this statement is linked, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions:
Permission to use, copy, and distribute the contents of this document, or the W3C document from which this statement is linked, in any medium for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the document, or portions thereof, that you use:
When space permits, inclusion of the full text of this NOTICE should be provided. We request that authorship attribution be provided in any software, documents, or other items or products that you create pursuant to the implementation of the contents of this document, or any portion thereof.
No right to create modifications or derivatives of W3C documents is granted pursuant to this license. However, if additional requirements (documented in the Copyright FAQ) are satisfied, the right to create modifications or derivatives is sometimes granted by the W3C to individuals complying with those requirements.
THIS DOCUMENT IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE; NOR THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE DOCUMENT OR THE PERFORMANCE OR IMPLEMENTATION OF THE CONTENTS THEREOF.
The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to this document or its contents without specific, written prior permission. Title to copyright in this document will at all times remain with copyright holders.
Note: This section is a copy of the W3C Software Copyright Notice and License and could be found at http://www.w3.org/Consortium/Legal/copyright-software-19980720
Copyright © 1994-2001 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved.
http://www.w3.org/Consortium/Legal/
This W3C work (including software, documents, or other related items) is being provided by the copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions:
Permission to use, copy, and modify this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the software and documentation or portions thereof, including modifications, that you make:
THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will at all times remain with copyright holders.
This section extends the DOM Level 2 Core API [DOM Level 2 Core] to describe objects and methods specific to HTML documents [HTML4.0], and XHTML documents [XHTML 1.0]. In general, the functionality needed to manipulate hierarchical document structures, elements, and attributes will be found in the core section; functionality that depends on the specific elements defined in HTML will be found in this section.
The goals of the HTML-specific DOM API are:
The key differences between the core DOM and the HTML application of DOM is that the HTML Document Object Model exposes a number of convenience methods and properties that are consistent with the existing models and are more appropriate to script writers. In many cases, these enhancements are not applicable to a general DOM because they rely on the presence of a predefined DTD. The transitional or frameset DTD for HTML 4.0, or the XHTML 1.0 DTD are assumed. Interoperability between implementations is only guaranteed for elements and attributes that are specified in the HTML 4.0 and XHTML 1.0 DTDs.
More specifically, this document includes the following specializations for HTML:
HTMLDocument
interface, derived from the core Document
interface.
HTMLDocument
specifies the operations and queries that can be made on a HTML
document.HTMLElement
interface, derived from the core Element
interface. HTMLElement
specifies
the operations and queries that can be made on any HTML element.
Methods on HTMLElement
include
those that allow for the retrieval and modification of attributes
that apply to all HTML elements.HTMLElement
interface. For all such attributes, the derived interface for the
element contains explicit methods for setting and getting the
values.The DOM Level 2 includes mechanisms to access and modify style specified through CSS and defines an event model that can be used with HTML documents.
The interfaces found within this section are not mandatory. A
DOM application may use the hasFeature(feature,
version)
method of the DOMImplementation
interface with parameter values "HTML" and "2.0" (respectively) to
determine whether or not this module is supported by the
implementation. In addition to the feature string "HTML", the
feature string "XHTML" (version string "2.0") can be used to check
if the implementation supports XHTML (this is equivalent to
checking the features "XML" and "HTML"). In order to fully support
this module, an implementation must also support the "Core" feature
defined [DOM Level 2 Core]. Please refer
to additional information about
conformance in the DOM Level 2 Core specification [DOM Level 2
Core].
A DOM application can use the hasFeature
method of
the DOMImplementation
interface to determine whether
they are supported or not. The feature string for all the
interfaces listed in this section is "HTML" and the version is
"2.0". Note that, since DOM Level 2 HTML is not backward compatible
with DOM Level 1 [DOM Level 1], a DOM Level 2
HTML implementation must not claim to implement the feature "HTML"
version "1.0". In order to fully support this feature, an
implementation needs also to support the "Core" feature defined in
the Document Object Model Level 2 Core [DOM Level 2 Core] (see also
Conformance).
The interfaces in this specification are designed for HTML 4.0 documents, as well as for XHTML 1.0 documents.
The HTML DOM follows a naming convention for properties, methods, events, collections, and data types. All names are defined as one or more English words concatenated together to form a single string.
The property or method name starts with the initial keyword in lowercase, and each subsequent word starts with a capital letter. For example, a property that returns document meta information such as the date the file was created might be named "fileDateCreated". In the ECMAScript binding, properties are exposed as properties of a given object. In Java, properties are exposed with get and set methods.
While most of the interfaces defined below can be mapped directly to elements defined in the HTML 4.0 Recommendation, some of them cannot. Similarly, not all attributes listed below have counterparts in the HTML 4.0 specification (and some do, but have been renamed to avoid conflicts with scripting languages). Interfaces and attribute definitions that have links to the HTML 4.0 specification have corresponding element and attribute definitions there; all others are added by this specification, either for convenience or backwards compatibility with DOM Level 0 implementations.
The DOM HTML Level 1 API's [DOM Level 1] were originally
intended to be used only for HTML 4.0 documents [HTML4.0]
and the APIs were defined well before XHTML 1.0 [XHTML
1.0] became a specification, or was even being worked on by the
HTML working group. The biggest difference between HTML 4.0 (and
earlier) and XHTML 1.0 (from the DOM point of view) is that XHTML
is case sensitive, whereas HTML 4.0 is case insensitive. The HTML
case insensitivity is also reflected in the DOM HTML API's in some
ways, for instance, element and attribute names are exposed as all
upper case (for consistency) when used on an HTML document,
regardless of the character case used in the markup. In XHTML
everything is case sensitive (since XHTML is based on XML) and
element and attribute names must be lower case in the markup.
Because of this there are certain things that developers need to
keep in mind when writing code that should work on both HTML and
XHTML documents. There are basically two things that need to be
taken into account, one is that when comparing element or attribute
names to strings the string compare needs to be case insensitive,
or the element or attribute name needs to be converted into
lowercase before comparing against a lowercase string. The other
thing is that when calling methods that are case insensitive when
used on a HTML document (such as
getElementsByTagName()
and namedItem()
)
the string that is passed in should be lower case to work on both
HTML and XHTML documents.
The HTMLDOMImplementation
interface extends the
DOMImplementation
interface with a method for creating
an HTML document instance. The core DOMImplementation
interface can be used to create XHTML documents by passing the
XHTML namespace as the namespace for the root element.
// Introduced in DOM Level 2: interface HTMLDOMImplementation : DOMImplementation { HTMLDocument createHTMLDocument(in DOMString title); };
createHTMLDocument
HTMLDocument
object
with the minimal tree made of the following elements:
HTML
, HEAD
, TITLE
, and
BODY
.
title
of type
DOMString
TITLE
element, through a child Text
node.
A new |
An HTMLCollection
is a list of nodes. An individual
node may be accessed by either ordinal index or the node's
name
or id
attributes.
Note: Collections in the HTML DOM are assumed to be live meaning that they are automatically updated when the underlying document is changed.
interface HTMLCollection { readonly attribute unsigned long length; Node item(in unsigned long index); Node namedItem(in DOMString name); };
length
of type unsigned
long
, readonlyitem
index
of type
unsigned long
|
The |
namedItem
Node
using
a name. It first searches for a Node
with a matching
id
attribute. If it doesn't find one, it then searches
for a Node
with a matching name
attribute, but only on those elements that are allowed a name
attribute. This method is case insensitive in HTML documents and
case sensitive in XHTML documents.
name
of type
DOMString
Node
to be fetched.
|
The |
An HTMLDocument
is the root of the HTML hierarchy
and holds the entire content. Besides providing access to the
hierarchy, it also provides some convenience
methods for accessing certain sets of information from the
document.
The following properties have been deprecated in favor of the
corresponding ones for the BODY
element:
Note: In DOM Level 2, the method
getElementById
is inherited from the
Document
interface where it was moved to.
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; // raises(DOMException) on setting void open(); void close(); void write(in DOMString text); void writeln(in DOMString text); NodeList getElementsByName(in DOMString elementName); };
URL
of type DOMString
,
readonlyanchors
of type HTMLCollection
,
readonlyA
) elements in a
document with a value for the name
attribute.
Note: For reasons of backwards compatibility, the
returned set of anchors only contains those anchors created with
the name
attribute, not those created with the
id
attribute.
applets
of type HTMLCollection
,
readonlyOBJECT
elements that
include applets and APPLET
(deprecated)
elements in a document.body
of type HTMLElement
BODY
contents, returns the
BODY
element. In frameset documents, this returns the
outermost FRAMESET
element.cookie
of type
DOMString
cookies
non-terminal of [RFC2965], Section 4.2.2.cookie
non-terminal of [RFC2965]; that is, it should
be a single name-value pair followed by zero or more cookie
attribute values. If no domain attribute is specified, then the
domain attribute for the new value defaults to the host portion of
an absolute URI [RFC2396] of the current frame or
document. If no path attribute is specified, then the path
attribute for the new value defaults to the absolute path portion
of the URI [RFC2396] of the current frame or
document. If no max-age attribute is specified, then the max-age
attribute for the new value defaults to a user agent defined value.
If a cookie with the specified name is already associated with the
current frame or document, then the new value as well as the new
attributes replace the old value and attributes. If a max-age
attribute of 0 is specified for the new value, then any existing
cookies of the specified name are removed from the cookie storage.
Note: See [RFC2965] for the semantics of persistent state item attribute value pairs.
Note: The precise nature of a user agent session is not defined by this specification.
|
SYNTAX_ERR: If the new value does not adhere to the cookie syntax specified by [RFC2965]. |
domain
of type DOMString
,
readonlynull
if the server cannot be identified by a domain
name.forms
of type HTMLCollection
,
readonlyimages
of type HTMLCollection
,
readonlyIMG
elements in a
document. The behavior is limited to IMG
elements for
backwards compatibility.links
of type HTMLCollection
,
readonlyAREA
elements and anchor
(A
) elements in a document with a value for the
href
attribute.referrer
of type
DOMString
, readonlytitle
of type
DOMString
TITLE
element in the head of the document.close
open()
and forces rendering.
getElementsByName
name
value is given by
elementName
. This method is case sensitive.
elementName
of type
DOMString
name
attribute value for an element.
|
The matching elements. |
open
Note: This method and the ones following allow a user to add to or replace the structure model of a document using strings of unparsed HTML. At the time of writing alternate methods for providing similar functionality for both HTML and XML documents were being considered (see [DOM Level 3 Abstract Schemas and Load and Save]). The following methods may be deprecated at some point in the future in favor of a more general-purpose mechanism.
write
open()
. The text is parsed into the
document's structure model.
text
of type
DOMString
writeln
open()
. The
text is parsed into the document's structure model.
text
of type
DOMString
HTML attributes are exposed as properties on the element object. The DOM naming conventions always determine the name of the exposed property, and is independent of the case of the attribute in the source document. The data type of the property is in general determined by the type of the attribute as determined by the HTML 4.0 (transitional and frameset) and XHTML 1.0 DTDs. The attributes have the semantics (including case-sensitivity) given in the HTML 4.0 and XHTML 1.0 specifications.
The attributes are exposed as properties for compatibility with
DOM Level 0.
This usage is deprecated because it can not be generalized to all
possible attribute names, as is required both for XML and
potentially for future versions of HTML. We recommend the use of
generic methods on the core Element
interface for
setting, getting and removing attributes.
DTD Data Type | Object Model Data Type |
---|---|
CDATA | DOMString |
Value list (e.g., (left | right | center)) | DOMString |
one-value Value list (e.g., (disabled)) | boolean |
Number | long int |
In an HTML document the return value of an attribute that has a data type that is a value list is normalized to lower case (independent of the case of the value in the source document).
For example, if the value of the align attribute on a P element
is "Left" (which is not a valid value in XHTML due to the case
sensitivity of XHTML) then the value is returned as "left". For
attributes with the CDATA
data type, the case of the
return value is that given in the source document.
The return value of an attribute that is unspecified and does not have a default value is the empty string if the return type is a DOMString, false if the return type is a boolean and 0 if the return type is a number.
To avoid namespace conflicts, an attribute with the same name as
a keyword in one of our chosen binding languages
is prefixed. For HTML, the prefix used is "html". For example, the
for
attribute of the LABEL
element
collides with loop construct naming conventions and is renamed
htmlFor
.
tagName
, (nodeName
))If the document is a HTML 4.0 document the element type names
exposed through a property are in uppercase. For example, the body
element type name is exposed through the tagName
property as BODY
. If the document is an XHTML 1.0 or
above document the element name is exposed as it is written in the
XHTML file. This means that the element type names are exposed in
lower case for XHTML documents since the XHTML 1.0 DTD defines
element type names as lower case, and XHTML, being derived from
XML, is case sensitive.
All HTML element interfaces derive from this class. Elements
that only expose the HTML core attributes are represented by the
base HTMLElement
interface. These elements are as
follows:
Note: The style
attribute of an HTML element
is accessible through the ElementCSSInlineStyle
interface which is defined in the CSS module [DOM Level
2 Style Sheets and CSS].
interface HTMLElement : Element { attribute DOMString id; attribute DOMString title; attribute DOMString lang; attribute DOMString dir; attribute DOMString className; };
className
of type
DOMString
dir
of type
DOMString
id
of type
DOMString
lang
of type
DOMString
title
of type
DOMString
Root of an HTML document. See the HTML element definition in HTML 4.0.
interface HTMLHtmlElement : HTMLElement { attribute DOMString version; };
version
of type
DOMString
Document head information. See the HEAD element definition in HTML 4.0.
interface HTMLHeadElement : HTMLElement { attribute DOMString profile; };
profile
of type
DOMString
The LINK
element specifies a link to an external
resource, and defines this document's relationship to that resource
(or vice versa). See the
LINK element definition in HTML 4.0 (see also the
LinkStyle
interface in the StyleSheet module [DOM Level
2 Style Sheets and CSS]).
interface HTMLLinkElement : HTMLElement { attribute boolean disabled; attribute DOMString charset; attribute DOMString href; attribute DOMString hreflang; attribute DOMString media; attribute DOMString rel; attribute DOMString rev; attribute DOMString target; attribute DOMString type; };
charset
of type
DOMString
disabled
of type
boolean
href
of type
DOMString
hreflang
of type
DOMString
media
of type
DOMString
rel
of type
DOMString
rev
of type
DOMString
target
of type
DOMString
type
of type
DOMString
The document title. See the TITLE element definition in HTML 4.0.
interface HTMLTitleElement : HTMLElement { attribute DOMString text; };
text
of type
DOMString
This contains generic meta-information about the document. See the META element definition in HTML 4.0.
interface HTMLMetaElement : HTMLElement { attribute DOMString content; attribute DOMString httpEquiv; attribute DOMString name; attribute DOMString scheme; };
content
of type
DOMString
httpEquiv
of type
DOMString
name
of type
DOMString
scheme
of type
DOMString
Document base URI [RFC2396]. See the BASE element definition in HTML 4.0.
interface HTMLBaseElement : HTMLElement { attribute DOMString href; attribute DOMString target; };
href
of type
DOMString
target
of type
DOMString
This element is used for single-line text input. See the ISINDEX element definition in HTML 4.0. This element is deprecated in HTML 4.0.
interface HTMLIsIndexElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString prompt; };
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.prompt
of type
DOMString
Style information. See the
STYLE element definition in HTML 4.0, the CSS module [DOM Level
2 Style Sheets and CSS] and the LinkStyle
interface in the StyleSheets module [DOM Level 2 Style Sheets and
CSS].
interface HTMLStyleElement : HTMLElement { attribute boolean disabled; attribute DOMString media; attribute DOMString type; };
disabled
of type
boolean
media
of type
DOMString
type
of type
DOMString
The HTML document body. This element is always present in the DOM API, even if the tags are not present in the source document. See the BODY element definition in HTML 4.0.
interface HTMLBodyElement : HTMLElement { attribute DOMString aLink; attribute DOMString background; attribute DOMString bgColor; attribute DOMString link; attribute DOMString text; attribute DOMString vLink; };
aLink
of type
DOMString
background
of type
DOMString
bgColor
of type
DOMString
link
of type
DOMString
text
of type
DOMString
vLink
of type
DOMString
The FORM
element encompasses behavior similar to a
collection and an element. It provides direct access to the
contained form controls as well as the attributes of the form
element. See the
FORM element definition in HTML 4.0.
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
of type
DOMString
action
of type
DOMString
elements
of type HTMLCollection
,
readonlyenctype
of type
DOMString
length
of type
long
, readonlymethod
of type
DOMString
name
of type
DOMString
target
of type
DOMString
The select element allows the selection of an option. The contained options can be directly accessed through the select element as a collection. See the SELECT element definition in HTML 4.0.
interface HTMLSelectElement : HTMLElement { readonly attribute DOMString type; attribute long selectedIndex; attribute DOMString value; readonly attribute long length; readonly attribute HTMLFormElement form; readonly attribute HTMLCollection 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
of type
boolean
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.length
of type long
,
readonlySELECT
.multiple
of type
boolean
OPTION
elements may be selected
in this SELECT
. See the
multiple attribute definition in HTML 4.0.name
of type
DOMString
options
of type HTMLCollection
,
readonlyOPTION
elements contained by
this element.selectedIndex
of type
long
size
of type long
tabIndex
of type
long
type
of type DOMString
,
readonlytrue
and the string "select-one" when false
.value
of type
DOMString
add
OPTION
elements for this SELECT
. This
method is the equivalent of the appendChild
method of
the Node
interface if the before
parameter is null
. It is equivalent to the
insertBefore
method on the parent of
before
in all other cases.
element
of type HTMLElement
before
of type HTMLElement
null
for the tail
of the list.
|
NOT_FOUND_ERR: Raised if |
blur
focus
remove
OPTION
elements for this SELECT
. Does
nothing if no element has the given index.
index
of type
long
Group options together in logical subdivisions. See the OPTGROUP element definition in HTML 4.0.
interface HTMLOptGroupElement : HTMLElement { attribute boolean disabled; attribute DOMString label; };
disabled
of type
boolean
label
of type
DOMString
A selectable choice. See the OPTION element definition in HTML 4.0.
interface HTMLOptionElement : HTMLElement { readonly attribute HTMLFormElement form; attribute boolean defaultSelected; readonly attribute DOMString text; readonly attribute long index; attribute boolean disabled; attribute DOMString label; attribute boolean selected; attribute DOMString value; };
defaultSelected
of type
boolean
disabled
of type
boolean
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.index
of type long
,
readonlyOPTION
in its parent
SELECT
, starting from 0.label
of type
DOMString
selected
of type
boolean
text
of type DOMString
,
readonlyvalue
of type
DOMString
Form control.
Note: Depending upon the environment in which the page is being viewed, the value property may be read-only for the file upload input type. For the "password" input type, the actual value returned may be masked to prevent unauthorized use. See the INPUT element definition in [HTML4.0].
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; attribute DOMString size; attribute DOMString src; attribute long tabIndex; // Modified in DOM Level 2: attribute DOMString type; attribute DOMString useMap; attribute DOMString value; void blur(); void focus(); void select(); void click(); };
accept
of type
DOMString
accessKey
of type
DOMString
align
of type
DOMString
alt
of type
DOMString
checked
of type
boolean
type
attribute of the element has the
value "radio" or "checkbox", this represents the current state of
the form control, in an interactive user agent. Changes to this
attribute change the state of the form control, but do not change
the value of the HTML value attribute of the element.defaultChecked
of type
boolean
type
has the value "radio" or "checkbox",
this represents the HTML checked attribute of the element. The
value of this attribute does not change if the state of the
corresponding form control, in an interactive user agent, changes.
See the
checked attribute definition in HTML 4.0.defaultValue
of type
DOMString
type
attribute of the element has the
value "text", "file" or "password", this represents the HTML value
attribute of the element. The value of this attribute does not
change if the contents of the corresponding form control, in an
interactive user agent, changes. See the
value attribute definition in HTML 4.0.disabled
of type
boolean
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.maxLength
of type
long
type
has the value "text" or "password". See the
maxlength attribute definition in HTML 4.0.name
of type
DOMString
readOnly
of type
boolean
type
has the value "text" or "password". See the
readonly attribute definition in HTML 4.0.size
of type
DOMString
src
of type
DOMString
type
attribute has the value "image",
this attribute specifies the location of the image to be used to
decorate the graphical submit button. See the
src attribute definition in HTML 4.0.tabIndex
of type
long
type
of type DOMString
,
modified in DOM Level 2useMap
of type
DOMString
value
of type
DOMString
type
attribute of the element has the
value "text", "file" or "password", this represents the current
contents of the corresponding form control, in an interactive user
agent. Changing this attribute changes the contents of the form
control, but does not change the value of the HTML value attribute
of the element. When the type
attribute of the element
has the value "button", "hidden", "submit", "reset", "image",
"checkbox" or "radio", this represents the HTML value attribute of
the element. See the
value attribute definition in HTML 4.0.blur
click
INPUT
elements whose type
attribute has one of the following
values: "button", "checkbox", "radio", "reset", or "submit".
focus
select
INPUT
elements whose type
attribute has
one of the following values: "text", "file", or "password".
Multi-line text field. See the TEXTAREA element definition in HTML 4.0.
interface HTMLTextAreaElement : HTMLElement { 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
of type
DOMString
cols
of type long
defaultValue
of type
DOMString
disabled
of type
boolean
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.name
of type
DOMString
readOnly
of type
boolean
rows
of type long
tabIndex
of type
long
type
of type
DOMString
, readonlyvalue
of type
DOMString
DOMString
, the implementation may
truncate the data.Push button. See the BUTTON element definition in HTML 4.0.
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
of type
DOMString
disabled
of type
boolean
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.name
of type
DOMString
tabIndex
of type
long
type
of type DOMString
,
readonlyvalue
of type
DOMString
Form field label text. See the LABEL element definition in HTML 4.0.
interface HTMLLabelElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString htmlFor; };
accessKey
of type
DOMString
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.htmlFor
of type
DOMString
id
attribute. See the
for attribute definition in HTML 4.0.Organizes form controls into logical groups. See the FIELDSET element definition in HTML 4.0.
interface HTMLFieldSetElement : HTMLElement { readonly attribute HTMLFormElement form; };
form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.Provides a caption for a FIELDSET
grouping. See the
LEGEND element definition in HTML 4.0.
interface HTMLLegendElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString align; };
accessKey
of type
DOMString
align
of type
DOMString
FIELDSET
. See the
align attribute definition in HTML 4.0. This attribute is
deprecated in HTML 4.0.form
of type HTMLFormElement
,
readonlyFORM
element containing this control.
Returns null
if this control is not within the context
of a form.Unordered list. See the UL element definition in HTML 4.0.
interface HTMLUListElement : HTMLElement { attribute boolean compact; attribute DOMString type; };
compact
of type
boolean
type
of type
DOMString
Ordered list. See the OL element definition in HTML 4.0.
interface HTMLOListElement : HTMLElement { attribute boolean compact; attribute long start; attribute DOMString type; };
compact
of type
boolean
start
of type long
type
of type
DOMString
Definition list. See the DL element definition in HTML 4.0.
interface HTMLDListElement : HTMLElement { attribute boolean compact; };
compact
of type
boolean
Directory list. See the DIR element definition in HTML 4.0. This element is deprecated in HTML 4.0.
interface HTMLDirectoryElement : HTMLElement { attribute boolean compact; };
compact
of type
boolean
Menu list. See the MENU element definition in HTML 4.0. This element is deprecated in HTML 4.0.
interface HTMLMenuElement : HTMLElement { attribute boolean compact; };
compact
of type
boolean
List item. See the LI element definition in HTML 4.0.
interface HTMLLIElement : HTMLElement { attribute DOMString type; attribute long value; };
type
of type
DOMString
value
of type long
OL
. See the
value attribute definition in HTML 4.0. This attribute is
deprecated in HTML 4.0.Generic block container. See the DIV element definition in HTML 4.0.
interface HTMLDivElement : HTMLElement { attribute DOMString align; };
align
of type
DOMString
Paragraphs. See the P element definition in HTML 4.0.
interface HTMLParagraphElement : HTMLElement { attribute DOMString align; };
align
of type
DOMString
For the H1
to H6
elements. See the
H1 element definition in HTML 4.0.
interface HTMLHeadingElement : HTMLElement { attribute DOMString align; };
align
of type
DOMString
For the Q
and BLOCKQUOTE
elements. See
the
Q element definition in HTML 4.0.
interface HTMLQuoteElement : HTMLElement { attribute DOMString cite; };
cite
of type
DOMString
Preformatted text. See the PRE element definition in HTML 4.0.
interface HTMLPreElement : HTMLElement { attribute long width; };
width
of type long
Force a line break. See the BR element definition in HTML 4.0.
interface HTMLBRElement : HTMLElement { attribute DOMString clear; };
clear
of type
DOMString
Base font. See the BASEFONT element definition in HTML 4.0. This element is deprecated in HTML 4.0.
interface HTMLBaseFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; attribute DOMString size; };
color
of type
DOMString
face
of type
DOMString
size
of type
DOMString
Local change to font. See the FONT element definition in HTML 4.0. This element is deprecated in HTML 4.0.
interface HTMLFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; attribute DOMString size; };
color
of type
DOMString
face
of type
DOMString
size
of type
DOMString
Create a horizontal rule. See the HR element definition in HTML 4.0.
interface HTMLHRElement : HTMLElement { attribute DOMString align; attribute boolean noShade; attribute DOMString size; attribute DOMString width; };
align
of type
DOMString
noShade
of type
boolean
size
of type
DOMString
width
of type
DOMString
Notice of modification to part of a document. See the INS and DEL element definitions in HTML 4.0.
interface HTMLModElement : HTMLElement { attribute DOMString cite; attribute DOMString dateTime; };
cite
of type
DOMString
dateTime
of type
DOMString
The anchor element. See the A element definition in HTML 4.0.
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
of type
DOMString
charset
of type
DOMString
coords
of type
DOMString
shape
for the shape of the region.
See the
coords attribute definition in HTML 4.0.href
of type
DOMString
hreflang
of type
DOMString
name
of type
DOMString
rel
of type
DOMString
rev
of type
DOMString
shape
of type
DOMString
coords
. See the
shape attribute definition in HTML 4.0.tabIndex
of type
long
target
of type
DOMString
type
of type
DOMString
Embedded image. See the IMG element definition in HTML 4.0.
interface HTMLImageElement : HTMLElement { attribute DOMString name; attribute DOMString align; attribute DOMString alt; attribute long border; attribute long height; attribute long hspace; attribute boolean isMap; attribute DOMString longDesc; attribute DOMString src; attribute DOMString useMap; attribute long vspace; attribute long width; };
align
of type
DOMString
alt
of type
DOMString
border
of type long
DOMString
in DOM Level 1 HTML [DOM
Level 1].height
of type long
DOMString
in DOM Level 1 HTML [DOM
Level 1].hspace
of type long
DOMString
in DOM Level 1 HTML [DOM
Level 1].isMap
of type
boolean
longDesc
of type
DOMString
name
of type
DOMString
src
of type
DOMString
useMap
of type
DOMString
vspace
of type long
width
of type long
DOMString
in DOM Level 1 HTML [DOM
Level 1].Generic embedded object.
Note: In principle, all properties on the object element are read-write but in some environments some properties may be read-only once the underlying object is instantiated. See the OBJECT element definition in [HTML4.0].
interface HTMLObjectElement : HTMLElement { 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 DOMString hspace; attribute DOMString name; attribute DOMString standby; attribute long tabIndex; attribute DOMString type; attribute DOMString useMap; attribute DOMString vspace; attribute DOMString width; // Introduced in DOM Level 2: readonly attribute Document contentDocument; };
align
of type
DOMString
archive
of type
DOMString
border
of type
DOMString
code
of type
DOMString
code
attribute for
HTMLAppletElement.codeBase
of type
DOMString
classid
, data
, and archive
attributes. See the
codebase attribute definition in HTML 4.0.codeType
of type
DOMString
classid
attribute. See the
codetype attribute definition in HTML 4.0.contentDocument
of type
Document
, readonly, introduced in DOM Level 2null
otherwise.data
of type
DOMString
declare
of type
boolean
height
of type
DOMString
hspace
of type
DOMString
name
of type
DOMString
standby
of type
DOMString
tabIndex
of type
long
type
of type
DOMString
data
attribute. See the
type attribute definition in HTML 4.0.useMap
of type
DOMString
vspace
of type
DOMString
width
of type
DOMString
Parameters fed to the OBJECT
element. See the
PARAM element definition in HTML 4.0.
interface HTMLParamElement : HTMLElement { attribute DOMString name; attribute DOMString type; attribute DOMString value; attribute DOMString valueType; };
name
of type
DOMString
type
of type
DOMString
value
attribute when
valuetype
has the value "ref". See the
type attribute definition in HTML 4.0.value
of type
DOMString
valueType
of type
DOMString
value
attribute value. See the
valuetype attribute definition in HTML 4.0.An embedded Java applet. See the APPLET element definition in HTML 4.0. This element is deprecated in HTML 4.0.
interface HTMLAppletElement : HTMLElement { attribute DOMString align; attribute DOMString alt; attribute DOMString archive; attribute DOMString code; attribute DOMString codeBase; attribute DOMString height; attribute DOMString hspace; attribute DOMString name; attribute DOMString object; attribute DOMString vspace; attribute DOMString width; };
align
of type
DOMString
alt
of type
DOMString
archive
of type
DOMString
code
of type
DOMString
codeBase
of type
DOMString
height
of type
DOMString
hspace
of type
DOMString
name
of type
DOMString
object
of type
DOMString
vspace
of type
DOMString
width
of type
DOMString
Client-side image map. See the MAP element definition in HTML 4.0.
interface HTMLMapElement : HTMLElement { readonly attribute HTMLCollection areas; attribute DOMString name; };
areas
of type HTMLCollection
,
readonlyname
of type
DOMString
usemap
). See the
name attribute definition in HTML 4.0.Client-side image map area definition. See the AREA element definition in HTML 4.0.
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
of type
DOMString
alt
of type
DOMString
coords
of type
DOMString
shape
for the shape of the region.
See the
coords attribute definition in HTML 4.0.href
of type
DOMString
noHref
of type
boolean
shape
of type
DOMString
coords
. See the
shape attribute definition in HTML 4.0.tabIndex
of type
long
target
of type
DOMString
Script statements. See the SCRIPT element definition in HTML 4.0.
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
of type
DOMString
defer
of type
boolean
event
of type
DOMString
htmlFor
of type
DOMString
src
of type
DOMString
text
of type
DOMString
type
of type
DOMString
The create* and delete* methods on the table allow authors to
construct and modify tables. HTML 4.0 specifies that only one of
each of the CAPTION
, THEAD
, and
TFOOT
elements may exist in a table. Therefore, if one
exists, and the createTHead() or createTFoot() method is called,
the method returns the existing THead or TFoot element. See the
TABLE element definition in HTML 4.0.
interface HTMLTableElement : HTMLElement { attribute HTMLTableCaptionElement caption; attribute HTMLTableSectionElement tHead; attribute HTMLTableSectionElement tFoot; 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(); HTMLElement insertRow(in long index) raises(DOMException); void deleteRow(in long index) raises(DOMException); };
align
of type
DOMString
bgColor
of type
DOMString
border
of type
DOMString
caption
of type HTMLTableCaptionElement
CAPTION
, or void if none
exists.cellPadding
of type
DOMString
cellSpacing
of type
DOMString
frame
of type
DOMString
rows
of type HTMLCollection
,
readonlyTHEAD
, TFOOT
, all
TBODY
elements.rules
of type
DOMString
summary
of type
DOMString
tBodies
of type HTMLCollection
,
readonlytFoot
of type HTMLTableSectionElement
TFOOT
, or null
if
none exists.tHead
of type HTMLTableSectionElement
THEAD
, or null
if
none exists.width
of type
DOMString
createCaption
A |
createTFoot
A footer element ( |
createTHead
A new table header element ( |
deleteCaption
deleteRow
index
of type
long
|
INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative. |
deleteTFoot
deleteTHead
insertRow
index
th row in the table. If
index
is equal to the number of rows, the new row is
appended. In addition, when the table is empty the row is inserted
into a TBODY
which is created and inserted into the
table.
Note: A table row cannot be empty according to [HTML4.0].
index
of type
long
The newly created row. |
|
INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows or if the index is negative. |
Table caption See the CAPTION element definition in HTML 4.0.
interface HTMLTableCaptionElement : HTMLElement { attribute DOMString align; };
align
of type
DOMString
Regroups the COL
and COLGROUP
elements. See the
COL element definition in HTML 4.0.
interface HTMLTableColElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute long span; attribute DOMString vAlign; attribute DOMString width; };
align
of type
DOMString
ch
of type DOMString
chOff
of type
DOMString
span
of type long
vAlign
of type
DOMString
width
of type
DOMString
The THEAD
, TFOOT
, and
TBODY
elements.
interface HTMLTableSectionElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; readonly attribute HTMLCollection rows; HTMLElement insertRow(in long index) raises(DOMException); void deleteRow(in long index) raises(DOMException); };
align
of type
DOMString
align
attribute for HTMLTheadElement for
details.ch
of type
DOMString
chOff
of type
DOMString
rows
of type HTMLCollection
,
readonlyvAlign
of type
DOMString
valign
attribute for HTMLTheadElement for
details.deleteRow
index
of type
long
|
INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative. |
insertRow
index
th row in
this section. If index
is equal to the number of rows
in this section, the new row is appended.
index
of type
long
The newly created row. |
|
INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows of if the index is negative. |
A row in a table. See the TR element definition in HTML 4.0.
interface HTMLTableRowElement : HTMLElement { readonly attribute long rowIndex; readonly attribute long sectionRowIndex; readonly attribute HTMLCollection cells; attribute DOMString align; attribute DOMString bgColor; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; HTMLElement insertCell(in long index) raises(DOMException); void deleteCell(in long index) raises(DOMException); };
align
of type
DOMString
bgColor
of type
DOMString
cells
of type HTMLCollection
,
readonlych
of type
DOMString
chOff
of type
DOMString
rowIndex
of type long
,
readonlyrowIndex
does not take into account sections
(THEAD
, TFOOT
, or TBODY
)
within the table.sectionRowIndex
of type
long
, readonlyTHEAD
, TFOOT
, or TBODY
),
starting from 0.vAlign
of type
DOMString
deleteCell
index
of type
long
|
INDEX_SIZE_ERR: Raised if the specified |
insertCell
TD
cell into this
row. If index
is equal to the number of cells, the new
cell is appended.
index
of type
long
The newly created cell. |
|
INDEX_SIZE_ERR: Raised if the specified |
The object used to represent the TH
and
TD
elements. See the
TD element definition in HTML 4.0.
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
of type
DOMString
align
of type
DOMString
axis
of type
DOMString
bgColor
of type
DOMString
cellIndex
of type long
,
readonlych
of type
DOMString
chOff
of type
DOMString
colSpan
of type
long
headers
of type
DOMString
id
attribute values for header cells. See
the
headers attribute definition in HTML 4.0.height
of type
DOMString
noWrap
of type
boolean
rowSpan
of type
long
scope
of type
DOMString
vAlign
of type
DOMString
width
of type
DOMString
Create a grid of frames. See the FRAMESET element definition in HTML 4.0.
interface HTMLFrameSetElement : HTMLElement { attribute DOMString cols; attribute DOMString rows; };
cols
of type
DOMString
rows
of type
DOMString
Create a frame. See the FRAME element definition in HTML 4.0.
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; // Introduced in DOM Level 2: readonly attribute Document contentDocument; };
contentDocument
of type
Document
, readonly, introduced in DOM Level 2null
otherwise.frameBorder
of type
DOMString
longDesc
of type
DOMString
marginHeight
of type
DOMString
marginWidth
of type
DOMString
name
of type
DOMString
target
attribute).
See the
name attribute definition in HTML 4.0.noResize
of type
boolean
scrolling
of type
DOMString
src
of type
DOMString
Inline subwindows. See the IFRAME element definition in HTML 4.0.
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; // Introduced in DOM Level 2: readonly attribute Document contentDocument; };
align
of type
DOMString
contentDocument
of type
Document
, readonly, introduced in DOM Level 2null
otherwise.frameBorder
of type
DOMString
height
of type
DOMString
longDesc
of type
DOMString
marginHeight
of type
DOMString
marginWidth
of type
DOMString
name
of type
DOMString
target
attribute).
See the
name attribute definition in HTML 4.0.scrolling
of type
DOMString
src
of type
DOMString
width
of type
DOMString
Note: The DOM Level 2 HTML module is not backward compatible with the DOM Level 1 HTML module.
Document
supports the feature "XML
"
as well as "HTML
".HTMLDocument
getElementById
is now inherited from
the Document
interface [DOM Level 2 Core] where it was
moved.HTMLFrameElement
contentDocument
was added.HTMLIFrameElement
contentDocument
was added.HTMLInputElement
type
is no longer read only.HTMLObjectElement
contentDocument
was added.form
was removed.HTMLOptionElement
defaultSelected
attribute does not
reset the state of the form control.HTMLTextAreaElement
defaultValue
attribute does not reset
the contents of the form control.HTMLImageElement
lowSrc
attribute was removed.border
,
height
, hspace
, width
and
vspace
were changed from DOMString
to
long
.HTMLDOMImplementation
HTMLDOMImplementation
interface was added to the HTML module.This appendix contains the complete OMG IDL [OMGIDL] for the Level 2 Document Object Model HTML definitions.
Unfortunately the OMG IDL in this appendix is not conformant due
to problems in the validator that was used to validate Level 1. The
readOnly
attribute on the HTMLInputElement
and
HTMLTextAreaElement
interfaces, as well as the object
attribute on the HTMLAppletElement
interface, are not conformant with OMG IDL 2.2. The
valueType
attribute on the HTMLParamElement
interface is not conformant with OMG IDL 2.3.1, which hadn't been
released when DOM Level 1 [DOM Level 1] was
published.
The IDL files are also available as: http://www.w3.org/TR/2001/WD-DOM-Level-2-HTML-20011210/idl.zip
// File: html.idl #ifndef _HTML_IDL_ #define _HTML_IDL_ #include "dom.idl" #pragma prefix "dom.w3c.org" module html { typedef dom::DOMString DOMString; typedef dom::Node Node; typedef dom::DOMImplementation DOMImplementation; typedef dom::Document Document; typedef dom::NodeList NodeList; typedef dom::Element Element; interface HTMLDocument; interface HTMLElement; interface HTMLFormElement; interface HTMLTableCaptionElement; interface HTMLTableSectionElement; interface HTMLCollection { readonly attribute unsigned long length; Node item(in unsigned long index); Node namedItem(in DOMString name); }; // Introduced in DOM Level 2: interface HTMLDOMImplementation : DOMImplementation { HTMLDocument createHTMLDocument(in DOMString title); }; 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; // raises(dom::DOMException) on setting void open(); void close(); void write(in DOMString text); void writeln(in DOMString text); NodeList getElementsByName(in DOMString elementName); }; interface HTMLElement : Element { attribute DOMString id; attribute DOMString title; attribute DOMString lang; attribute DOMString dir; attribute DOMString className; }; interface HTMLHtmlElement : HTMLElement { attribute DOMString version; }; interface HTMLHeadElement : HTMLElement { attribute DOMString profile; }; interface HTMLLinkElement : HTMLElement { attribute boolean disabled; attribute DOMString charset; attribute DOMString href; attribute DOMString hreflang; attribute DOMString media; attribute DOMString rel; attribute DOMString rev; attribute DOMString target; attribute DOMString type; }; interface HTMLTitleElement : HTMLElement { attribute DOMString text; }; interface HTMLMetaElement : HTMLElement { attribute DOMString content; attribute DOMString httpEquiv; attribute DOMString name; attribute DOMString scheme; }; interface HTMLBaseElement : HTMLElement { attribute DOMString href; attribute DOMString target; }; interface HTMLIsIndexElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString prompt; }; interface HTMLStyleElement : HTMLElement { attribute boolean disabled; attribute DOMString media; attribute DOMString type; }; interface HTMLBodyElement : HTMLElement { attribute DOMString aLink; attribute DOMString background; attribute DOMString bgColor; attribute DOMString link; attribute DOMString text; attribute DOMString vLink; }; 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(); }; interface HTMLSelectElement : HTMLElement { readonly attribute DOMString type; attribute long selectedIndex; attribute DOMString value; readonly attribute long length; readonly attribute HTMLFormElement form; readonly attribute HTMLCollection 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(dom::DOMException); void remove(in long index); void blur(); void focus(); }; interface HTMLOptGroupElement : HTMLElement { attribute boolean disabled; attribute DOMString label; }; interface HTMLOptionElement : HTMLElement { readonly attribute HTMLFormElement form; attribute boolean defaultSelected; readonly attribute DOMString text; readonly attribute long index; attribute boolean disabled; attribute DOMString label; attribute boolean selected; attribute DOMString value; }; 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; attribute DOMString size; attribute DOMString src; attribute long tabIndex; // Modified in DOM Level 2: attribute DOMString type; attribute DOMString useMap; attribute DOMString value; void blur(); void focus(); void select(); void click(); }; interface HTMLTextAreaElement : HTMLElement { 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(); }; 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; }; interface HTMLLabelElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString htmlFor; }; interface HTMLFieldSetElement : HTMLElement { readonly attribute HTMLFormElement form; }; interface HTMLLegendElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString align; }; interface HTMLUListElement : HTMLElement { attribute boolean compact; attribute DOMString type; }; interface HTMLOListElement : HTMLElement { attribute boolean compact; attribute long start; attribute DOMString type; }; interface HTMLDListElement : HTMLElement { attribute boolean compact; }; interface HTMLDirectoryElement : HTMLElement { attribute boolean compact; }; interface HTMLMenuElement : HTMLElement { attribute boolean compact; }; interface HTMLLIElement : HTMLElement { attribute DOMString type; attribute long value; }; interface HTMLDivElement : HTMLElement { attribute DOMString align; }; interface HTMLParagraphElement : HTMLElement { attribute DOMString align; }; interface HTMLHeadingElement : HTMLElement { attribute DOMString align; }; interface HTMLQuoteElement : HTMLElement { attribute DOMString cite; }; interface HTMLPreElement : HTMLElement { attribute long width; }; interface HTMLBRElement : HTMLElement { attribute DOMString clear; }; interface HTMLBaseFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; attribute DOMString size; }; interface HTMLFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; attribute DOMString size; }; interface HTMLHRElement : HTMLElement { attribute DOMString align; attribute boolean noShade; attribute DOMString size; attribute DOMString width; }; interface HTMLModElement : HTMLElement { attribute DOMString cite; attribute DOMString dateTime; }; 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(); }; interface HTMLImageElement : HTMLElement { attribute DOMString name; attribute DOMString align; attribute DOMString alt; attribute long border; attribute long height; attribute long hspace; attribute boolean isMap; attribute DOMString longDesc; attribute DOMString src; attribute DOMString useMap; attribute long vspace; attribute long width; }; interface HTMLObjectElement : HTMLElement { 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 DOMString hspace; attribute DOMString name; attribute DOMString standby; attribute long tabIndex; attribute DOMString type; attribute DOMString useMap; attribute DOMString vspace; attribute DOMString width; // Introduced in DOM Level 2: readonly attribute Document contentDocument; }; interface HTMLParamElement : HTMLElement { attribute DOMString name; attribute DOMString type; attribute DOMString value; attribute DOMString valueType; }; interface HTMLAppletElement : HTMLElement { attribute DOMString align; attribute DOMString alt; attribute DOMString archive; attribute DOMString code; attribute DOMString codeBase; attribute DOMString height; attribute DOMString hspace; attribute DOMString name; attribute DOMString object; attribute DOMString vspace; attribute DOMString width; }; interface HTMLMapElement : HTMLElement { readonly attribute HTMLCollection areas; attribute DOMString name; }; 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; }; interface HTMLScriptElement : HTMLElement { attribute DOMString text; attribute DOMString htmlFor; attribute DOMString event; attribute DOMString charset; attribute boolean defer; attribute DOMString src; attribute DOMString type; }; interface HTMLTableElement : HTMLElement { attribute HTMLTableCaptionElement caption; attribute HTMLTableSectionElement tHead; attribute HTMLTableSectionElement tFoot; 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(); HTMLElement insertRow(in long index) raises(dom::DOMException); void deleteRow(in long index) raises(dom::DOMException); }; interface HTMLTableCaptionElement : HTMLElement { attribute DOMString align; }; interface HTMLTableColElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute long span; attribute DOMString vAlign; attribute DOMString width; }; interface HTMLTableSectionElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; readonly attribute HTMLCollection rows; HTMLElement insertRow(in long index) raises(dom::DOMException); void deleteRow(in long index) raises(dom::DOMException); }; interface HTMLTableRowElement : HTMLElement { readonly attribute long rowIndex; readonly attribute long sectionRowIndex; readonly attribute HTMLCollection cells; attribute DOMString align; attribute DOMString bgColor; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; HTMLElement insertCell(in long index) raises(dom::DOMException); void deleteCell(in long index) raises(dom::DOMException); }; 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; }; interface HTMLFrameSetElement : HTMLElement { attribute DOMString cols; attribute DOMString rows; }; 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; // Introduced in DOM Level 2: readonly attribute Document contentDocument; }; 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; // Introduced in DOM Level 2: readonly attribute Document contentDocument; }; }; #endif // _HTML_IDL_
This appendix contains the complete Java Language [Java] binding for the Level 2 Document Object Model HTML.
The Java files are also available as http://www.w3.org/TR/2001/WD-DOM-Level-2-HTML-20011210/java-binding.zip
package org.w3c.dom.html; import org.w3c.dom.DOMImplementation; public interface HTMLDOMImplementation extends DOMImplementation { public HTMLDocument createHTMLDocument(String title); }
package org.w3c.dom.html; import org.w3c.dom.Node; public interface HTMLCollection { public int getLength(); public Node item(int index); public Node namedItem(String name); }
package org.w3c.dom.html; import org.w3c.dom.Document; import org.w3c.dom.NodeList; import org.w3c.dom.DOMException; public interface HTMLDocument extends Document { public String getTitle(); public void setTitle(String title); public String getReferrer(); public String getDomain(); public String getURL(); public HTMLElement getBody(); public void setBody(HTMLElement body); public HTMLCollection getImages(); public HTMLCollection getApplets(); public HTMLCollection getLinks(); public HTMLCollection getForms(); public HTMLCollection getAnchors(); public String getCookie(); public void setCookie(String cookie) throws DOMException; public void open(); public void close(); public void write(String text); public void writeln(String text); public NodeList getElementsByName(String elementName); }
package org.w3c.dom.html; import org.w3c.dom.Element; public interface HTMLElement extends Element { public String getId(); public void setId(String id); public String getTitle(); public void setTitle(String title); public String getLang(); public void setLang(String lang); public String getDir(); public void setDir(String dir); public String getClassName(); public void setClassName(String className); }
package org.w3c.dom.html; public interface HTMLHtmlElement extends HTMLElement { public String getVersion(); public void setVersion(String version); }
package org.w3c.dom.html; public interface HTMLHeadElement extends HTMLElement { public String getProfile(); public void setProfile(String profile); }
package org.w3c.dom.html; public interface HTMLLinkElement extends HTMLElement { public boolean getDisabled(); public void setDisabled(boolean disabled); public String getCharset(); public void setCharset(String charset); public String getHref(); public void setHref(String href); public String getHreflang(); public void setHreflang(String hreflang); public String getMedia(); public void setMedia(String media); public String getRel(); public void setRel(String rel); public String getRev(); public void setRev(String rev); public String getTarget(); public void setTarget(String target); public String getType(); public void setType(String type); }
package org.w3c.dom.html; public interface HTMLTitleElement extends HTMLElement { public String getText(); public void setText(String text); }
package org.w3c.dom.html; public interface HTMLMetaElement extends HTMLElement { public String getContent(); public void setContent(String content); public String getHttpEquiv(); public void setHttpEquiv(String httpEquiv); public String getName(); public void setName(String name); public String getScheme(); public void setScheme(String scheme); }
package org.w3c.dom.html; public interface HTMLBaseElement extends HTMLElement { public String getHref(); public void setHref(String href); public String getTarget(); public void setTarget(String target); }
package org.w3c.dom.html; public interface HTMLIsIndexElement extends HTMLElement { public HTMLFormElement getForm(); public String getPrompt(); public void setPrompt(String prompt); }
package org.w3c.dom.html; public interface HTMLStyleElement extends HTMLElement { public boolean getDisabled(); public void setDisabled(boolean disabled); public String getMedia(); public void setMedia(String media); public String getType(); public void setType(String type); }
package org.w3c.dom.html; public interface HTMLBodyElement extends HTMLElement { public String getALink(); public void setALink(String aLink); public String getBackground(); public void setBackground(String background); public String getBgColor(); public void setBgColor(String bgColor); public String getLink(); public void setLink(String link); public String getText(); public void setText(String text); public String getVLink(); public void setVLink(String vLink); }
package org.w3c.dom.html; public interface HTMLFormElement extends HTMLElement { public HTMLCollection getElements(); public int getLength(); public String getName(); public void setName(String name); public String getAcceptCharset(); public void setAcceptCharset(String acceptCharset); public String getAction(); public void setAction(String action); public String getEnctype(); public void setEnctype(String enctype); public String getMethod(); public void setMethod(String method); public String getTarget(); public void setTarget(String target); public void submit(); public void reset(); }
package org.w3c.dom.html; import org.w3c.dom.DOMException; public interface HTMLSelectElement extends HTMLElement { public String getType(); public int getSelectedIndex(); public void setSelectedIndex(int selectedIndex); public String getValue(); public void setValue(String value); public int getLength(); public HTMLFormElement getForm(); public HTMLCollection getOptions(); public boolean getDisabled(); public void setDisabled(boolean disabled); public boolean getMultiple(); public void setMultiple(boolean multiple); public String getName(); public void setName(String name); public int getSize(); public void setSize(int size); public int getTabIndex(); public void setTabIndex(int tabIndex); public void add(HTMLElement element, HTMLElement before) throws DOMException; public void remove(int index); public void blur(); public void focus(); }
package org.w3c.dom.html; public interface HTMLOptGroupElement extends HTMLElement { public boolean getDisabled(); public void setDisabled(boolean disabled); public String getLabel(); public void setLabel(String label); }
package org.w3c.dom.html; public interface HTMLOptionElement extends HTMLElement { public HTMLFormElement getForm(); public boolean getDefaultSelected(); public void setDefaultSelected(boolean defaultSelected); public String getText(); public int getIndex(); public boolean getDisabled(); public void setDisabled(boolean disabled); public String getLabel(); public void setLabel(String label); public boolean getSelected(); public void setSelected(boolean selected); public String getValue(); public void setValue(String value); }
package org.w3c.dom.html; public interface HTMLInputElement extends HTMLElement { public String getDefaultValue(); public void setDefaultValue(String defaultValue); public boolean getDefaultChecked(); public void setDefaultChecked(boolean defaultChecked); public HTMLFormElement getForm(); public String getAccept(); public void setAccept(String accept); public String getAccessKey(); public void setAccessKey(String accessKey); public String getAlign(); public void setAlign(String align); public String getAlt(); public void setAlt(String alt); public boolean getChecked(); public void setChecked(boolean checked); public boolean getDisabled(); public void setDisabled(boolean disabled); public int getMaxLength(); public void setMaxLength(int maxLength); public String getName(); public void setName(String name); public boolean getReadOnly(); public void setReadOnly(boolean readOnly); public String getSize(); public void setSize(String size); public String getSrc(); public void setSrc(String src); public int getTabIndex(); public void setTabIndex(int tabIndex); public String getType(); public void setType(String type); public String getUseMap(); public void setUseMap(String useMap); public String getValue(); public void setValue(String value); public void blur(); public void focus(); public void select(); public void click(); }
package org.w3c.dom.html; public interface HTMLTextAreaElement extends HTMLElement { public String getDefaultValue(); public void setDefaultValue(String defaultValue); public HTMLFormElement getForm(); public String getAccessKey(); public void setAccessKey(String accessKey); public int getCols(); public void setCols(int cols); public boolean getDisabled(); public void setDisabled(boolean disabled); public String getName(); public void setName(String name); public boolean getReadOnly(); public void setReadOnly(boolean readOnly); public int getRows(); public void setRows(int rows); public int getTabIndex(); public void setTabIndex(int tabIndex); public String getType(); public String getValue(); public void setValue(String value); public void blur(); public void focus(); public void select(); }
package org.w3c.dom.html; public interface HTMLButtonElement extends HTMLElement { public HTMLFormElement getForm(); public String getAccessKey(); public void setAccessKey(String accessKey); public boolean getDisabled(); public void setDisabled(boolean disabled); public String getName(); public void setName(String name); public int getTabIndex(); public void setTabIndex(int tabIndex); public String getType(); public String getValue(); public void setValue(String value); }
package org.w3c.dom.html; public interface HTMLLabelElement extends HTMLElement { public HTMLFormElement getForm(); public String getAccessKey(); public void setAccessKey(String accessKey); public String getHtmlFor(); public void setHtmlFor(String htmlFor); }
package org.w3c.dom.html; public interface HTMLFieldSetElement extends HTMLElement { public HTMLFormElement getForm(); }
package org.w3c.dom.html; public interface HTMLLegendElement extends HTMLElement { public HTMLFormElement getForm(); public String getAccessKey(); public void setAccessKey(String accessKey); public String getAlign(); public void setAlign(String align); }
package org.w3c.dom.html; public interface HTMLUListElement extends HTMLElement { public boolean getCompact(); public void setCompact(boolean compact); public String getType(); public void setType(String type); }
package org.w3c.dom.html; public interface HTMLOListElement extends HTMLElement { public boolean getCompact(); public void setCompact(boolean compact); public int getStart(); public void setStart(int start); public String getType(); public void setType(String type); }
package org.w3c.dom.html; public interface HTMLDListElement extends HTMLElement { public boolean getCompact(); public void setCompact(boolean compact); }
package org.w3c.dom.html; public interface HTMLDirectoryElement extends HTMLElement { public boolean getCompact(); public void setCompact(boolean compact); }
package org.w3c.dom.html; public interface HTMLMenuElement extends HTMLElement { public boolean getCompact(); public void setCompact(boolean compact); }
package org.w3c.dom.html; public interface HTMLLIElement extends HTMLElement { public String getType(); public void setType(String type); public int getValue(); public void setValue(int value); }
package org.w3c.dom.html; public interface HTMLDivElement extends HTMLElement { public String getAlign(); public void setAlign(String align); }
package org.w3c.dom.html; public interface HTMLParagraphElement extends HTMLElement { public String getAlign(); public void setAlign(String align); }
package org.w3c.dom.html; public interface HTMLHeadingElement extends HTMLElement { public String getAlign(); public void setAlign(String align); }
package org.w3c.dom.html; public interface HTMLQuoteElement extends HTMLElement { public String getCite(); public void setCite(String cite); }
package org.w3c.dom.html; public interface HTMLPreElement extends HTMLElement { public int getWidth(); public void setWidth(int width); }
package org.w3c.dom.html; public interface HTMLBRElement extends HTMLElement { public String getClear(); public void setClear(String clear); }
package org.w3c.dom.html; public interface HTMLBaseFontElement extends HTMLElement { public String getColor(); public void setColor(String color); public String getFace(); public void setFace(String face); public String getSize(); public void setSize(String size); }
package org.w3c.dom.html; public interface HTMLFontElement extends HTMLElement { public String getColor(); public void setColor(String color); public String getFace(); public void setFace(String face); public String getSize(); public void setSize(String size); }
package org.w3c.dom.html; public interface HTMLHRElement extends HTMLElement { public String getAlign(); public void setAlign(String align); public boolean getNoShade(); public void setNoShade(boolean noShade); public String getSize(); public void setSize(String size); public String getWidth(); public void setWidth(String width); }
package org.w3c.dom.html; public interface HTMLModElement extends HTMLElement { public String getCite(); public void setCite(String cite); public String getDateTime(); public void setDateTime(String dateTime); }
package org.w3c.dom.html; public interface HTMLAnchorElement extends HTMLElement { public String getAccessKey(); public void setAccessKey(String accessKey); public String getCharset(); public void setCharset(String charset); public String getCoords(); public void setCoords(String coords); public String getHref(); public void setHref(String href); public String getHreflang(); public void setHreflang(String hreflang); public String getName(); public void setName(String name); public String getRel(); public void setRel(String rel); public String getRev(); public void setRev(String rev); public String getShape(); public void setShape(String shape); public int getTabIndex(); public void setTabIndex(int tabIndex); public String getTarget(); public void setTarget(String target); public String getType(); public void setType(String type); public void blur(); public void focus(); }
package org.w3c.dom.html; public interface HTMLImageElement extends HTMLElement { public String getName(); public void setName(String name); public String getAlign(); public void setAlign(String align); public String getAlt(); public void setAlt(String alt); public int getBorder(); public void setBorder(int border); public int getHeight(); public void setHeight(int height); public int getHspace(); public void setHspace(int hspace); public boolean getIsMap(); public void setIsMap(boolean isMap); public String getLongDesc(); public void setLongDesc(String longDesc); public String getSrc(); public void setSrc(String src); public String getUseMap(); public void setUseMap(String useMap); public int getVspace(); public void setVspace(int vspace); public int getWidth(); public void setWidth(int width); }
package org.w3c.dom.html; import org.w3c.dom.Document; public interface HTMLObjectElement extends HTMLElement { public String getCode(); public void setCode(String code); public String getAlign(); public void setAlign(String align); public String getArchive(); public void setArchive(String archive); public String getBorder(); public void setBorder(String border); public String getCodeBase(); public void setCodeBase(String codeBase); public String getCodeType(); public void setCodeType(String codeType); public String getData(); public void setData(String data); public boolean getDeclare(); public void setDeclare(boolean declare); public String getHeight(); public void setHeight(String height); public String getHspace(); public void setHspace(String hspace); public String getName(); public void setName(String name); public String getStandby(); public void setStandby(String standby); public int getTabIndex(); public void setTabIndex(int tabIndex); public String getType(); public void setType(String type); public String getUseMap(); public void setUseMap(String useMap); public String getVspace(); public void setVspace(String vspace); public String getWidth(); public void setWidth(String width); public Document getContentDocument(); }
package org.w3c.dom.html; public interface HTMLParamElement extends HTMLElement { public String getName(); public void setName(String name); public String getType(); public void setType(String type); public String getValue(); public void setValue(String value); public String getValueType(); public void setValueType(String valueType); }
package org.w3c.dom.html; public interface HTMLAppletElement extends HTMLElement { public String getAlign(); public void setAlign(String align); public String getAlt(); public void setAlt(String alt); public String getArchive(); public void setArchive(String archive); public String getCode(); public void setCode(String code); public String getCodeBase(); public void setCodeBase(String codeBase); public String getHeight(); public void setHeight(String height); public String getHspace(); public void setHspace(String hspace); public String getName(); public void setName(String name); public String getObject(); public void setObject(String object); public String getVspace(); public void setVspace(String vspace); public String getWidth(); public void setWidth(String width); }
package org.w3c.dom.html; public interface HTMLMapElement extends HTMLElement { public HTMLCollection getAreas(); public String getName(); public void setName(String name); }
package org.w3c.dom.html; public interface HTMLAreaElement extends HTMLElement { public String getAccessKey(); public void setAccessKey(String accessKey); public String getAlt(); public void setAlt(String alt); public String getCoords(); public void setCoords(String coords); public String getHref(); public void setHref(String href); public boolean getNoHref(); public void setNoHref(boolean noHref); public String getShape(); public void setShape(String shape); public int getTabIndex(); public void setTabIndex(int tabIndex); public String getTarget(); public void setTarget(String target); }
package org.w3c.dom.html; public interface HTMLScriptElement extends HTMLElement { public String getText(); public void setText(String text); public String getHtmlFor(); public void setHtmlFor(String htmlFor); public String getEvent(); public void setEvent(String event); public String getCharset(); public void setCharset(String charset); public boolean getDefer(); public void setDefer(boolean defer); public String getSrc(); public void setSrc(String src); public String getType(); public void setType(String type); }
package org.w3c.dom.html; import org.w3c.dom.DOMException; public interface HTMLTableElement extends HTMLElement { public HTMLTableCaptionElement getCaption(); public void setCaption(HTMLTableCaptionElement caption); public HTMLTableSectionElement getTHead(); public void setTHead(HTMLTableSectionElement tHead); public HTMLTableSectionElement getTFoot(); public void setTFoot(HTMLTableSectionElement tFoot); public HTMLCollection getRows(); public HTMLCollection getTBodies(); public String getAlign(); public void setAlign(String align); public String getBgColor(); public void setBgColor(String bgColor); public String getBorder(); public void setBorder(String border); public String getCellPadding(); public void setCellPadding(String cellPadding); public String getCellSpacing(); public void setCellSpacing(String cellSpacing); public String getFrame(); public void setFrame(String frame); public String getRules(); public void setRules(String rules); public String getSummary(); public void setSummary(String summary); public String getWidth(); public void setWidth(String width); public HTMLElement createTHead(); public void deleteTHead(); public HTMLElement createTFoot(); public void deleteTFoot(); public HTMLElement createCaption(); public void deleteCaption(); public HTMLElement insertRow(int index) throws DOMException; public void deleteRow(int index) throws DOMException; }
package org.w3c.dom.html; public interface HTMLTableCaptionElement extends HTMLElement { public String getAlign(); public void setAlign(String align); }
package org.w3c.dom.html; public interface HTMLTableColElement extends HTMLElement { public String getAlign(); public void setAlign(String align); public String getCh(); public void setCh(String ch); public String getChOff(); public void setChOff(String chOff); public int getSpan(); public void setSpan(int span); public String getVAlign(); public void setVAlign(String vAlign); public String getWidth(); public void setWidth(String width); }
package org.w3c.dom.html; import org.w3c.dom.DOMException; public interface HTMLTableSectionElement extends HTMLElement { public String getAlign(); public void setAlign(String align); public String getCh(); public void setCh(String ch); public String getChOff(); public void setChOff(String chOff); public String getVAlign(); public void setVAlign(String vAlign); public HTMLCollection getRows(); public HTMLElement insertRow(int index) throws DOMException; public void deleteRow(int index) throws DOMException; }
package org.w3c.dom.html; import org.w3c.dom.DOMException; public interface HTMLTableRowElement extends HTMLElement { public int getRowIndex(); public int getSectionRowIndex(); public HTMLCollection getCells(); public String getAlign(); public void setAlign(String align); public String getBgColor(); public void setBgColor(String bgColor); public String getCh(); public void setCh(String ch); public String getChOff(); public void setChOff(String chOff); public String getVAlign(); public void setVAlign(String vAlign); public HTMLElement insertCell(int index) throws DOMException; public void deleteCell(int index) throws DOMException; }
package org.w3c.dom.html; public interface HTMLTableCellElement extends HTMLElement { public int getCellIndex(); public String getAbbr(); public void setAbbr(String abbr); public String getAlign(); public void setAlign(String align); public String getAxis(); public void setAxis(String axis); public String getBgColor(); public void setBgColor(String bgColor); public String getCh(); public void setCh(String ch); public String getChOff(); public void setChOff(String chOff); public int getColSpan(); public void setColSpan(int colSpan); public String getHeaders(); public void setHeaders(String headers); public String getHeight(); public void setHeight(String height); public boolean getNoWrap(); public void setNoWrap(boolean noWrap); public int getRowSpan(); public void setRowSpan(int rowSpan); public String getScope(); public void setScope(String scope); public String getVAlign(); public void setVAlign(String vAlign); public String getWidth(); public void setWidth(String width); }
package org.w3c.dom.html; public interface HTMLFrameSetElement extends HTMLElement { public String getCols(); public void setCols(String cols); public String getRows(); public void setRows(String rows); }
package org.w3c.dom.html; import org.w3c.dom.Document; public interface HTMLFrameElement extends HTMLElement { public String getFrameBorder(); public void setFrameBorder(String frameBorder); public String getLongDesc(); public void setLongDesc(String longDesc); public String getMarginHeight(); public void setMarginHeight(String marginHeight); public String getMarginWidth(); public void setMarginWidth(String marginWidth); public String getName(); public void setName(String name); public boolean getNoResize(); public void setNoResize(boolean noResize); public String getScrolling(); public void setScrolling(String scrolling); public String getSrc(); public void setSrc(String src); public Document getContentDocument(); }
package org.w3c.dom.html; import org.w3c.dom.Document; public interface HTMLIFrameElement extends HTMLElement { public String getAlign(); public void setAlign(String align); public String getFrameBorder(); public void setFrameBorder(String frameBorder); public String getHeight(); public void setHeight(String height); public String getLongDesc(); public void setLongDesc(String longDesc); public String getMarginHeight(); public void setMarginHeight(String marginHeight); public String getMarginWidth(); public void setMarginWidth(String marginWidth); public String getName(); public void setName(String name); public String getScrolling(); public void setScrolling(String scrolling); public String getSrc(); public void setSrc(String src); public String getWidth(); public void setWidth(String width); public Document getContentDocument(); }
This appendix contains the complete ECMAScript [ECMAScript] binding for the Level 2 Document Object Model HTML definitions.
Note: Exceptions handling is only supported by ECMAScript implementation conformant with the Standard ECMA-262 3rd. Edition ([ECMAScript]).
HTMLAnchorElement objects in String
expressions are
evaluated as HTMLAnchorElement.href
.
For example:
alert(" The absolute URI is " + myAnchorElement);
is equivalent to
alert(" The absolute URI is " + myAnchorElement.href);
Many people contributed to this specification, including members of the DOM Working Group and the DOM Interest Group. We especially thank the following:
Lauren Wood (SoftQuad Software Inc., chair), Andrew Watson (Object Management Group), Andy Heninger (IBM), Arnaud Le Hors (W3C and IBM), Ben Chang (Oracle), Bill Smith (Sun), Bill Shea (Merrill Lynch), Bob Sutor (IBM), Chris Lovett (Microsoft), Chris Wilson (Microsoft), David Brownell (Sun), David Singer (IBM), Don Park (invited), Eric Vasilik (Microsoft), Gavin Nicol (INSO), Glenn Adams (ATSC), Ian Jacobs (W3C), James Clark (invited), James Davidson (Sun), Jared Sorensen (Novell), Joe Kesselman (IBM), Joe Lapp (webMethods), Joe Marini (Macromedia), Johnny Stenback (Netscape), Jonathan Marsh (Microsoft), Jonathan Robie (Texcel Research and Software AG), Kim Adamson-Sharpe (SoftQuad Software Inc.), Laurence Cable (Sun), Mark Davis (IBM), Mark Scardina (Oracle), Martin Dürst (W3C), Mick Goulish (Software AG), Mike Champion (Arbortext and Software AG), Miles Sabin (Cromwell Media), Patti Lutsky (Arbortext), Paul Grosso (Arbortext), Peter Sharpe (SoftQuad Software Inc.), Phil Karlton (Netscape), Philippe Le Hégaret (W3C, W3C team contact), Ramesh Lekshmynarayanan (Merrill Lynch), Ray Whitmer (iMall, Excite@Home and Netscape), Rich Rollman (Microsoft), Rick Gessner (Netscape), Scott Isaacs (Microsoft), Sharon Adler (INSO), Steve Byrne (JavaSoft), Tim Bray (invited), Tom Pixley (Netscape), Vidur Apparao (Netscape), Vinod Anupam (Lucent).
Thanks to all those who have helped to improve this specification by sending suggestions and corrections.
This specification was written in XML. The HTML, OMG IDL, Java and ECMA Script bindings were all produced automatically.
Thanks to Joe English, author of cost, which was used as the basis for producing DOM Level 1. Thanks also to Gavin Nicol, who wrote the scripts which run on top of cost. Arnaud Le Hors and Philippe Le Hégaret maintained the scripts.
For DOM Level 2, we used Xerces as the basis DOM implementation and wish to thank the authors. Philippe Le Hégaret and Arnaud Le Hors wrote the Java programs which are the DOM application.
Thanks also to Jan Kärrman, author of html2ps, which we use in creating the PostScript version of the specification.
Several of the following term definitions have been borrowed or modified from similar definitions in other W3C or standards documents. See the links within the definitions for more information.
For the latest version of any W3C specification please consult the list of W3C Technical Reports available at http://www.w3.org/TR.