This section extends the Core API to describe objects and methods specific to HTML documents. 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 and frameset DTDs for HTML 4.0 are assumed. Interoperability between implementations is only guaranteed for elements and attributes that are specified in the HTML 4.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 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".
The interfaces in this specification are designed for HTML 4.0 documents, and not for XHTML 1.0 documents. Use of the HTML DOM with XHTML 1.0 documents may result in incorrect processing; see Appendix C11 in [XHTML10] for more information.
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 HTMLDOMImplementation interface extends the
DOMImplementation interface with a method for creating an
HTML document instance.
// Introduced in DOM Level 2:
interface HTMLDOMImplementation : DOMImplementation {
HTMLDocument createHTMLDocument(in DOMString title);
};
createHTMLDocumentHTMLDocument object with the minimal tree
made of the following elements: HTML, HEAD,
TITLE, and BODY.|
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, readonly
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.
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;
void open();
void close();
void write(in DOMString text);
void writeln(in DOMString text);
NodeList getElementsByName(in DOMString elementName);
};
URL of type DOMString, readonly
anchors 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 HTMLElementBODY contents, returns the BODY
element. In frameset documents, this returns the outermost
FRAMESET element.
cookie of type DOMStringname=value;expires=date.
domain of type DOMString, readonlynull
if the server cannot be identified by a domain name.
forms of type HTMLCollection, readonly
images 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, readonly
title of type DOMStringTITLE
element in the head of the document.
closeopen()
and forces rendering.getElementsByNameopenwriteopen(). The text is parsed into the document's structure
model.
| The string to be parsed into some structure in the document structure model. |
writelnopen(). The text is parsed into the
document's structure model.
| The string to be parsed into some structure in the document structure model. |
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 determined by the type of the attribute as determined by the HTML 4.0 transitional and frameset DTDs. The attributes have the semantics (including case-sensitivity) given in the HTML 4.0 specification.
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 |
The return value of an attribute that has a data type that is a
value list is always capitalized, 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" then it 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)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.
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 Document Object Model 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 Document Object Model StyleSheets module).
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.
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. 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 Document Object Model CSS module and
the LinkStyle interface in the Document Object Model StyleSheets module.
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
input elements 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, readonly
enctype of type DOMString
length of type long, readonly
method 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 booleanOPTION 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
addOPTION 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.
| The element to add. | |||
| The element to insert before, or |
|
NOT_FOUND_ERR: Raised if |
blurfocusremoveOPTION elements
for this SELECT. Does nothing if no element has the given
index.
|
| The index of the item to remove, starting from 0. |
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 booleandefaultSelected, however, resets the
state of the form control. See the selected 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.
index of type long, readonlyOPTION in its parent
SELECT, starting from 0.
label of type DOMString
selected of type boolean
text of type DOMString, readonly
value 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 HTML 4.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;
readonly 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 booleantype 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 booleantype 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. Changes to this
attribute, however, resets the state of the form control. See the checked attribute definition in HTML 4.0.
defaultValue of type DOMStringtype 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. Changing this attribute, however, resets the
contents of the form control. 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 longtype
has the value "Text" or "Password". See the maxlength attribute definition in HTML 4.0.
name of type DOMString
readOnly of type booleantype has the value "Text" or "Password". See the readonly attribute definition in HTML 4.0.
size of type DOMString
src of type DOMStringtype 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, readonly
useMap of type DOMString
value of type DOMStringtype 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.
blurclickINPUT elements whose
type attribute has one of the following
values: "Button", "Checkbox", "Radio", "Reset", or "Submit".focusselectINPUT 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, readonly
value of type DOMStringDOMString, 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, readonly
value 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 DOMStringid 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 DOMStringFIELDSET. 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 longOL. 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 DOMStringshape 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 DOMStringcoords. 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 lowSrc;
attribute DOMString name;
attribute DOMString align;
attribute DOMString alt;
attribute DOMString border;
attribute DOMString height;
attribute DOMString hspace;
attribute boolean isMap;
attribute DOMString longDesc;
attribute DOMString src;
attribute DOMString useMap;
attribute DOMString vspace;
attribute DOMString width;
};
align of type DOMString
alt of type DOMString
border of type DOMString
height of type DOMString
hspace of type DOMString
isMap of type boolean
longDesc of type DOMString
lowSrc of type DOMString
name of type DOMString
src of type DOMString
useMap of type DOMString
vspace of type DOMString
width of type DOMString
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 HTML 4.0.
interface HTMLObjectElement : HTMLElement {
readonly attribute HTMLFormElement form;
attribute DOMString code;
attribute DOMString align;
attribute DOMString archive;
attribute DOMString border;
attribute DOMString codeBase;
attribute DOMString codeType;
attribute DOMString data;
attribute boolean declare;
attribute DOMString height;
attribute 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:
attribute Document contentDocument;
};
align of type DOMString
archive of type DOMString
border of type DOMString
code of type DOMStringcode attribute for
HTMLAppletElement.
codeBase of type DOMStringclassid, data, and
archive attributes. See the codebase attribute definition in HTML 4.0.
codeType of type DOMStringclassid attribute. See the codetype attribute definition in HTML 4.0.
contentDocument of type Document, introduced in DOM Level 2null otherwise.
data of type DOMString
declare 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.
height of type DOMString
hspace of type DOMString
name of type DOMString
standby of type DOMString
tabIndex of type long
type of type DOMStringdata 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 DOMStringvalue attribute when
valuetype has the value "ref". See the type attribute definition in HTML 4.0.
value of type DOMString
valueType of type DOMStringvalue 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, readonly
name of type DOMStringusemap). 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 DOMStringshape 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 DOMStringcoords. 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 HTMLTableCaptionElementCAPTION, 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, readonly
tFoot of type HTMLTableSectionElementTFOOT, or
null if none exists.
tHead of type HTMLTableSectionElementTHEAD, or
null if none exists.
width of type DOMString
createCaption|
A |
createTFoot|
A footer element ( |
createTHead|
A new table header element ( |
deleteCaptiondeleteRow
|
| The index of the row to be deleted. This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage. |
|
INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative. |
deleteTFootdeleteTHeadinsertRowindexth 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 HTML 4.0 Recommendation.
|
| The row number where to insert a new row. This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage. |
|
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 DOMStringalign
attribute for HTMLTheadElement for details.
ch of type DOMString
chOff of type DOMString
rows of type HTMLCollection, readonly
vAlign of type DOMStringvalign
attribute for HTMLTheadElement for details.
deleteRow
|
| The index of the row to be deleted. This index starts from 0 and is relative only to the rows contained inside this section, not all the rows in the table. |
|
INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative. |
insertRowindexth row in this
section. If index is equal to the number of rows in this
section, the new row is appended.
|
| The row number where to insert a new row. This index starts from 0 and is relative only to the rows contained inside this section, not all the rows in the table. |
|
The newly created row. |
|
INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows of if the index is neagative. |
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, readonly
ch 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
|
| The index of the cell to delete, starting from 0. |
|
INDEX_SIZE_ERR: Raised if the specified |
insertCellTD cell into this row. If
index is equal to the number of cells, the new cell is
appended
|
| The place to insert the cell, starting from 0. |
|
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, readonly
ch of type DOMString
chOff of type DOMString
colSpan of type long
headers of type DOMStringid 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:
attribute Document contentDocument;
};
contentDocument of type Document, 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 DOMStringtarget 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:
attribute Document contentDocument;
};
align of type DOMString
contentDocument of type Document, 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 DOMStringtarget attribute). See the name attribute definition in HTML 4.0.
scrolling of type DOMString
src of type DOMString
width of type DOMString