Version 1.0
W3C Recommendation 09 January 2003
- This version:
- http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109
- Latest version:
- http://www.w3.org/TR/DOM-Level-2-HTML
- Previous version:
- http://www.w3.org/TR/2002/PR-DOM-Level-2-HTML-20021108
- Editors:
- Johnny Stenback, Netscape
- Philippe Le Hégaret, W3C
- Arnaud Le Hors, W3C and IBM (until November 2000)
Please refer to the errata for this document, which may include some normative corrections.
This document is also available in these non-normative formats: XML file, plain text, PostScript file, PDF file, single HTML file, and ZIP file.
See also translations of this document.
Copyright ©2003 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply.
Abstract
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.01] 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] and is not backward compatible with DOM Level 1 HTML [DOM Level 1].
Status of this 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 the 09 January 2003 of "DOM Level 2 HTML". This document has been reviewed by W3C Members, software developers, and other W3C groups and interested parties, and has been endorsed by the Director as a W3C Recommendation. It is a stable document and may be used as reference material or cited as a normative reference from another document. W3C's role in making the Recommendation is to draw attention to the specification and to promote its widespread deployment. This document enhances the interoperability of the Web.
Patent disclosures relevant to this specification may be found on the Working Group's public patent disclosure page.
This document has been produced as part of the W3C DOM Activity. The authors of this document are the DOM Working Group participants.
The English version of this specification is the only normative version. Information about translations of this document is available at http://www.w3.org/2000/11/DOM-Level-2-translations.
The list of known errors in this document is available at http://www.w3.org/2000/11/DOM-Level-2-errata
Comments on this document are invited and are to be sent to the public mailing list www-dom@w3.org. An archive is available at http://lists.w3.org/Archives/Public/www-dom/.
An implementation report, based on the DOM Test Suite work, is available at http://www.w3.org/2002/11/DOM-Level-2-HTML-Results.
A list of current W3C Recommendations and other technical documents can be found at http://www.w3.org/TR.
Note:This specification renders the DOM Level 1 HTML Recommendation obsolete given that some changes from DOM Level 1 HTML are incompatible with that specification but represent more accurately the state of deployed software. W3C strongly suggests that developers and authors conform to DOM Level 2 HTML instead.
Table of contents
- Appendix A: Changes
- Appendix B: IDL Definitions
- Appendix C: Java language Binding
- Appendix D: ECMAScript Language Binding
- Appendix E: Acknowledgements
- Glossary
- References
- Index
09 January 2003
Expanded Table of Contents
- 1. Document Object Model HTML
09 January 2003
Copyright Notice
Copyright © 2003 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.
W3C Document Copyright Notice and License
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-2003 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:
- A link or URL to the original W3C document.
- The pre-existing copyright notice of the original author, or if it doesn't exist, a notice of the form: "Copyright © [$date-of-document] 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/" (Hypertext is preferred, but a textual representation is permitted.)
- If it exists, the STATUS of the W3C document.
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.
W3C Software Copyright Notice and License
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-2003 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:
- The full text of this NOTICE in a location viewable to users of the redistributed or derivative work.
- Any pre-existing intellectual property disclaimers. If none exist, then a notice of the following form: "Copyright © [$date-of-software] 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/."
- Notice of any changes or modifications to the W3C files, including the date changes were made. (We recommend you provide URIs to the location from which the code is derived.)
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.
09 January 2003
1. Document Object Model HTML
- Editors:
- Johnny Stenback, Netscape
- Philippe Le Hégaret, W3C
- Arnaud Le Hors, W3C and IBM (until November 2000)
Table of contents
- 1.1. Introduction
- 1.2. HTML Application of Core DOM
- 1.3. XHTML and the HTML DOM
- 1.4. Miscellaneous Object Definitions
- 1.5. Objects related to HTML documents
- 1.6.
HTML Elements
- 1.6.1. Property Attributes
- 1.6.2. Naming Exceptions
- 1.6.3. Exposing Element Type Names (tagName, (nodeName))
- 1.6.4. The HTMLElement interface
- 1.6.5.
Object definitions
- HTMLHtmlElement, HTMLHeadElement, HTMLLinkElement, HTMLTitleElement, HTMLMetaElement, HTMLBaseElement, HTMLIsIndexElement, HTMLStyleElement, HTMLBodyElement, HTMLFormElement, HTMLSelectElement, HTMLOptGroupElement, HTMLOptionElement, HTMLInputElement, HTMLTextAreaElement, HTMLButtonElement, HTMLLabelElement, HTMLFieldSetElement, HTMLLegendElement, HTMLUListElement, HTMLOListElement, HTMLDListElement, HTMLDirectoryElement, HTMLMenuElement, HTMLLIElement, HTMLDivElement, HTMLParagraphElement, HTMLHeadingElement, HTMLQuoteElement, HTMLPreElement, HTMLBRElement, HTMLBaseFontElement, HTMLFontElement, HTMLHRElement, HTMLModElement, HTMLAnchorElement, HTMLImageElement, HTMLObjectElement, HTMLParamElement, HTMLAppletElement, HTMLMapElement, HTMLAreaElement, HTMLScriptElement, HTMLTableElement, HTMLTableCaptionElement, HTMLTableColElement, HTMLTableSectionElement, HTMLTableRowElement, HTMLTableCellElement, HTMLFrameSetElement, HTMLFrameElement, HTMLIFrameElement
1.1. Introduction
This section extends the DOM Level 2 Core API [DOM Level 2 Core] to describe objects and methods specific to HTML documents [HTML 4.01], 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:
- to specialize and add functionality that relates specifically to HTML documents and elements.
- to address issues of backwards compatibility with the DOM Level 0.
- to provide convenience mechanisms, where appropriate, for common and frequent operations on HTML documents.
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.01, or the XHTML 1.0 DTDs are assumed. Interoperability between implementations is only guaranteed for elements and attributes that are specified in the HTML 4.01 and XHTML 1.0 DTDs.
More specifically, this document includes the following specializations for HTML:
- An
HTMLDocumentinterface, derived from the coreDocumentinterface.HTMLDocumentspecifies the operations and queries that can be made on a HTML document. - An
HTMLElementinterface, derived from the coreElementinterface.HTMLElementspecifies the operations and queries that can be made on any HTML element. Methods onHTMLElementinclude those that allow for the retrieval and modification of attributes that apply to all HTML elements. - Specializations for all HTML elements that have attributes that
extend beyond those specified in the
HTMLElementinterface. 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". 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.01] documents, as well as for [XHTML 1.0] documents.
Note: This specification does not intend to define
exactly how a user agent will respond to a change to any attribute
on an element that directly or indirectly references external data,
such elements are HTMLAppletElement, HTMLFrameElement, HTMLFrameSetElement,
HTMLIFrameElement,
HTMLImageElement,
HTMLLinkElement,
HTMLObjectElement,
HTMLParamElement,
and HTMLScriptElement.
1.2. HTML Application of Core DOM
1.2.1. Naming Conventions
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.
1.2.1.1. Properties and Methods
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.
1.2.1.2. Non-HTML 4.0 interfaces and attributes
While most of the interfaces defined below can be mapped directly to elements defined in the HTML 4.01 Recommendation, some of them cannot. Similarly, not all attributes listed below have counterparts in the HTML 4.01 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.
1.3. XHTML and the HTML DOM
The DOM HTML Level 1 API [DOM Level 1] were originally intended to be used only for HTML 4.01 documents [HTML 4.01]. The APIs were defined well before XHTML 1.0 [XHTML 1.0] became a specification, or before it was worked on by the HTML Working Group.
From the DOM point of view, The biggest difference between HTML 4.01 (and earlier) and XHTML 1.0 is that XHTML is case sensitive, whereas HTML 4.01 is case insensitive. The HTML case insensitivity is also reflected in the DOM HTML API. For instance, element and attribute names are exposed as all uppercase (for consistency) when used on an HTML document, regardless of the character case used in the markup. Since XHTML is based on XML, in XHTML everything is case sensitive, and element and attribute names must be lowercase in the markup.
Developers need to take two things into account when writing
code that works on both HTML and XHTML documents. 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. Second, 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 lowercase.
Note: The interfaces provided in this document are only for [HTML 4.01] and [XHTML 1.0] documents and are not guaranteed to work with any future version of XHTML.
1.4. Miscellaneous Object Definitions
- Interface HTMLCollection
-
An
HTMLCollectionis a list of nodes. An individual node may be accessed by either ordinal index or the node'snameoridattributes.Note: Collections in the HTML DOM are assumed to be live meaning that they are automatically updated when the underlying document is changed.
IDL Definition-
interface HTMLCollection { readonly attribute unsigned long length; Node item(in unsigned long index); Node namedItem(in DOMString name); };
- Attributes
-
lengthof typeunsigned long, readonly- This attribute specifies the length or size of the
list.
- Methods
-
item-
This method retrieves a node specified by ordinal index. Nodes are numbered in tree order (depth-first traversal order).
Parameters
indexof typeunsigned long- The index of the node to be fetched. The index origin is
0.
Return Value
NodeThe
Nodeat the corresponding position upon success. A value ofnullis returned if the index is out of range.No Exceptions
namedItem-
This method retrieves a
Nodeusing a name. With [HTML 4.01] documents, it first searches for aNodewith a matchingidattribute. If it doesn't find one, it then searches for aNodewith a matchingnameattribute, but only on those elements that are allowed a name attribute. With [XHTML 1.0] documents, this method only searches forNodeswith a matchingidattribute. This method is case insensitive in HTML documents and case sensitive in XHTML documents.Parameters
nameof typeDOMString- The name of the
Nodeto be fetched.
Return Value
NodeThe
Nodewith anameoridattribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returnsnull.No Exceptions
- Interface HTMLOptionsCollection (introduced in DOM Level 2)
-
An
HTMLOptionsCollectionis a list of nodes representing HTML option element. An individual node may be accessed by either ordinal index or the node'snameoridattributes.Note: Collections in the HTML DOM are assumed to be live meaning that they are automatically updated when the underlying document is changed.
IDL Definition-
// Introduced in DOM Level 2: interface HTMLOptionsCollection { attribute unsigned long length; // raises(DOMException) on setting Node item(in unsigned long index); Node namedItem(in DOMString name); };
- Attributes
-
lengthof typeunsigned long- This attribute specifies the length or size of the
list.
Exceptions on setting
DOMExceptionNOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.
- Methods
-
item-
This method retrieves a node specified by ordinal index. Nodes are numbered in tree order (depth-first traversal order).
Parameters
indexof typeunsigned long- The index of the node to be fetched. The index origin is
0.
Return Value
NodeThe
Nodeat the corresponding position upon success. A value ofnullis returned if the index is out of range.No Exceptions
namedItem-
This method retrieves a
Nodeusing a name. It first searches for aNodewith a matchingidattribute. If it doesn't find one, it then searches for aNodewith a matchingnameattribute, 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.Parameters
nameof typeDOMString- The name of the
Nodeto be fetched.
Return Value
NodeThe
Nodewith anameoridattribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returnsnull.No Exceptions
1.5. Objects related to HTML documents
- Interface HTMLDocument
-
An
HTMLDocumentis 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
BODYelement:- alinkColor
- background
- bgColor
- fgColor
- linkColor
- vlinkColor
Note: In DOM Level 2, the method
getElementByIdis inherited from theDocumentinterface where it was moved to.
IDL Definition-
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); };
- Attributes
-
URLof typeDOMString, readonly- The absolute URI [IETF RFC 2396] of the
document.
anchorsof typeHTMLCollection, readonly- A collection of all the anchor (
A) elements in a document with a value for thenameattribute.Note: For reasons of backward compatibility, the returned set of anchors only contains those anchors created with the
nameattribute, not those created with theidattribute. Note that in [XHTML 1.0], thenameattribute (see section 4.10) has no semantics and is only present for legacy user agents: theidattribute is used instead. Users should prefer the iterator mechanisms provided by [DOM Level 2 Traversal] instead. appletsof typeHTMLCollection, readonly- A collection of all the
OBJECTelements that include applets andAPPLET(deprecated) elements in a document.
bodyof typeHTMLElement- The element that contains the content for the document. In
documents with
BODYcontents, returns theBODYelement. In frameset documents, this returns the outermostFRAMESETelement.
cookieof typeDOMString- This mutable string attribute denotes persistent state
information that (1) is associated with the current frame or
document and (2) is composed of information described by the
cookiesnon-terminal of [IETF RFC 2965], Section 4.2.2.
If no persistent state information is available for the current frame or document document, then this property's value is an empty string.
When this attribute is read, all cookies are returned as a single string, with each cookie's name-value pair concatenated into a list of name-value pairs, each list item being separated by a ';' (semicolon).
When this attribute is set, the value it is set to should be a string that adheres to thecookienon-terminal of [IETF RFC 2965]; 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 [IETF RFC 2396] 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 [IETF RFC 2396] 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 [IETF RFC 2965] 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.
Exceptions on setting
DOMExceptionSYNTAX_ERR: If the new value does not adhere to the cookie syntax specified by [IETF RFC 2965].
domainof typeDOMString, readonly- The domain name of the server that served the document, or
nullif the server cannot be identified by a domain name.
formsof typeHTMLCollection, readonly- A collection of all the forms of a document.
imagesof typeHTMLCollection, readonly- A collection of all the
IMGelements in a document. The behavior is limited toIMGelements for backwards compatibility.Note: As suggested by [HTML 4.01], to include images, authors may use the
OBJECTelement or theIMGelement. Therefore, it is recommended not to use this attribute to find the images in the document butgetElementsByTagNamewith HTML 4.01 orgetElementsByTagNameNSwith XHTML 1.0. linksof typeHTMLCollection, readonly- A collection of all
AREAelements and anchor (A) elements in a document with a value for thehrefattribute.
referrerof typeDOMString, readonly- Returns the URI [IETF RFC 2396] of the page that
linked to this page. The value is an empty string if the user
navigated to the page directly (not through a link, but, for
example, via a bookmark).
titleof typeDOMString- The title of a document as specified by the
TITLEelement in the head of the document.
- Methods
-
close-
Closes a document stream opened by
open()and forces rendering.No Parameters
No Return Value
No Exceptions
getElementsByName-
With [HTML 4.01] documents, this method returns the (possibly empty) collection of elements whose
namevalue is given byelementName. In [XHTML 1.0] documents, this methods only return the (possibly empty) collection of form controls with matching name. This method is case sensitive.Parameters
elementNameof typeDOMString- The
nameattribute value for an element.
Return Value
NodeListThe matching elements.
No Exceptions
open-
Open a document stream for writing. If a document exists in the target, this method clears it.
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 Load and Save]).
No Parameters
No Return Value
No Exceptions
write-
Write a string of text to a document stream opened by
open(). Note that the function will produce a document which is not necessarily driven by a DTD and therefore might be produce an invalid result in the context of the document.Parameters
textof typeDOMString- The string to be parsed into some structure in the document
structure model.
No Return Value
No Exceptions
writeln-
Write a string of text followed by a newline character to a document stream opened by
open(). Note that the function will produce a document which is not necessarily driven by a DTD and therefore might be produce an invalid result in the context of the documentParameters
textof typeDOMString- The string to be parsed into some structure in the document
structure model.
No Return Value
No Exceptions
1.6. HTML Elements
1.6.1. Property Attributes
HTML attributes are exposed as properties on the element object. The DOM naming conventions always determine the name of the exposed property, and are 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.01 (transitional and frameset) and XHTML 1.0 DTDs. The attributes have the semantics (including case-sensitivity) given in the [HTML 4.01] 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 for XML. 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 lowercase (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.
1.6.2. Naming Exceptions
To avoid namespace conflicts, two attributes with the same name
as a keyword in one of our chosen binding languages
were prefixed. The for attribute of the
LABEL and SCRIPT elements collides with
loop construct naming conventions and is renamed
htmlFor. The class attribute of the HTML
elements collides with class definitions naming conventions and is
renamed className.
1.6.3. Exposing Element Type
Names (tagName, (nodeName))
If the document is an HTML 4.01 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
document the element name is exposed as it is written in the XHTML
file. This means that the element type names are exposed in
lowercase for XHTML documents since the XHTML 1.0 DTDs defines
element type names as lowercase, and XHTML, being derived from XML,
is case sensitive.
1.6.4. The HTMLElement interface
- Interface HTMLElement
-
All HTML element interfaces derive from this class. Elements that only expose the HTML core attributes are represented by the base
HTMLElementinterface. These elements are as follows:- special: SUB, SUP, SPAN, BDO
- font: TT, I, B, U, S, STRIKE, BIG, SMALL
- phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBR
- list: DD, DT
- NOFRAMES, NOSCRIPT
- ADDRESS, CENTER
Note: The
styleattribute of an HTML element is accessible through theElementCSSInlineStyleinterface which is defined in the CSS module [DOM Level 2 Style Sheets and CSS].
IDL Definition-
interface HTMLElement : Element { attribute DOMString id; attribute DOMString title; attribute DOMString lang; attribute DOMString dir; attribute DOMString className; };
- Attributes
-
classNameof typeDOMString- The class attribute of the element. This attribute has been
renamed due to conflicts with the "class" keyword exposed by many
languages. See the
class attribute definition in HTML 4.01.
dirof typeDOMString- Specifies the base direction of directionally neutral text and
the directionality of tables. See the
dir attribute definition in HTML 4.01.
idof typeDOMString- The element's identifier. See the
id attribute definition in HTML 4.01.
langof typeDOMString- Language code defined in RFC 1766. See the
lang attribute definition in HTML 4.01.
titleof typeDOMString- The element's advisory title. See the
title attribute definition in HTML 4.01.
1.6.5. Object definitions
- Interface HTMLHtmlElement
-
Root of an HTML document. See the HTML element definition in HTML 4.01.
IDL Definition-
interface HTMLHtmlElement : HTMLElement { attribute DOMString version; };
- Attributes
-
versionof typeDOMString- Version information about the document's DTD. See the
version attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLHeadElement
-
Document head information. See the HEAD element definition in HTML 4.01.
IDL Definition-
interface HTMLHeadElement : HTMLElement { attribute DOMString profile; };
- Attributes
-
profileof typeDOMString- URI [IETF RFC 2396] designating a
metadata profile. See the
profile attribute definition in HTML 4.01.
- Interface HTMLLinkElement
-
The
LINKelement 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.01 (see also theLinkStyleinterface in the StyleSheet module [DOM Level 2 Style Sheets and CSS]).
IDL Definition-
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; };
- Attributes
-
charsetof typeDOMString- The character encoding of the resource being linked to. See the
charset attribute definition in HTML 4.01.
disabledof typeboolean- Enables/disables the link. This is currently only used for
style sheet links, and may be used to activate or deactivate style
sheets.
hrefof typeDOMString- The URI [IETF RFC 2396] of the linked
resource. See the
href attribute definition in HTML 4.01.
hreflangof typeDOMString- Language code of the linked resource. See the
hreflang attribute definition in HTML 4.01.
mediaof typeDOMString- Designed for use with one or more target media. See the
media attribute definition in HTML 4.01.
relof typeDOMString- Forward link type. See the
rel attribute definition in HTML 4.01.
revof typeDOMString- Reverse link type. See the
rev attribute definition in HTML 4.01.
targetof typeDOMString- Frame to render the resource in. See the
target attribute definition in HTML 4.01.
typeof typeDOMString- Advisory content type. See the
type attribute definition in HTML 4.01.
- Interface HTMLTitleElement
-
The document title. See the TITLE element definition in HTML 4.01.
IDL Definition-
interface HTMLTitleElement : HTMLElement { attribute DOMString text; };
- Attributes
-
textof typeDOMString- The specified title as a string.
- Interface HTMLMetaElement
-
This contains generic meta-information about the document. See the META element definition in HTML 4.01.
IDL Definition-
interface HTMLMetaElement : HTMLElement { attribute DOMString content; attribute DOMString httpEquiv; attribute DOMString name; attribute DOMString scheme; };
- Attributes
-
contentof typeDOMString- Associated information. See the
content attribute definition in HTML 4.01.
httpEquivof typeDOMString- HTTP response header name [IETF RFC 2616]. See the
http-equiv attribute definition in HTML 4.01.
nameof typeDOMString- Meta information name. See the
name attribute definition in HTML 4.01.
schemeof typeDOMString- Select form of content. See the
scheme attribute definition in HTML 4.01.
- Interface HTMLBaseElement
-
Document base URI [IETF RFC 2396]. See the BASE element definition in HTML 4.01.
IDL Definition-
interface HTMLBaseElement : HTMLElement { attribute DOMString href; attribute DOMString target; };
- Attributes
-
hrefof typeDOMString- The base URI [IETF RFC 2396]. See the
href attribute definition in HTML 4.01.
targetof typeDOMString- The default target frame. See the
target attribute definition in HTML 4.01.
- Interface HTMLIsIndexElement
-
This element is used for single-line text input. See the ISINDEX element definition in HTML 4.01. This element is deprecated in HTML 4.01.
IDL Definition-
interface HTMLIsIndexElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString prompt; };
- Attributes
-
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
promptof typeDOMString- The prompt message. See the
prompt attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLStyleElement
-
Style information. See the STYLE element definition in HTML 4.01, the CSS module [DOM Level 2 Style Sheets and CSS] and the
LinkStyleinterface in the StyleSheets module [DOM Level 2 Style Sheets and CSS].
IDL Definition-
interface HTMLStyleElement : HTMLElement { attribute boolean disabled; attribute DOMString media; attribute DOMString type; };
- Attributes
-
disabledof typeboolean- Enables/disables the style sheet.
mediaof typeDOMString- Designed for use with one or more target media. See the
media attribute definition in HTML 4.01.
typeof typeDOMString- The content type of the style sheet language. See the
type attribute definition in HTML 4.01.
- Interface HTMLBodyElement
-
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.01.
IDL Definition-
interface HTMLBodyElement : HTMLElement { attribute DOMString aLink; attribute DOMString background; attribute DOMString bgColor; attribute DOMString link; attribute DOMString text; attribute DOMString vLink; };
- Attributes
-
aLinkof typeDOMString- Color of active links (after mouse-button down, but before
mouse-button up). See the
alink attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
backgroundof typeDOMString- URI [IETF RFC 2396] of the background
texture tile image. See the
background attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
bgColorof typeDOMString- Document background color. See the
bgcolor attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
linkof typeDOMString- Color of links that are not active and unvisited. See the
link attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
textof typeDOMString- Document text color. See the
text attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
vLinkof typeDOMString- Color of links that have been visited by the user. See the
vlink attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLFormElement
-
The
FORMelement 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.01.
IDL Definition-
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(); };
- Attributes
-
acceptCharsetof typeDOMString- List of character sets supported by the server. See the
accept-charset attribute definition in HTML 4.01.
actionof typeDOMString- Server-side form handler. See the
action attribute definition in HTML 4.01.
elementsof typeHTMLCollection, readonly- Returns a collection of all form control elements in the
form.
enctypeof typeDOMString- The content type of the submitted form, generally
"application/x-www-form-urlencoded". See the
enctype attribute definition in HTML 4.01.
Note: The onsubmit even handler is not guaranteed to be triggered when invoking this method. The behavior is inconsistent for historical reasons and authors should not rely on a particular one.
lengthof typelong, readonly- The number of form controls in the form.
methodof typeDOMString- HTTP method [IETF RFC 2616] used to submit
form. See the
method attribute definition in HTML 4.01.
nameof typeDOMString- Names the form.
targetof typeDOMString- Frame to render the resource in. See the
target attribute definition in HTML 4.01.
- Methods
- Interface HTMLSelectElement
-
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.01.
IDL Definition-
interface HTMLSelectElement : HTMLElement { readonly attribute DOMString type; attribute long selectedIndex; attribute DOMString value; // Modified in DOM Level 2: attribute unsigned long length; // raises(DOMException) on setting readonly attribute HTMLFormElement form; // Modified in DOM Level 2: readonly attribute HTMLOptionsCollection options; attribute boolean disabled; attribute boolean multiple; attribute DOMString name; attribute long size; attribute long tabIndex; void add(in HTMLElement element, in HTMLElement before) raises(DOMException); void remove(in long index); void blur(); void focus(); };
- Attributes
-
disabledof typeboolean- The control is unavailable in this context. See the
disabled attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
lengthof typeunsigned long, modified in DOM Level 2- The number of options in this
SELECT.
Exceptions on setting
DOMExceptionNOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.
multipleof typeboolean- If true, multiple
OPTIONelements may be selected in thisSELECT. See the multiple attribute definition in HTML 4.01.
nameof typeDOMString- Form control or object name when submitted with a form. See the
name attribute definition in HTML 4.01.
optionsof typeHTMLOptionsCollection, readonly, modified in DOM Level 2- The collection of
OPTIONelements contained by this element.
selectedIndexof typelong- The ordinal index of the selected option, starting from 0. The
value -1 is returned if no element is selected. If multiple options
are selected, the index of the first selected option is
returned.
sizeof typelong- Number of visible rows. See the
size attribute definition in HTML 4.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
typeof typeDOMString, readonly- The type of this form control. This is the string
"select-multiple" when the multiple attribute is
trueand the string "select-one" whenfalse.
valueof typeDOMString- The current form control value (i.e. the value of the currently
selected option), if multiple options are selected this is the
value of the first selected option.
- Methods
-
add-
Add a new element to the collection of
OPTIONelements for thisSELECT. This method is the equivalent of theappendChildmethod of theNodeinterface if thebeforeparameter isnull. It is equivalent to theinsertBeforemethod on the parent ofbeforein all other cases. This method may have no effect if the new element is not anOPTIONor anOPTGROUP.Parameters
elementof typeHTMLElement- The element to add.
beforeof typeHTMLElement- The element to insert before, or
nullfor the tail of the list.
Exceptions
DOMExceptionNOT_FOUND_ERR: Raised if
beforeis not a descendant of theSELECTelement.No Return Value
blur-
Removes keyboard focus from this element.
No Parameters
No Return Value
No Exceptions
focus-
Gives keyboard focus to this element.
No Parameters
No Return Value
No Exceptions
remove-
Remove an element from the collection of
OPTIONelements for thisSELECT. Does nothing if no element has the given index.Parameters
indexof typelong- The index of the item to remove, starting from 0.
No Return Value
No Exceptions
- Interface HTMLOptGroupElement
-
Group options together in logical subdivisions. See the OPTGROUP element definition in HTML 4.01.
IDL Definition-
interface HTMLOptGroupElement : HTMLElement { attribute boolean disabled; attribute DOMString label; };
- Attributes
-
disabledof typeboolean- The control is unavailable in this context. See the
disabled attribute definition in HTML 4.01.
labelof typeDOMString- Assigns a label to this option group. See the
label attribute definition in HTML 4.01.
- Interface HTMLOptionElement
-
A selectable choice. See the OPTION element definition in HTML 4.01.
IDL Definition-
interface HTMLOptionElement : HTMLElement { readonly attribute HTMLFormElement form; // Modified in DOM Level 2: attribute boolean defaultSelected; readonly attribute DOMString text; // Modified in DOM Level 2: readonly attribute long index; attribute boolean disabled; attribute DOMString label; attribute boolean selected; attribute DOMString value; };
- Attributes
-
defaultSelectedof typeboolean, modified in DOM Level 2- Represents the value of the HTML selected attribute. The value
of this attribute does not change if the state of the corresponding
form control, in an interactive user agent, changes. See the
selected attribute definition in HTML 4.01.
disabledof typeboolean- The control is unavailable in this context. See the
disabled attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
indexof typelong, readonly, modified in DOM Level 2- The index of this
OPTIONin its parentSELECT, starting from 0.
labelof typeDOMString- Option label for use in hierarchical menus. See the
label attribute definition in HTML 4.01.
selectedof typeboolean- Represents the current state of the corresponding form control,
in an interactive user agent. Changing this attribute changes the
state of the form control, but does not change the value of the
HTML selected attribute of the element.
textof typeDOMString, readonly- The text contained within the option element.
valueof typeDOMString- The current form control value. See the
value attribute definition in HTML 4.01.
- Interface HTMLInputElement
-
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.01].
IDL Definition-
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; // Modified in DOM Level 2: attribute unsigned long 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(); };
- Attributes
-
acceptof typeDOMString- A comma-separated list of content types that a server
processing this form will handle correctly. See the
accept attribute definition in HTML 4.01.
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
alignof typeDOMString- Aligns this object (vertically or horizontally) with respect to
its surrounding text. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
altof typeDOMString- Alternate text for user agents not rendering the normal content
of this element. See the
alt attribute definition in HTML 4.01.
checkedof typeboolean- When the
typeattribute 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 checked attribute of the INPUT element.Note: During the handling of a click event on an input element with a type attribute that has the value "radio" or "checkbox", some implementations may change the value of this property before the event is being dispatched in the document. If the default action of the event is canceled, the value of the property may be changed back to its original value. This means that the value of this property during the handling of click events is implementation dependent.
defaultCheckedof typeboolean- When
typehas 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.01.
defaultValueof typeDOMString- When the
typeattribute 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.01.
disabledof typeboolean- The control is unavailable in this context. See the
disabled attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
maxLengthof typelong- Maximum number of characters for text fields, when
typehas the value "text" or "password". See the maxlength attribute definition in HTML 4.01.
nameof typeDOMString- Form control or object name when submitted with a form. See the
name attribute definition in HTML 4.01.
readOnlyof typeboolean- This control is read-only. Relevant only when
typehas the value "text" or "password". See the readonly attribute definition in HTML 4.01.
sizeof typeunsigned long, modified in DOM Level 2- Size information. The precise meaning is specific to each type
of field. See the
size attribute definition in HTML 4.01.
srcof typeDOMString- When the
typeattribute 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.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
typeof typeDOMString, modified in DOM Level 2- The type of control created (all lower case). See the
type attribute definition in HTML 4.01.
useMapof typeDOMString- Use client-side image map. See the
usemap attribute definition in HTML 4.01.
valueof typeDOMString- When the
typeattribute 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 thetypeattribute 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.01.
- Methods
-
blur-
Removes keyboard focus from this element.
No Parameters
No Return Value
No Exceptions
click-
Simulate a mouse-click. For
INPUTelements whosetypeattribute has one of the following values: "button", "checkbox", "radio", "reset", or "submit".No Parameters
No Return Value
No Exceptions
focus-
Gives keyboard focus to this element.
No Parameters
No Return Value
No Exceptions
select-
Select the contents of the text area. For
INPUTelements whosetypeattribute has one of the following values: "text", "file", or "password".No Parameters
No Return Value
No Exceptions
- Interface HTMLTextAreaElement
-
Multi-line text field. See the TEXTAREA element definition in HTML 4.01.
IDL Definition-
interface HTMLTextAreaElement : HTMLElement { // Modified in DOM Level 2: attribute DOMString defaultValue; readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute long cols; attribute boolean disabled; attribute DOMString name; attribute boolean readOnly; attribute long rows; attribute long tabIndex; readonly attribute DOMString type; attribute DOMString value; void blur(); void focus(); void select(); };
- Attributes
-
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
colsof typelong- Width of control (in characters). See the
cols attribute definition in HTML 4.01.
defaultValueof typeDOMString, modified in DOM Level 2- Represents the contents 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.
disabledof typeboolean- The control is unavailable in this context. See the
disabled attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
nameof typeDOMString- Form control or object name when submitted with a form. See the
name attribute definition in HTML 4.01.
readOnlyof typeboolean- This control is read-only. See the
readonly attribute definition in HTML 4.01.
rowsof typelong- Number of text rows. See the
rows attribute definition in HTML 4.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
typeof typeDOMString, readonly- The type of this form control. This the string
"textarea".
valueof typeDOMString- 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
contents of the element. If the entirety of the data can not fit
into a single
DOMString, the implementation may truncate the data.
- Methods
- Interface HTMLButtonElement
-
Push button. See the BUTTON element definition in HTML 4.01.
IDL Definition-
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; };
- Attributes
-
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
disabledof typeboolean- The control is unavailable in this context. See the
disabled attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
nameof typeDOMString- Form control or object name when submitted with a form. See the
name attribute definition in HTML 4.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
typeof typeDOMString, readonly- The type of button (all lower case). See the
type attribute definition in HTML 4.01.
valueof typeDOMString- The current form control value. See the
value attribute definition in HTML 4.01.
- Interface HTMLLabelElement
-
Form field label text. See the LABEL element definition in HTML 4.01.
IDL Definition-
interface HTMLLabelElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString htmlFor; };
- Attributes
-
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
htmlForof typeDOMString- This attribute links this label with another form control by
idattribute. See the for attribute definition in HTML 4.01.
- Interface HTMLFieldSetElement
-
Organizes form controls into logical groups. See the FIELDSET element definition in HTML 4.01.
IDL Definition-
interface HTMLFieldSetElement : HTMLElement { readonly attribute HTMLFormElement form; };
- Attributes
-
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
- Interface HTMLLegendElement
-
Provides a caption for a
FIELDSETgrouping. See the LEGEND element definition in HTML 4.01.
IDL Definition-
interface HTMLLegendElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString accessKey; attribute DOMString align; };
- Attributes
-
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
alignof typeDOMString- Text alignment relative to
FIELDSET. See the align attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
- Interface HTMLUListElement
-
Unordered list. See the UL element definition in HTML 4.01.
IDL Definition-
interface HTMLUListElement : HTMLElement { attribute boolean compact; attribute DOMString type; };
- Attributes
-
compactof typeboolean- Reduce spacing between list items. See the
compact attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
typeof typeDOMString- Bullet style. See the
type attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLOListElement
-
Ordered list. See the OL element definition in HTML 4.01.
IDL Definition-
interface HTMLOListElement : HTMLElement { attribute boolean compact; attribute long start; attribute DOMString type; };
- Attributes
-
compactof typeboolean- Reduce spacing between list items. See the
compact attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
startof typelong- Starting sequence number. See the
start attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
typeof typeDOMString- Numbering style. See the
type attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLDListElement
-
Definition list. See the DL element definition in HTML 4.01.
IDL Definition-
interface HTMLDListElement : HTMLElement { attribute boolean compact; };
- Attributes
-
compactof typeboolean- Reduce spacing between list items. See the
compact attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLDirectoryElement
-
Directory list. See the DIR element definition in HTML 4.01. This element is deprecated in HTML 4.01.
IDL Definition-
interface HTMLDirectoryElement : HTMLElement { attribute boolean compact; };
- Attributes
-
compactof typeboolean- Reduce spacing between list items. See the
compact attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLMenuElement
-
Menu list. See the MENU element definition in HTML 4.01. This element is deprecated in HTML 4.01.
IDL Definition-
interface HTMLMenuElement : HTMLElement { attribute boolean compact; };
- Attributes
-
compactof typeboolean- Reduce spacing between list items. See the
compact attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLLIElement
-
List item. See the LI element definition in HTML 4.01.
IDL Definition-
interface HTMLLIElement : HTMLElement { attribute DOMString type; attribute long value; };
- Attributes
-
typeof typeDOMString- List item bullet style. See the
type attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
valueof typelong- Reset sequence number when used in
OL. See the value attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01.
- Interface HTMLDivElement
-
Generic block container. See the DIV element definition in HTML 4.01.
IDL Definition-
interface HTMLDivElement : HTMLElement { attribute DOMString align; };
- Attributes
-
alignof typeDOMString- Horizontal text alignment. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLParagraphElement
-
Paragraphs. See the P element definition in HTML 4.01.
IDL Definition-
interface HTMLParagraphElement : HTMLElement { attribute DOMString align; };
- Attributes
-
alignof typeDOMString- Horizontal text alignment. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLHeadingElement
-
For the
H1toH6elements. See the H1 element definition in HTML 4.01.
IDL Definition-
interface HTMLHeadingElement : HTMLElement { attribute DOMString align; };
- Attributes
-
alignof typeDOMString- Horizontal text alignment. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLQuoteElement
-
For the
QandBLOCKQUOTEelements. See the Q element definition in HTML 4.01.
IDL Definition-
interface HTMLQuoteElement : HTMLElement { attribute DOMString cite; };
- Attributes
-
citeof typeDOMString- A URI [IETF RFC 2396] designating a
source document or message. See the
cite attribute definition in HTML 4.01.
- Interface HTMLPreElement
-
Preformatted text. See the PRE element definition in HTML 4.01.
IDL Definition-
interface HTMLPreElement : HTMLElement { attribute long width; };
- Attributes
-
widthof typelong- Fixed width for content. See the
width attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLBRElement
-
Force a line break. See the BR element definition in HTML 4.01.
IDL Definition-
interface HTMLBRElement : HTMLElement { attribute DOMString clear; };
- Attributes
-
clearof typeDOMString- Control flow of text around floats. See the
clear attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLBaseFontElement
-
Base font. See the BASEFONT element definition in HTML 4.01. This element is deprecated in HTML 4.01.
IDL Definition-
interface HTMLBaseFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; // Modified in DOM Level 2: attribute long size; };
- Attributes
-
colorof typeDOMString- Font color. See the color
attribute definition in HTML 4.01. This attribute is deprecated
in HTML 4.01.
faceof typeDOMString- Font face identifier. See the face
attribute definition in HTML 4.01. This attribute is deprecated
in HTML 4.01.
sizeof typelong, modified in DOM Level 2- Computed font size. See the
size attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLFontElement
-
Local change to font. See the FONT element definition in HTML 4.01. This element is deprecated in HTML 4.01.
IDL Definition-
interface HTMLFontElement : HTMLElement { attribute DOMString color; attribute DOMString face; attribute DOMString size; };
- Attributes
-
colorof typeDOMString- Font color. See the
color attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
faceof typeDOMString- Font face identifier. See the
face attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
sizeof typeDOMString- Font size. See the
size attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLHRElement
-
Create a horizontal rule. See the HR element definition in HTML 4.01.
IDL Definition-
interface HTMLHRElement : HTMLElement { attribute DOMString align; attribute boolean noShade; attribute DOMString size; attribute DOMString width; };
- Attributes
-
alignof typeDOMString- Align the rule on the page. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
noShadeof typeboolean- Indicates to the user agent that there should be no shading in
the rendering of this element. See the
noshade attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
sizeof typeDOMString- The height of the rule. See the
size attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
widthof typeDOMString- The width of the rule. See the
width attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLModElement
-
Notice of modification to part of a document. See the INS and DEL element definitions in HTML 4.01.
IDL Definition-
interface HTMLModElement : HTMLElement { attribute DOMString cite; attribute DOMString dateTime; };
- Attributes
-
citeof typeDOMString- A URI [IETF RFC 2396] designating a
document that describes the reason for the change. See the cite
attribute definition in HTML 4.01.
dateTimeof typeDOMString- The date and time of the change. See the
datetime attribute definition in HTML 4.01.
- Interface HTMLAnchorElement
-
The anchor element. See the A element definition in HTML 4.01.
IDL Definition-
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(); };
- Attributes
-
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
charsetof typeDOMString- The character encoding of the linked resource. See the
charset attribute definition in HTML 4.01.
coordsof typeDOMString- Comma-separated list of lengths, defining an active region
geometry. See also
shapefor the shape of the region. See the coords attribute definition in HTML 4.01.
hrefof typeDOMString- The absolute URI [IETF RFC 2396] of the linked
resource. See the
href attribute definition in HTML 4.01.
hreflangof typeDOMString- Language code of the linked resource. See the
hreflang attribute definition in HTML 4.01.
nameof typeDOMString- Anchor name. See the
name attribute definition in HTML 4.01.
relof typeDOMString- Forward link type. See the
rel attribute definition in HTML 4.01.
revof typeDOMString- Reverse link type. See the
rev attribute definition in HTML 4.01.
shapeof typeDOMString- The shape of the active area. The coordinates are given by
coords. See the shape attribute definition in HTML 4.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
targetof typeDOMString- Frame to render the resource in. See the
target attribute definition in HTML 4.01.
typeof typeDOMString- Advisory content type. See the
type attribute definition in HTML 4.01.
- Methods
- Interface HTMLImageElement
-
Embedded image. See the IMG element definition in HTML 4.01.
IDL Definition-
interface HTMLImageElement : HTMLElement { attribute DOMString name; attribute DOMString align; attribute DOMString alt; attribute DOMString border; // Modified in DOM Level 2: attribute long height; // Modified in DOM Level 2: attribute long hspace; attribute boolean isMap; attribute DOMString longDesc; attribute DOMString src; attribute DOMString useMap; // Modified in DOM Level 2: attribute long vspace; // Modified in DOM Level 2: attribute long width; };
- Attributes
-
alignof typeDOMString- Aligns this object (vertically or horizontally) with respect to
its surrounding text. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
altof typeDOMString- Alternate text for user agents not rendering the normal content
of this element. See the
alt attribute definition in HTML 4.01.
borderof typeDOMString- Width of border around image. See the
border attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01. Note that the type of this attribute was
DOMStringin DOM Level 1 HTML [DOM Level 1].
heightof typelong, modified in DOM Level 2- Height of the image in pixels. See the
height attribute definition in HTML 4.01. Note that the type of
this attribute was
DOMStringin DOM Level 1 HTML [DOM Level 1].
hspaceof typelong, modified in DOM Level 2- Horizontal space to the left and right of this image in pixels.
See the
hspace attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01. Note that the type of this attribute was
DOMStringin DOM Level 1 HTML [DOM Level 1].
isMapof typeboolean- Use server-side image map. See the
ismap attribute definition in HTML 4.01.
longDescof typeDOMString- URI [IETF RFC 2396] designating a
long description of this image or frame. See the
longdesc attribute definition in HTML 4.01.
nameof typeDOMString- The name of the element (for backwards compatibility).
srcof typeDOMString- URI [IETF RFC 2396] designating the
source of this image. See the
src attribute definition in HTML 4.01.
useMapof typeDOMString- Use client-side image map. See the
usemap attribute definition in HTML 4.01.
vspaceof typelong, modified in DOM Level 2- Vertical space above and below this image in pixels. See the
vspace attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01. Note that the type of this attribute was
"DOMString" in DOM Level 1 HTML [DOM Level 1].
widthof typelong, modified in DOM Level 2- The width of the image in pixels. See the
width attribute definition in HTML 4.01. Note that the type of
this attribute was
DOMStringin DOM Level 1 HTML [DOM Level 1].
- Interface HTMLObjectElement
-
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.01].
IDL Definition-
interface HTMLObjectElement : HTMLElement { readonly attribute HTMLFormElement form; attribute DOMString code; attribute DOMString align; attribute DOMString archive; attribute DOMString border; attribute DOMString codeBase; attribute DOMString codeType; attribute DOMString data; attribute boolean declare; attribute DOMString height; attribute long hspace; attribute DOMString name; attribute DOMString standby; attribute long tabIndex; attribute DOMString type; attribute DOMString useMap; attribute long vspace; attribute DOMString width; // Introduced in DOM Level 2: readonly attribute Document contentDocument; };
- Attributes
-
alignof typeDOMString- Aligns this object (vertically or horizontally) with respect to
its surrounding text. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
archiveof typeDOMString- Space-separated list of archives. See the
archive attribute definition in HTML 4.01.
borderof typeDOMString- Width of border around the object. See the
border attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
codeof typeDOMString- Applet class file. See the
codeattribute for HTMLAppletElement.
codeBaseof typeDOMString- Base URI [IETF RFC 2396] for
classid,data, andarchiveattributes. See the codebase attribute definition in HTML 4.01.
codeTypeof typeDOMString- Content type for data downloaded via
classidattribute. See the codetype attribute definition in HTML 4.01.
contentDocumentof typeDocument, readonly, introduced in DOM Level 2- The document this object contains, if there is any and it is
available, or
nullotherwise.
dataof typeDOMString- A URI [IETF RFC 2396] specifying the
location of the object's data. See the
data attribute definition in HTML 4.01.
declareof typeboolean- Declare (for future reference), but do not instantiate, this
object. See the
declare attribute definition in HTML 4.01.
formof typeHTMLFormElement, readonly- Returns the
FORMelement containing this control. Returnsnullif this control is not within the context of a form.
heightof typeDOMString- Override height. See the
height attribute definition in HTML 4.01.
hspaceof typelong- Horizontal space, in pixels, to the left and right of this
image, applet, or object. See the
hspace attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
nameof typeDOMString- Form control or object name when submitted with a form. See the
name attribute definition in HTML 4.01.
standbyof typeDOMString- Message to render while loading the object. See the
standby attribute definition in HTML 4.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
typeof typeDOMString- Content type for data downloaded via
dataattribute. See the type attribute definition in HTML 4.01.
useMapof typeDOMString- Use client-side image map. See the
usemap attribute definition in HTML 4.01.
vspaceof typelong- Vertical space, in pixels, above and below this image, applet,
or object. See the
vspace attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
widthof typeDOMString- Override width. See the
width attribute definition in HTML 4.01.
- Interface HTMLParamElement
-
Parameters fed to the
OBJECTelement. See the PARAM element definition in HTML 4.01.
IDL Definition-
interface HTMLParamElement : HTMLElement { attribute DOMString name; attribute DOMString type; attribute DOMString value; attribute DOMString valueType; };
- Attributes
-
nameof typeDOMString- The name of a run-time parameter. See the
name attribute definition in HTML 4.01.
typeof typeDOMString- Content type for the
valueattribute whenvaluetypehas the value "ref". See the type attribute definition in HTML 4.01.
valueof typeDOMString- The value of a run-time parameter. See the
value attribute definition in HTML 4.01.
valueTypeof typeDOMString- Information about the meaning of the
valueattribute value. See the valuetype attribute definition in HTML 4.01.
- Interface HTMLAppletElement
-
An embedded Java applet. See the APPLET element definition in HTML 4.01. This element is deprecated in HTML 4.01.
IDL Definition-
interface HTMLAppletElement : HTMLElement { attribute DOMString align; attribute DOMString alt; attribute DOMString archive; attribute DOMString code; attribute DOMString codeBase; attribute DOMString height; // Modified in DOM Level 2: attribute long hspace; attribute DOMString name; // Modified in DOM Level 2: attribute DOMString object; // Modified in DOM Level 2: attribute long vspace; attribute DOMString width; };
- Attributes
-
alignof typeDOMString- Aligns this object (vertically or horizontally) with respect to
its surrounding text. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
altof typeDOMString- Alternate text for user agents not rendering the normal content
of this element. See the
alt attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
archiveof typeDOMString- Comma-separated archive list. See the
archive attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
codeof typeDOMString- Applet class file. See the
code attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
codeBaseof typeDOMString- Optional base URI [IETF RFC 2396] for applet. See
the
codebase attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
heightof typeDOMString- Override height. See the
height attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
hspaceof typelong, modified in DOM Level 2- Horizontal space, in pixels, to the left and right of this
image, applet, or object. See the
hspace attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
nameof typeDOMString- The name of the applet. See the
name attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
objectof typeDOMString, modified in DOM Level 2- The value of the "object" attribute. See the
object attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
vspaceof typelong, modified in DOM Level 2- Vertical space, in pixels, above and below this image, applet,
or object. See the
vspace attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
widthof typeDOMString- Override width. See the
width attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLMapElement
-
Client-side image map. See the MAP element definition in HTML 4.01.
IDL Definition-
interface HTMLMapElement : HTMLElement { readonly attribute HTMLCollection areas; attribute DOMString name; };
- Attributes
-
areasof typeHTMLCollection, readonly- The list of areas defined for the image map.
nameof typeDOMString- Names the map (for use with
usemap). See the name attribute definition in HTML 4.01.
- Interface HTMLAreaElement
-
Client-side image map area definition. See the AREA element definition in HTML 4.01.
IDL Definition-
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; };
- Attributes
-
accessKeyof typeDOMString- A single character access key to give access to the form
control. See the
accesskey attribute definition in HTML 4.01.
altof typeDOMString- Alternate text for user agents not rendering the normal content
of this element. See the
alt attribute definition in HTML 4.01.
coordsof typeDOMString- Comma-separated list of lengths, defining an active region
geometry. See also
shapefor the shape of the region. See the coords attribute definition in HTML 4.01.
hrefof typeDOMString- The URI [IETF RFC 2396] of the linked
resource. See the
href attribute definition in HTML 4.01.
noHrefof typeboolean- Specifies that this area is inactive, i.e., has no associated
action. See the
nohref attribute definition in HTML 4.01.
shapeof typeDOMString- The shape of the active area. The coordinates are given by
coords. See the shape attribute definition in HTML 4.01.
tabIndexof typelong- Index that represents the element's position in the tabbing
order. See the
tabindex attribute definition in HTML 4.01.
targetof typeDOMString- Frame to render the resource in. See the
target attribute definition in HTML 4.01.
- Interface HTMLScriptElement
-
Script statements. See the SCRIPT element definition in HTML 4.01.
IDL Definition-
interface HTMLScriptElement : HTMLElement { attribute DOMString text; attribute DOMString htmlFor; attribute DOMString event; attribute DOMString charset; attribute boolean defer; attribute DOMString src; attribute DOMString type; };
- Attributes
-
charsetof typeDOMString- The character encoding of the linked resource. See the
charset attribute definition in HTML 4.01.
deferof typeboolean- Indicates that the user agent can defer processing of the
script. See the
defer attribute definition in HTML 4.01.
eventof typeDOMString- Reserved for future use.
htmlForof typeDOMString- Reserved for future use.
srcof typeDOMString- URI [IETF RFC 2396] designating an
external script. See the
src attribute definition in HTML 4.01.
textof typeDOMString- The script content of the element.
typeof typeDOMString- The content type of the script language. See the
type attribute definition in HTML 4.01.
- Interface HTMLTableElement
-
The create* and delete* methods on the table allow authors to construct and modify tables. [HTML 4.01] specifies that only one of each of the
CAPTION,THEAD, andTFOOTelements 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.01.
IDL Definition-
interface HTMLTableElement : HTMLElement { // Modified in DOM Level 2: attribute HTMLTableCaptionElement caption; // raises(DOMException) on setting // Modified in DOM Level 2: attribute HTMLTableSectionElement tHead; // raises(DOMException) on setting // Modified in DOM Level 2: attribute HTMLTableSectionElement tFoot; // raises(DOMException) on setting 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(); // Modified in DOM Level 2: HTMLElement insertRow(in long index) raises(DOMException); // Modified in DOM Level 2: void deleteRow(in long index) raises(DOMException); };
- Attributes
-
alignof typeDOMString- Specifies the table's position with respect to the rest of the
document. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
bgColorof typeDOMString- Cell background color. See the
bgcolor attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
borderof typeDOMString- The width of the border around the table. See the
border attribute definition in HTML 4.01.
captionof typeHTMLTableCaptionElement, modified in DOM Level 2- Returns the table's
CAPTION, or void if none exists.
Exceptions on setting
DOMExceptionHIERARCHY_REQUEST_ERR: if the element is not a
CAPTION. cellPaddingof typeDOMString- Specifies the horizontal and vertical space between cell
content and cell borders. See the
cellpadding attribute definition in HTML 4.01.
cellSpacingof typeDOMString- Specifies the horizontal and vertical separation between cells.
See the
cellspacing attribute definition in HTML 4.01.
frameof typeDOMString- Specifies which external table borders to render. See the
frame attribute definition in HTML 4.01.
rowsof typeHTMLCollection, readonly- Returns a collection of all the rows in the table, including
all in
THEAD,TFOOT, allTBODYelements.
rulesof typeDOMString- Specifies which internal table borders to render. See the
rules attribute definition in HTML 4.01.
summaryof typeDOMString- Description about the purpose or structure of a table. See the
summary attribute definition in HTML 4.01.
tBodiesof typeHTMLCollection, readonly- Returns a collection of the table bodies (including implicit
ones).
tFootof typeHTMLTableSectionElement, modified in DOM Level 2- Returns the table's
TFOOT, ornullif none exists.
Exceptions on setting
DOMExceptionHIERARCHY_REQUEST_ERR: if the element is not a
TFOOT. tHeadof typeHTMLTableSectionElement, modified in DOM Level 2- Returns the table's
THEAD, ornullif none exists.
Exceptions on setting
DOMExceptionHIERARCHY_REQUEST_ERR: if the element is not a
THEAD. widthof typeDOMString- Specifies the desired table width. See the
width attribute definition in HTML 4.01.
- Methods
-
createCaption-
Create a new table caption object or return an existing one.
Return Value
A
CAPTIONelement.No Parameters
No Exceptions
createTFoot-
Create a table footer row or return an existing one.
Return Value
A footer element (
TFOOT).No Parameters
No Exceptions
createTHead-
Create a table header row or return an existing one.
Return Value
A new table header element (
THEAD).No Parameters
No Exceptions
deleteCaption-
Delete the table caption, if one exists.
No Parameters
No Return Value
No Exceptions
deleteRowmodified in DOM Level 2-
Delete a table row.
Parameters
indexof typelong- The index of the row to be deleted. This index starts from 0
and is relative to the logical order (not document order) of all
the rows contained inside the table. If the index is -1 the last
row in the table is deleted.
Exceptions
DOMExceptionINDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is a negative number other than -1.
No Return Value
deleteTFoot-
Delete the footer from the table, if one exists.
No Parameters
No Return Value
No Exceptions
deleteTHead-
Delete the header from the table, if one exists.
No Parameters
No Return Value
No Exceptions
insertRowmodified in DOM Level 2-
Insert a new empty row in the table. The new row is inserted immediately before and in the same section as the current
indexth row in the table. Ifindexis -1 or equal to the number of rows, the new row is appended. In addition, when the table is empty the row is inserted into aTBODYwhich is created and inserted into the table.Note: A table row cannot be empty according to [HTML 4.01].
Parameters
indexof typelong- The row number where to insert a new row. This index starts
from 0 and is relative to the logical order (not document order) of
all the rows contained inside the table.
Return Value
The newly created row.
Exceptions
DOMExceptionINDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows or if the index is a negative number other than -1.
- Interface HTMLTableCaptionElement
-
Table caption See the CAPTION element definition in HTML 4.01.
IDL Definition-
interface HTMLTableCaptionElement : HTMLElement { attribute DOMString align; };
- Attributes
-
alignof typeDOMString- Caption alignment with respect to the table. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLTableColElement
-
Regroups the
COLandCOLGROUPelements. See the COL element definition in HTML 4.01.
IDL Definition-
interface HTMLTableColElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute long span; attribute DOMString vAlign; attribute DOMString width; };
- Attributes
-
alignof typeDOMString- Horizontal alignment of cell data in column. See the
align attribute definition in HTML 4.01.
chof typeDOMString- Alignment character for cells in a column. See the
char attribute definition in HTML 4.01.
chOffof typeDOMString- Offset of alignment character. See the
charoff attribute definition in HTML 4.01.
spanof typelong- Indicates the number of columns in a group or affected by a
grouping. See the
span attribute definition in HTML 4.01.
vAlignof typeDOMString- Vertical alignment of cell data in column. See the
valign attribute definition in HTML 4.01.
widthof typeDOMString- Default column width. See the
width attribute definition in HTML 4.01.
- Interface HTMLTableSectionElement
-
The
THEAD,TFOOT, andTBODYelements.
IDL Definition-
interface HTMLTableSectionElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; readonly attribute HTMLCollection rows; // Modified in DOM Level 2: HTMLElement insertRow(in long index) raises(DOMException); // Modified in DOM Level 2: void deleteRow(in long index) raises(DOMException); };
- Attributes
-
alignof typeDOMString- Horizontal alignment of data in cells. See the
alignattribute for HTMLTheadElement for details.
chof typeDOMString- Alignment character for cells in a column. See the
char attribute definition in HTML 4.01.
chOffof typeDOMString- Offset of alignment character. See the
charoff attribute definition in HTML 4.01.
rowsof typeHTMLCollection, readonly- The collection of rows in this table section.
vAlignof typeDOMString- Vertical alignment of data in cells. See the
valignattribute for HTMLTheadElement for details.
- Methods
-
deleteRowmodified in DOM Level 2-
Delete a row from this section.
Parameters
indexof typelong- The index of the row to be deleted, or -1 to delete the last
row. This index starts from 0 and is relative only to the rows
contained inside this section, not all the rows in the table.
Exceptions
DOMExceptionINDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is a negative number other than -1.
No Return Value
insertRowmodified in DOM Level 2-
Insert a row into this section. The new row is inserted immediately before the current
indexth row in this section. Ifindexis -1 or equal to the number of rows in this section, the new row is appended.Parameters
indexof typelong- 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.
Return Value
The newly created row.
Exceptions
DOMExceptionINDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows of if the index is a negative number other than -1.
- Interface HTMLTableRowElement
-
A row in a table. See the TR element definition in HTML 4.01.
IDL Definition-
interface HTMLTableRowElement : HTMLElement { // Modified in DOM Level 2: readonly attribute long rowIndex; // Modified in DOM Level 2: readonly attribute long sectionRowIndex; // Modified in DOM Level 2: readonly attribute HTMLCollection cells; attribute DOMString align; attribute DOMString bgColor; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; // Modified in DOM Level 2: HTMLElement insertCell(in long index) raises(DOMException); // Modified in DOM Level 2: void deleteCell(in long index) raises(DOMException); };
- Attributes
-
alignof typeDOMString- Horizontal alignment of data within cells of this row. See the
align attribute definition in HTML 4.01.
bgColorof typeDOMString- Background color for rows. See the
bgcolor attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
cellsof typeHTMLCollection, readonly, modified in DOM Level 2- The collection of cells in this row.
chof typeDOMString- Alignment character for cells in a column. See the
char attribute definition in HTML 4.01.
chOffof typeDOMString- Offset of alignment character. See the
charoff attribute definition in HTML 4.01.
rowIndexof typelong, readonly, modified in DOM Level 2- This is in logical order and not in document order. The
rowIndexdoes take into account sections (THEAD,TFOOT, orTBODY) within the table, placingTHEADrows first in the index, followed byTBODYrows, followed byTFOOTrows.
sectionRowIndexof typelong, readonly, modified in DOM Level 2- The index of this row, relative to the current section
(
THEAD,TFOOT, orTBODY), starting from 0.
vAlignof typeDOMString- Vertical alignment of data within cells of this row. See the
valign attribute definition in HTML 4.01.
- Methods
-
deleteCellmodified in DOM Level 2-
Delete a cell from the current row.
Parameters
indexof typelong- The index of the cell to delete, starting from 0. If the index
is -1 the last cell in the row is deleted.
Exceptions
DOMExceptionINDEX_SIZE_ERR: Raised if the specified
indexis greater than or equal to the number of cells or if the index is a negative number other than -1.No Return Value
insertCellmodified in DOM Level 2-
Insert an empty
TDcell into this row. Ifindexis -1 or equal to the number of cells, the new cell is appended.Parameters
indexof typelong- The place to insert the cell, starting from 0.
Return Value
The newly created cell.
Exceptions
DOMExceptionINDEX_SIZE_ERR: Raised if the specified
indexis greater than the number of cells or if the index is a negative number other than -1.
- Interface HTMLTableCellElement
-
The object used to represent the
THandTDelements. See the TD element definition in HTML 4.01.
IDL Definition-
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; };
- Attributes
-
abbrof typeDOMString- Abbreviation for header cells. See the
abbr attribute definition in HTML 4.01.
alignof typeDOMString- Horizontal alignment of data in cell. See the
align attribute definition in HTML 4.01.
axisof typeDOMString- Names group of related headers. See the
axis attribute definition in HTML 4.01.
bgColorof typeDOMString- Cell background color. See the
bgcolor attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
cellIndexof typelong, readonly- The index of this cell in the row, starting from 0. This index
is in document tree order and not display order.
chof typeDOMString- Alignment character for cells in a column. See the
char attribute definition in HTML 4.01.
chOffof typeDOMString- Offset of alignment character. See the
charoff attribute definition in HTML 4.01.
colSpanof typelong- Number of columns spanned by cell. See the
colspan attribute definition in HTML 4.01.
headersof typeDOMString- List of
idattribute values for header cells. See the headers attribute definition in HTML 4.01.
heightof typeDOMString- Cell height. See the
height attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
noWrapof typeboolean- Suppress word wrapping. See the
nowrap attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
rowSpanof typelong- Number of rows spanned by cell. See the
rowspan attribute definition in HTML 4.01.
scopeof typeDOMString- Scope covered by header cells. See the
scope attribute definition in HTML 4.01.
vAlignof typeDOMString- Vertical alignment of data in cell. See the
valign attribute definition in HTML 4.01.
widthof typeDOMString- Cell width. See the
width attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
- Interface HTMLFrameSetElement
-
Create a grid of frames. See the FRAMESET element definition in HTML 4.01.
IDL Definition-
interface HTMLFrameSetElement : HTMLElement { attribute DOMString cols; attribute DOMString rows; };
- Attributes
-
colsof typeDOMString- The number of columns of frames in the frameset. See the
cols attribute definition in HTML 4.01.
rowsof typeDOMString- The number of rows of frames in the frameset. See the
rows attribute definition in HTML 4.01.
- Interface HTMLFrameElement
-
Create a frame. See the FRAME element definition in HTML 4.01.
IDL Definition-
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; };
- Attributes
-
contentDocumentof typeDocument, readonly, introduced in DOM Level 2- The document this frame contains, if there is any and it is
available, or
nullotherwise.
frameBorderof typeDOMString- Request frame borders. See the
frameborder attribute definition in HTML 4.01.
longDescof typeDOMString- URI [IETF RFC 2396] designating a
long description of this image or frame. See the
longdesc attribute definition in HTML 4.01.
marginHeightof typeDOMString- Frame margin height, in pixels. See the
marginheight attribute definition in HTML 4.01.
marginWidthof typeDOMString- Frame margin width, in pixels. See the
marginwidth attribute definition in HTML 4.01.
nameof typeDOMString- The frame name (object of the
targetattribute). See the name attribute definition in HTML 4.01.
noResizeof typeboolean- When true, forbid user from resizing frame. See the
noresize attribute definition in HTML 4.01.
scrollingof typeDOMString- Specify whether or not the frame should have scrollbars. See
the
scrolling attribute definition in HTML 4.01.
srcof typeDOMString- A URI [IETF RFC 2396] designating the
initial frame contents. See the
src attribute definition in HTML 4.01.
- Interface HTMLIFrameElement
-
Inline subwindows. See the IFRAME element definition in HTML 4.01.
IDL Definition-
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; };
- Attributes
-
alignof typeDOMString- Aligns this object (vertically or horizontally) with respect to
its surrounding text. See the
align attribute definition in HTML 4.01. This attribute is
deprecated in HTML 4.01.
contentDocumentof typeDocument, readonly, introduced in DOM Level 2- The document this frame contains, if there is any and it is
available, or
nullotherwise.
frameBorderof typeDOMString- Request frame borders. See the
frameborder attribute definition in HTML 4.01.
heightof typeDOMString- Frame height. See the
height attribute definition in HTML 4.01.
longDescof typeDOMString- URI [IETF RFC 2396] designating a
long description of this image or frame. See the
longdesc attribute definition in HTML 4.01.
marginHeightof typeDOMString- Frame margin height, in pixels. See the
marginheight attribute definition in HTML 4.01.
marginWidthof typeDOMString- Frame margin width, in pixels. See the
marginwidth attribute definition in HTML 4.01.
nameof typeDOMString- The frame name (object of the
targetattribute). See the name attribute definition in HTML 4.01.
scrollingof typeDOMString- Specify whether or not the frame should have scrollbars. See
the
scrolling attribute definition in HTML 4.01.
srcof typeDOMString- A URI [IETF RFC 2396] designating the
initial frame contents. See the
src attribute definition in HTML 4.01.
widthof typeDOMString- Frame width. See the
width attribute definition in HTML 4.01.
09 January 2003
Appendix A: Changes
- Editor:
- Philippe Le Hégaret, W3C
A.1: Changes between DOM Level 1 and DOM Level 2
Note: The DOM Level 2 HTML module is not backward compatible with the DOM Level 1 HTML module.
- OMG IDL
- The DOM Level 2 specifications use CORBA 2.3.1 instead of CORBA 2.2.
- XHTML 1.0 support
- The DOM Level 2 HTML module supports HTML 4 as well as XHTML
1.0 documents. Therefore, case sensitivity in methods depends on
Documentsupport for the feature "XML" as well as "HTML".
A.1.1: Changes to DOM Level 1 interfaces and exceptions
- Interface
HTMLDocument - the method
getElementByIdis now inherited from theDocumentinterface [DOM Level 2 Core] where it was moved. - Interface
HTMLSelectElement - The type of the attribute
optionswas changed fromHTMLCollectiontoHTMLOptionsCollection.
The attributelengthis no longer readonly and is now unsigned. - Interface
HTMLOptionElement - Changing the
defaultSelectedattribute does not reset the state of the form control.
indexis readonly. - Interface
HTMLInputElement - the attribute
typeis no longer read only.
The type of the attributesizewas changed fromDOMStringtounsigned long. - Interface
HTMLTextAreaElement - Changing the
defaultValueattribute does not reset the contents of the form control. - Interface
HTMLBlockquoteElement - this interface has been removed.
BLOCKQUOTEelements are now supported by theHTMLQuoteElementinterface. - Interface
HTMLBaseFontElement - The attribute
sizeis of typelong. - Interface
HTMLImageElement - The
lowSrcattribute was removed.
The types of the attributesheight,hspace,widthandvspacewere changed fromDOMStringtolong. - Interface
HTMLObjectElement - The attribute
contentDocumentwas added. - Interface
HTMLAppletElement - The types of the attributes
hspaceandvspacewere changed fromDOMStringtolong.
The attributeobjectreturns the value of the HTML object attribute. - Interface
HTMLTableElement caption,tHead,tFoot,insertRow, anddeleteRowmay raise exceptions.
indexuses a logical order, and not a document order.- Interface
HTMLTableSectionElement - The methods
insertRowanddeleteRowmay raise exceptions. - Interface
HTMLTableRowElement - The attributes
rowIndex,sectionRowIndex, andcellsare readonly.
The methodsinsertCellanddeleteCellmay raise exceptions.
rowIndexuses a logical order, and not a document order. - Interface
HTMLFrameElement - the attribute
contentDocumentwas added. - Interface
HTMLIFrameElement - the attribute
contentDocumentwas added. - Module and package name
- The module name used in the OMG IDL is now
html2.
The package name used in the Java bindings is noworg.w3c.dom.html2.
A.1.2: New Interfaces
- Interface
HTMLOptionsCollection - The
HTMLOptionsCollectioninterface was added to the HTML module.
09 January 2003
Appendix B: IDL Definitions
This appendix contains the complete OMG IDL [OMG IDL] 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/2003/REC-DOM-Level-2-HTML-20030109/idl.zip
html2.idl:
// File: html2.idl
#ifndef _HTML2_IDL_
#define _HTML2_IDL_
#include "dom.idl"
#pragma prefix "dom.w3c.org"
module html2
{
typedef dom::DOMString DOMString;
typedef dom::Node Node;
typedef dom::Document Document;
typedef dom::NodeList NodeList;
typedef dom::Element Element;
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 HTMLOptionsCollection {
attribute unsigned long length;
// raises(dom::DOMException) on setting
Node item(in unsigned long index);
Node namedItem(in DOMString name);
};
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;
// Modified in DOM Level 2:
attribute unsigned long length;
// raises(dom::DOMException) on setting
readonly attribute HTMLFormElement form;
// Modified in DOM Level 2:
readonly attribute HTMLOptionsCollection options;
attribute boolean disabled;
attribute boolean multiple;
attribute DOMString name;
attribute long size;
attribute long tabIndex;
void add(in HTMLElement element,
in HTMLElement before)
raises(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;
// Modified in DOM Level 2:
attribute boolean defaultSelected;
readonly attribute DOMString text;
// Modified in DOM Level 2:
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;
// Modified in DOM Level 2:
attribute unsigned long 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 {
// Modified in DOM Level 2:
attribute DOMString defaultValue;
readonly attribute HTMLFormElement form;
attribute DOMString accessKey;
attribute long cols;
attribute boolean disabled;
attribute DOMString name;
attribute boolean readOnly;
attribute long rows;
attribute long tabIndex;
readonly attribute DOMString type;
attribute DOMString value;
void blur();
void focus();
void select();
};
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;
// Modified in DOM Level 2:
attribute long 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 DOMString border;
// Modified in DOM Level 2:
attribute long height;
// Modified in DOM Level 2:
attribute long hspace;
attribute boolean isMap;
attribute DOMString longDesc;
attribute DOMString src;
attribute DOMString useMap;
// Modified in DOM Level 2:
attribute long vspace;
// Modified in DOM Level 2:
attribute long width;
};
interface HTMLObjectElement : HTMLElement {
readonly attribute HTMLFormElement form;
attribute DOMString code;
attribute DOMString align;
attribute DOMString archive;
attribute DOMString border;
attribute DOMString codeBase;
attribute DOMString codeType;
attribute DOMString data;
attribute boolean declare;
attribute DOMString height;
attribute long hspace;
attribute DOMString name;
attribute DOMString standby;
attribute long tabIndex;
attribute DOMString type;
attribute DOMString useMap;
attribute long vspace;
attribute DOMString width;
// 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;
// Modified in DOM Level 2:
attribute long hspace;
attribute DOMString name;
// Modified in DOM Level 2:
attribute DOMString object;
// Modified in DOM Level 2:
attribute long 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 {
// Modified in DOM Level 2:
attribute HTMLTableCaptionElement caption;
// raises(dom::DOMException) on setting
// Modified in DOM Level 2:
attribute HTMLTableSectionElement tHead;
// raises(dom::DOMException) on setting
// Modified in DOM Level 2:
attribute HTMLTableSectionElement tFoot;
// raises(dom::DOMException) on setting
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();
// Modified in DOM Level 2:
HTMLElement insertRow(in long index)
raises(dom::DOMException);
// Modified in DOM Level 2:
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;
// Modified in DOM Level 2:
HTMLElement insertRow(in long index)
raises(dom::DOMException);
// Modified in DOM Level 2:
void deleteRow(in long index)
raises(dom::DOMException);
};
interface HTMLTableRowElement : HTMLElement {
// Modified in DOM Level 2:
readonly attribute long rowIndex;
// Modified in DOM Level 2:
readonly attribute long sectionRowIndex;
// Modified in DOM Level 2:
readonly attribute HTMLCollection cells;
attribute DOMString align;
attribute DOMString bgColor;
attribute DOMString ch;
attribute DOMString chOff;
attribute DOMString vAlign;
// Modified in DOM Level 2:
HTMLElement insertCell(in long index)
raises(dom::DOMException);
// Modified in DOM Level 2:
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 // _HTML2_IDL_
09 January 2003
Appendix C: Java language Binding
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/2003/REC-DOM-Level-2-HTML-20030109/java-binding.zip
org/w3c/dom/html2/HTMLCollection.java:
package org.w3c.dom.html2;
import org.w3c.dom.Node;
public interface HTMLCollection {
public int getLength();
public Node item(int index);
public Node namedItem(String name);
}
org/w3c/dom/html2/HTMLOptionsCollection.java:
package org.w3c.dom.html2;
import org.w3c.dom.Node;
import org.w3c.dom.DOMException;
public interface HTMLOptionsCollection {
public int getLength();
public void setLength(int length)
throws DOMException;
public Node item(int index);
public Node namedItem(String name);
}
org/w3c/dom/html2/HTMLDocument.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLHtmlElement.java:
package org.w3c.dom.html2;
public interface HTMLHtmlElement extends HTMLElement {
public String getVersion();
public void setVersion(String version);
}
org/w3c/dom/html2/HTMLHeadElement.java:
package org.w3c.dom.html2;
public interface HTMLHeadElement extends HTMLElement {
public String getProfile();
public void setProfile(String profile);
}
org/w3c/dom/html2/HTMLLinkElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLTitleElement.java:
package org.w3c.dom.html2;
public interface HTMLTitleElement extends HTMLElement {
public String getText();
public void setText(String text);
}
org/w3c/dom/html2/HTMLMetaElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLBaseElement.java:
package org.w3c.dom.html2;
public interface HTMLBaseElement extends HTMLElement {
public String getHref();
public void setHref(String href);
public String getTarget();
public void setTarget(String target);
}
org/w3c/dom/html2/HTMLIsIndexElement.java:
package org.w3c.dom.html2;
public interface HTMLIsIndexElement extends HTMLElement {
public HTMLFormElement getForm();
public String getPrompt();
public void setPrompt(String prompt);
}
org/w3c/dom/html2/HTMLStyleElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLBodyElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLFormElement.java:
package org.w3c.dom.html2;
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();
}
org/w3c/dom/html2/HTMLSelectElement.java:
package org.w3c.dom.html2;
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 void setLength(int length)
throws DOMException;
public HTMLFormElement getForm();
public HTMLOptionsCollection 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();
}
org/w3c/dom/html2/HTMLOptGroupElement.java:
package org.w3c.dom.html2;
public interface HTMLOptGroupElement extends HTMLElement {
public boolean getDisabled();
public void setDisabled(boolean disabled);
public String getLabel();
public void setLabel(String label);
}
org/w3c/dom/html2/HTMLOptionElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLInputElement.java:
package org.w3c.dom.html2;
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 int getSize();
public void setSize(int 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();
}
org/w3c/dom/html2/HTMLTextAreaElement.java:
package org.w3c.dom.html2;
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();
}
org/w3c/dom/html2/HTMLButtonElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLLabelElement.java:
package org.w3c.dom.html2;
public interface HTMLLabelElement extends HTMLElement {
public HTMLFormElement getForm();
public String getAccessKey();
public void setAccessKey(String accessKey);
public String getHtmlFor();
public void setHtmlFor(String htmlFor);
}
org/w3c/dom/html2/HTMLFieldSetElement.java:
package org.w3c.dom.html2;
public interface HTMLFieldSetElement extends HTMLElement {
public HTMLFormElement getForm();
}
org/w3c/dom/html2/HTMLLegendElement.java:
package org.w3c.dom.html2;
public interface HTMLLegendElement extends HTMLElement {
public HTMLFormElement getForm();
public String getAccessKey();
public void setAccessKey(String accessKey);
public String getAlign();
public void setAlign(String align);
}
org/w3c/dom/html2/HTMLUListElement.java:
package org.w3c.dom.html2;
public interface HTMLUListElement extends HTMLElement {
public boolean getCompact();
public void setCompact(boolean compact);
public String getType();
public void setType(String type);
}
org/w3c/dom/html2/HTMLOListElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLDListElement.java:
package org.w3c.dom.html2;
public interface HTMLDListElement extends HTMLElement {
public boolean getCompact();
public void setCompact(boolean compact);
}
org/w3c/dom/html2/HTMLDirectoryElement.java:
package org.w3c.dom.html2;
public interface HTMLDirectoryElement extends HTMLElement {
public boolean getCompact();
public void setCompact(boolean compact);
}
package org.w3c.dom.html2;
public interface HTMLMenuElement extends HTMLElement {
public boolean getCompact();
public void setCompact(boolean compact);
}
org/w3c/dom/html2/HTMLLIElement.java:
package org.w3c.dom.html2;
public interface HTMLLIElement extends HTMLElement {
public String getType();
public void setType(String type);
public int getValue();
public void setValue(int value);
}
org/w3c/dom/html2/HTMLDivElement.java:
package org.w3c.dom.html2;
public interface HTMLDivElement extends HTMLElement {
public String getAlign();
public void setAlign(String align);
}
org/w3c/dom/html2/HTMLParagraphElement.java:
package org.w3c.dom.html2;
public interface HTMLParagraphElement extends HTMLElement {
public String getAlign();
public void setAlign(String align);
}
org/w3c/dom/html2/HTMLHeadingElement.java:
package org.w3c.dom.html2;
public interface HTMLHeadingElement extends HTMLElement {
public String getAlign();
public void setAlign(String align);
}
org/w3c/dom/html2/HTMLQuoteElement.java:
package org.w3c.dom.html2;
public interface HTMLQuoteElement extends HTMLElement {
public String getCite();
public void setCite(String cite);
}
org/w3c/dom/html2/HTMLPreElement.java:
package org.w3c.dom.html2;
public interface HTMLPreElement extends HTMLElement {
public int getWidth();
public void setWidth(int width);
}
org/w3c/dom/html2/HTMLBRElement.java:
package org.w3c.dom.html2;
public interface HTMLBRElement extends HTMLElement {
public String getClear();
public void setClear(String clear);
}
org/w3c/dom/html2/HTMLBaseFontElement.java:
package org.w3c.dom.html2;
public interface HTMLBaseFontElement extends HTMLElement {
public String getColor();
public void setColor(String color);
public String getFace();
public void setFace(String face);
public int getSize();
public void setSize(int size);
}
org/w3c/dom/html2/HTMLFontElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLHRElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLModElement.java:
package org.w3c.dom.html2;
public interface HTMLModElement extends HTMLElement {
public String getCite();
public void setCite(String cite);
public String getDateTime();
public void setDateTime(String dateTime);
}
org/w3c/dom/html2/HTMLAnchorElement.java:
package org.w3c.dom.html2;
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();
}
org/w3c/dom/html2/HTMLImageElement.java:
package org.w3c.dom.html2;
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 String getBorder();
public void setBorder(String 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);
}
org/w3c/dom/html2/HTMLObjectElement.java:
package org.w3c.dom.html2;
import org.w3c.dom.Document;
public interface HTMLObjectElement extends HTMLElement {
public HTMLFormElement getForm();
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 int getHspace();
public void setHspace(int 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 int getVspace();
public void setVspace(int vspace);
public String getWidth();
public void setWidth(String width);
public Document getContentDocument();
}
org/w3c/dom/html2/HTMLParamElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLAppletElement.java:
package org.w3c.dom.html2;
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 int getHspace();
public void setHspace(int hspace);
public String getName();
public void setName(String name);
public String getObject();
public void setObject(String object);
public int getVspace();
public void setVspace(int vspace);
public String getWidth();
public void setWidth(String width);
}
org/w3c/dom/html2/HTMLMapElement.java:
package org.w3c.dom.html2;
public interface HTMLMapElement extends HTMLElement {
public HTMLCollection getAreas();
public String getName();
public void setName(String name);
}
org/w3c/dom/html2/HTMLAreaElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLScriptElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLTableElement.java:
package org.w3c.dom.html2;
import org.w3c.dom.DOMException;
public interface HTMLTableElement extends HTMLElement {
public HTMLTableCaptionElement getCaption();
public void setCaption(HTMLTableCaptionElement caption)
throws DOMException;
public HTMLTableSectionElement getTHead();
public void setTHead(HTMLTableSectionElement tHead)
throws DOMException;
public HTMLTableSectionElement getTFoot();
public void setTFoot(HTMLTableSectionElement tFoot)
throws DOMException;
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;
}
org/w3c/dom/html2/HTMLTableCaptionElement.java:
package org.w3c.dom.html2;
public interface HTMLTableCaptionElement extends HTMLElement {
public String getAlign();
public void setAlign(String align);
}
org/w3c/dom/html2/HTMLTableColElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLTableSectionElement.java:
package org.w3c.dom.html2;
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;
}
org/w3c/dom/html2/HTMLTableRowElement.java:
package org.w3c.dom.html2;
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;
}
org/w3c/dom/html2/HTMLTableCellElement.java:
package org.w3c.dom.html2;
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);
}
org/w3c/dom/html2/HTMLFrameSetElement.java:
package org.w3c.dom.html2;
public interface HTMLFrameSetElement extends HTMLElement {
public String getCols();
public void setCols(String cols);
public String getRows();
public void setRows(String rows);
}
org/w3c/dom/html2/HTMLFrameElement.java:
package org.w3c.dom.html2;
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();
}
org/w3c/dom/html2/HTMLIFrameElement.java:
package org.w3c.dom.html2;
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();
}
09 January 2003
Appendix D: ECMAScript Language Binding
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]).
- Objects that implement the HTMLCollection interface:
-
- Properties of objects that implement the HTMLCollection interface:
-
- length
- This read-only property is a Number.
- Functions of objects that implement the HTMLCollection interface:
-
- item(index)
- This function returns an object that implements the Node
interface.
The index parameter is a Number.
Note: This object can also be dereferenced using square bracket notation (e.g. obj[1]). Dereferencing with an integer index is equivalent to invoking the item function with that index. - namedItem(name)
- This function returns an object that implements the Node
interface.
The name parameter is a String.
Note: This object can also be dereferenced using square bracket notation (e.g. obj["foo"]). Dereferencing using a string index is equivalent to invoking the namedItem function with that index.
- Objects that implement the HTMLOptionsCollection interface:
-
- Properties of objects that implement the HTMLOptionsCollection interface:
-
- length
- This property is a Number and can raise an object that implements DOMException interface on setting.
- Functions of objects that implement the HTMLOptionsCollection interface:
-
- item(index)
- This function returns an object that implements the Node
interface.
The index parameter is a Number.
Note: This object can also be dereferenced using square bracket notation (e.g. obj[1]). Dereferencing with an integer index is equivalent to invoking the item function with that index. - namedItem(name)
- This function returns an object that implements the Node
interface.
The name parameter is a String.
Note: This object can also be dereferenced using square bracket notation (e.g. obj["foo"]). Dereferencing using a string index is equivalent to invoking the namedItem function with that index.
- Objects that implement the HTMLDocument interface:
-
- Objects that implement the HTMLDocument interface have all properties and functions of the Document interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLDocument interface:
-
- title
- This property is a String.
- referrer
- This read-only property is a String.
- domain
- This read-only property is a String.
- URL
- This read-only property is a String.
- body
- This property is an object that implements the HTMLElement interface.
- images
- This read-only property is an object that implements the HTMLCollection interface.
- applets
- This read-only property is an object that implements the HTMLCollection interface.
- links
- This read-only property is an object that implements the HTMLCollection interface.
- forms
- This read-only property is an object that implements the HTMLCollection interface.
- anchors
- This read-only property is an object that implements the HTMLCollection interface.
- cookie
- This property is a String and can raise an object that implements DOMException interface on setting.
- Functions of objects that implement the HTMLDocument interface:
-
- open()
- This function has no return value.
- close()
- This function has no return value.
- write(text)
- This function has no return value.
The text parameter is a String. - writeln(text)
- This function has no return value.
The text parameter is a String. - getElementsByName(elementName)
- This function returns an object that implements the
NodeList interface.
The elementName parameter is a String.
- Objects that implement the HTMLElement interface:
-
- Objects that implement the HTMLElement interface have all properties and functions of the Element interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLElement interface:
-
- id
- This property is a String.
- title
- This property is a String.
- lang
- This property is a String.
- dir
- This property is a String.
- className
- This property is a String.
- Objects that implement the HTMLHtmlElement interface:
-
- Objects that implement the HTMLHtmlElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLHtmlElement interface:
-
- version
- This property is a String.
- Objects that implement the HTMLHeadElement interface:
-
- Objects that implement the HTMLHeadElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLHeadElement interface:
-
- profile
- This property is a String.
- Objects that implement the HTMLLinkElement interface:
-
- Objects that implement the HTMLLinkElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLLinkElement interface:
-
- disabled
- This property is a Boolean.
- charset
- This property is a String.
- href
- This property is a String.
- hreflang
- This property is a String.
- media
- This property is a String.
- rel
- This property is a String.
- rev
- This property is a String.
- target
- This property is a String.
- type
- This property is a String.
- Objects that implement the HTMLTitleElement interface:
-
- Objects that implement the HTMLTitleElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLTitleElement interface:
-
- text
- This property is a String.
- Objects that implement the HTMLMetaElement interface:
-
- Objects that implement the HTMLMetaElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLMetaElement interface:
-
- content
- This property is a String.
- httpEquiv
- This property is a String.
- name
- This property is a String.
- scheme
- This property is a String.
- Objects that implement the HTMLBaseElement interface:
-
- Objects that implement the HTMLBaseElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLBaseElement interface:
-
- href
- This property is a String.
- target
- This property is a String.
- Objects that implement the HTMLIsIndexElement interface:
-
- Objects that implement the HTMLIsIndexElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLIsIndexElement interface:
-
- form
- This read-only property is an object that implements the HTMLFormElement interface.
- prompt
- This property is a String.
- Objects that implement the HTMLStyleElement interface:
-
- Objects that implement the HTMLStyleElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLStyleElement interface:
-
- disabled
- This property is a Boolean.
- media
- This property is a String.
- type
- This property is a String.
- Objects that implement the HTMLBodyElement interface:
-
- Objects that implement the HTMLBodyElement interface have all properties and functions of the HTMLElement interface as well as the properties and functions defined below.
- Properties of objects that implement the HTMLBodyElement interface:
-
- aLink
- This property is a String.
- background
- This property is a String.
- bgColor
- This property is a String.
- link<