[W3C] Document Object Model (DOM) Level 2 HTML Specification Version 1.0 W3C Candidate Recommendation 05 June 2002 This version: http://www.w3.org/TR/2002/CR-DOM-Level-2-HTML-20020605 Latest version: http://www.w3.org/TR/DOM-Level-2-HTML Previous version: http://www.w3.org/TR/2001/WD-DOM-Level-2-HTML-20011210 Editors: Johnny Stenback, Netscape Arnaud Le Hors, W3C team contact until October 1999, then IBM Philippe Le Hégaret, W3C Chris Wilson, Microsoft Corp. (for DOM Level 1 after January 1998) Ian Jacobs, W3C (for DOM Level 1) Mike Champion, ArborText (for DOM Level 1) Scott Isaacs, Microsoft Corp. (for DOM Level 1 until January 1998) Vidur Apparao, Netscape Communications Corp. (for DOM Level 1) This document is also available in these non-normative formats: PostScript file, PDF file, plain text, ZIP file, and single HTML file. Copyright ©2002 W3C® (MIT, INRIA, 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 05 June 2002 W3C Candidate Recommendation of "DOM Level 2 HTML". W3C publishes a technical report as a Candidate Recommendation to indicate that the document is believed to be stable, and to encourage implementation by the developer community. Candidate Recommendation status is described in section 5.2.3 of the Process Document. The DOM Working Group expects to request that the Director advance this specification to Proposed Recommendation after the DOM Working Group documents two interoperable implementations of at least one normative binding. The two implementations must be produced by different organizations. The review period ends on 1 July 2002. Please send review comments before the review period ends to www-dom@w3.org (archive). Publication as a Candidate Recommendation does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than "work in progress." Some changes from DOM Level 1 HTML are incompatible with that specification but represent more accurately the state of deployed software. Therefore, this specification renders the DOM Level 1 HTML Recommendation obsolete. W3C strongly suggests that developers and authors conform to DOM Level 2 HTML instead. 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. A list of current W3C Recommendations and other technical documents can be found at http://www.w3.org/TR. Table of contents * Expanded Table of Contents * Copyright Notice * 1. Document Object Model HTML * Appendix A: Changes * Appendix B: IDL Definitions * Appendix C: Java Language Binding * Appendix D: ECMAScript Language Binding * Appendix E: Acknowledgements * Glossary * References * Index 05 June 2002 Expanded Table of Contents * Expanded Table of Contents * Copyright Notice o W3C Document Copyright Notice and License o W3C Software Copyright Notice and License * 1. Document Object Model HTML o 1.1. Introduction o 1.2. HTML Application of Core DOM + 1.2.1. Naming Conventions o 1.3. XHTML and the HTML DOM o 1.4. Miscellaneous Object Definitions o 1.5. Objects related to HTML documents o 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 * Appendix A: Changes o A.1. Changes between DOM Level 1 and DOM Level 2 + A.1.1. Changes to DOM Level 1 interfaces and exceptions + A.1.2. New Interfaces * Appendix B: IDL Definitions * Appendix C: Java Language Binding * Appendix D: ECMAScript Language Binding * Appendix E: Acknowledgements o E.1. Production Systems * Glossary * References o 1. Normative references o 2. Informative references * Index 05 June 2002 Copyright Notice Copyright © 2002 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-2002 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: 1. A link or URL to the original W3C document. 2. 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.) 3. 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-2002 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: 1. The full text of this NOTICE in a location viewable to users of the redistributed or derivative work. 2. 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/." 3. 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. 05 June 2002 1. Document Object Model HTML Editors: Johnny Stenback, Netscape Arnaud Le Hors, IBM Philippe Le Hégaret, W3C Chris Wilson, Microsoft Corp. (for DOM Level 1 after January 1998) Ian Jacobs, W3C (for DOM Level 1) Vidur Apparao, Netscape Communications Corp. (for DOM Level 1) Mike Champion, ArborText (for DOM Level 1) Scott Isaacs, Microsoft Corp. (for DOM Level 1 until January 1998) Table of contents * 1.1. Introduction * 1.2. HTML Application of Core DOM o 1.2.1. Naming Conventions * 1.3. XHTML and the HTML DOM * 1.4. Miscellaneous Object Definitions o HTMLDOMImplementation, HTMLCollection, HTMLOptionsCollection * 1.5. Objects related to HTML documents o HTMLDocument * 1.6. HTML Elements o 1.6.1. Property Attributes o 1.6.2. Naming Exceptions o 1.6.3. Exposing Element Type Names (tagName, (nodeName)) o 1.6.4. The HTMLElement interface + HTMLElement o 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 HTMLDocument interface, derived from the core Document interface. HTMLDocument specifies the operations and queries that can be made on a HTML document. * An HTMLElement interface, derived from the core Element interface. HTMLElement specifies the operations and queries that can be made on any HTML element. Methods on HTMLElement include those that allow for the retrieval and modification of attributes that apply to all HTML elements. * Specializations for all HTML elements that have attributes that extend beyond those specified in the HTMLElement interface. For all such attributes, the derived interface for the element contains explicit methods for setting and getting the values. The DOM Level 2 includes mechanisms to access and modify style specified through CSS and defines an event model that can be used with HTML documents. The interfaces found within this section are not mandatory. A DOM application may use the hasFeature(feature, version) method of the DOMImplementation interface with parameter values "HTML" and "2.0" (respectively) to determine whether or not this module is supported by the implementation. In addition to the feature string "HTML", the feature string "XHTML" (version string "2.0") can be used to check if the implementation supports XHTML (this is equivalent to checking the features "XML" and "HTML"). In order to fully support this module, an implementation must also support the "Core" feature defined [DOM Level 2 Core]. Please refer to additional information about conformance in the DOM Level 2 Core specification [DOM Level 2 Core]. A DOM application can use the hasFeature method of the DOMImplementation interface to determine whether they are supported or not. The feature string for all the interfaces listed in this section is "HTML" and the version is "2.0". Note that, since DOM Level 2 HTML is not backward compatible with DOM Level 1 [DOM Level 1], a DOM Level 2 HTML implementation must not claim to implement the feature "HTML" version "1.0". In order to fully support this feature, an implementation needs also to support the "Core" feature defined in the Document Object Model Level 2 Core [DOM Level 2 Core] (see also Conformance). The interfaces in this specification are designed for [HTML 4.01] documents, as well as for [XHTML 1.0] documents. 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's [DOM Level 1] were originally intended to be used only for HTML 4.01 documents [HTML 4.01] and the APIs were defined well before XHTML 1.0 [XHTML 1.0] became a specification, or was even being worked on by the HTML working group. The biggest difference between HTML 4.0 (and earlier) and XHTML 1.0 (from the DOM point of view) is that XHTML is case sensitive, whereas HTML 4.01 is case insensitive. The HTML case insensitivity is also reflected in the DOM HTML API's in some ways, for instance, element and attribute names are exposed as all upper case (for consistency) when used on an HTML document, regardless of the character case used in the markup. In XHTML everything is case sensitive (since XHTML is based on XML) and element and attribute names must be lower case in the markup. Because of this there are certain things that developers need to keep in mind when writing code that should work on both HTML and XHTML documents. There are basically two things that need to be taken into account, one is that when comparing element or attribute names to strings the string compare needs to be case insensitive, or the element or attribute name needs to be converted into lowercase before comparing against a lowercase string. The other thing is that when calling methods that are case insensitive when used on a HTML document (such as getElementsByTagName() and namedItem()) the string that is passed in should be lower case to work on both HTML and XHTML documents. 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 HTMLDOMImplementation (introduced in DOM Level 2) The HTMLDOMImplementation interface extends the DOMImplementation interface with a method for creating an HTML document instance. The core DOMImplementation interface can be used to create XHTML documents by passing the XHTML namespace as the namespace for the root element. IDL Definition // Introduced in DOM Level 2: interface HTMLDOMImplementation : DOMImplementation { HTMLDocument createHTMLDocument(in DOMString title); }; Methods createHTMLDocument Creates an HTMLDocument object with the minimal tree made of the following elements: HTML, HEAD, TITLE, and BODY. Parameters title of type DOMString The title of the document to be set as the content of the TITLE element, through a child Text node. Return Value HTMLDocument A new HTMLDocument object. No Exceptions Interface HTMLCollection An HTMLCollection is a list of nodes. An individual node may be accessed by either ordinal index or the node's name or id attributes. Note: Collections in the HTML DOM are assumed to be live meaning that they are automatically updated when the underlying document is changed. IDL Definition interface HTMLCollection { readonly attribute unsigned long length; Node item(in unsigned long index); Node namedItem(in DOMString name); }; Attributes length of type unsigned 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 index of type unsigned long The index of the node to be fetched. The index origin is 0. Return Value Node The Node at the corresponding position upon success. A value of null is returned if the index is out of range. No Exceptions namedItem This method retrieves a Node using a name. With [HTML 4.01] documents, it first searches for a Node with a matching id attribute. If it doesn't find one, it then searches for a Node with a matching name attribute, but only on those elements that are allowed a name attribute. With [XHTML 1.0] documents, this method only searches for Nodes with a matching id attribute. This method is case insensitive in HTML documents and case sensitive in XHTML documents. Parameters name of type DOMString The name of the Node to be fetched. Return Value Node The Node with a name or id attribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returns null. No Exceptions Interface HTMLOptionsCollection An HTMLOptionsCollection is a list of nodes representing HTML option element. An individual node may be accessed by either ordinal index or the node's name or id attributes. Note: Collections in the HTML DOM are assumed to be live meaning that they are automatically updated when the underlying document is changed. IDL Definition interface HTMLOptionsCollection { attribute unsigned long length; // raises(DOMException) on setting Node item(in unsigned long index); Node namedItem(in DOMString name); }; Attributes length of type unsigned long This attribute specifies the length or size of the list. Exceptions on setting DOMException NOT_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 index of type unsigned long The index of the node to be fetched. The index origin is 0. Return Value Node The Node at the corresponding position upon success. A value of null is returned if the index is out of range. No Exceptions namedItem This method retrieves a Node using a name. It first searches for a Node with a matching id attribute. If it doesn't find one, it then searches for a Node with a matching name attribute, but only on those elements that are allowed a name attribute. This method is case insensitive in HTML documents and case sensitive in XHTML documents. Parameters name of type DOMString The name of the Node to be fetched. Return Value Node The Node with a name or id attribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returns null. No Exceptions 1.5. Objects related to HTML documents Interface HTMLDocument An HTMLDocument is the root of the HTML hierarchy and holds the entire content. Besides providing access to the hierarchy, it also provides some convenience methods for accessing certain sets of information from the document. The following properties have been deprecated in favor of the corresponding ones for the BODY element: o alinkColor o background o bgColor o fgColor o linkColor o vlinkColor Note: In DOM Level 2, the method getElementById is inherited from the Document interface 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 URL of type DOMString, readonly The absolute URI [IETF RFC 2396] of the document. anchors of type HTMLCollection, readonly A collection of all the anchor (A) elements in a document with a value for the name attribute. Note: For reasons of backward compatibility, the returned set of anchors only contains those anchors created with the name attribute, not those created with the id attribute. Note that in [XHTML 1.0], the name attribute (see section 4.10) has no semantics and is only present for legacy user agents: the id attribute is used instead. Users should prefer the iterator mechanisms provided by [DOM Level 2 Traversal] instead. applets of type HTMLCollection, readonly A collection of all the OBJECT elements that include applets and APPLET (deprecated) elements in a document. body of type HTMLElement The element that contains the content for the document. In documents with BODY contents, returns the BODY element. In frameset documents, this returns the outermost FRAMESET element. cookie of type DOMString 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 cookies non-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 the cookie non-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 DOMException SYNTAX_ERR: If the new value does not adhere to the cookie syntax specified by [IETF RFC 2965]. domain of type DOMString, readonly The domain name of the server that served the document, or null if the server cannot be identified by a domain name. forms of type HTMLCollection, readonly A collection of all the forms of a document. images of type HTMLCollection, readonly A collection of all the IMG elements in a document. The behavior is limited to IMG elements for backwards compatibility. Note: As suggested by [HTML 4.01], to include images, authors may use the OBJECT element or the IMG element. Therefore, it is recommended not to use this attribute to find the images in the document but getElementsByTagName with HTML 4.01 or getElementsByTagNameNS with XHTML 1.0. links of type HTMLCollection, readonly A collection of all AREA elements and anchor (A) elements in a document with a value for the href attribute. referrer of type DOMString, 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). title of type DOMString The title of a document as specified by the TITLE element 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 name value is given by elementName. 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 elementName of type DOMString The name attribute value for an element. Return Value NodeList The 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 Abstract Schemas and 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 necessarely driven by a DTD and therefore might be produce an invalid result in the context of the document. Parameters text of type DOMString 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 necessarely driven by a DTD and therefore might be produce an invalid result in the context of the document Parameters text of type DOMString 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 is independent of the case of the attribute in the source document. The data type of the property is in general determined by the type of the attribute as determined by the HTML 4.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 lower case (independent of the case of the value in the source document). For example, if the value of the align attribute on a P element is "Left" (which is not a valid value in XHTML due to the case sensitivity of XHTML) then the value is returned as "left". For attributes with the CDATA data type, the case of the return value is that given in the source document. The return value of an attribute that is unspecified and does not have a default value is the empty string if the return type is a DOMString, false if the return type is a boolean and 0 if the return type is a number. 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 lower case for XHTML documents since the XHTML 1.0 DTDs defines element type names as lower case, 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 HTMLElement interface. These elements are as follows: o special: SUB, SUP, SPAN, BDO o font: TT, I, B, U, S, STRIKE, BIG, SMALL o phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBR o list: DD, DT o NOFRAMES, NOSCRIPT o ADDRESS, CENTER Note: The style attribute of an HTML element is accessible through the ElementCSSInlineStyle interface which is defined in the CSS module [DOM Level 2 Style Sheets and CSS]. IDL Definition interface HTMLElement : Element { attribute DOMString id; attribute DOMString title; attribute DOMString lang; attribute DOMString dir; attribute DOMString className; }; Attributes className of type DOMString 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. dir of type DOMString Specifies the base direction of directionally neutral text and the directionality of tables. See the dir attribute definition in HTML 4.01. id of type DOMString The element's identifier. See the id attribute definition in HTML 4.01. lang of type DOMString Language code defined in RFC 1766. See the lang attribute definition in HTML 4.01. title of type DOMString 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 version of type DOMString 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 profile of type DOMString URI [IETF RFC 2396] designating a metadata profile. See the profile attribute definition in HTML 4.01. Interface HTMLLinkElement The LINK element specifies a link to an external resource, and defines this document's relationship to that resource (or vice versa). See the LINK element definition in HTML 4.01 (see also the LinkStyle interface 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 charset of type DOMString The character encoding of the resource being linked to. See the charset attribute definition in HTML 4.01. disabled of type boolean Enables/disables the link. This is currently only used for style sheet links, and may be used to activate or deactivate style sheets. href of type DOMString The URI [IETF RFC 2396] of the linked resource. See the href attribute definition in HTML 4.01. hreflang of type DOMString Language code of the linked resource. See the hreflang attribute definition in HTML 4.01. media of type DOMString Designed for use with one or more target media. See the media attribute definition in HTML 4.01. rel of type DOMString Forward link type. See the rel attribute definition in HTML 4.01. rev of type DOMString Reverse link type. See the rev attribute definition in HTML 4.01. target of type DOMString Frame to render the resource in. See the target attribute definition in HTML 4.01. type of type DOMString 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 text of type DOMString 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 content of type DOMString Associated information. See the content attribute definition in HTML 4.01. httpEquiv of type DOMString HTTP response header name [IETF RFC 2616]. See the http-equiv attribute definition in HTML 4.01. name of type DOMString Meta information name. See the name attribute definition in HTML 4.01. scheme of type DOMString 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 href of type DOMString The base URI [IETF RFC 2396]. See the href attribute definition in HTML 4.01. target of type DOMString 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 form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. prompt of type DOMString 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 LinkStyle interface 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 disabled of type boolean Enables/disables the style sheet. media of type DOMString Designed for use with one or more target media. See the media attribute definition in HTML 4.01. type of type DOMString 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 aLink of type DOMString 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. background of type DOMString 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. bgColor of type DOMString Document background color. See the bgcolor attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. link of type DOMString 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. text of type DOMString Document text color. See the text attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. vLink of type DOMString 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 FORM element encompasses behavior similar to a collection and an element. It provides direct access to the contained form controls as well as the attributes of the form element. See the FORM element definition in HTML 4.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 acceptCharset of type DOMString List of character sets supported by the server. See the accept-charset attribute definition in HTML 4.01. action of type DOMString Server-side form handler. See the action attribute definition in HTML 4.01. elements of type HTMLCollection, readonly Returns a collection of all form control elements in the form. enctype of type DOMString 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. length of type long, readonly The number of form controls in the form. method of type DOMString HTTP method [IETF RFC 2616] used to submit form. See the method attribute definition in HTML 4.01. name of type DOMString Names the form. target of type DOMString Frame to render the resource in. See the target attribute definition in HTML 4.01. Methods reset Restores a form element's default values. It performs the same action as a reset button. No Parameters No Return Value No Exceptions submit Submits the form. It performs the same action as a submit button. No Parameters No Return Value No Exceptions 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; attribute unsigned long length; // raises(DOMException) on setting readonly attribute HTMLFormElement form; 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 disabled of type boolean The control is unavailable in this context. See the disabled attribute definition in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. length of type unsigned long The number of options in this SELECT. Exceptions on setting DOMException NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation. multiple of type boolean If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.01. name of type DOMString Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01. options of type HTMLOptionsCollection, readonly The collection of OPTION elements contained by this element. selectedIndex of type long 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. size of type long Number of visible rows. See the size attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. type of type DOMString, readonly The type of this form control. This is the string "select-multiple" when the multiple attribute is true and the string "select-one" when false. value of type DOMString 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 OPTION elements for this SELECT. This method is the equivalent of the appendChild method of the Node interface if the before parameter is null. It is equivalent to the insertBefore method on the parent of before in all other cases. This method may have no effect if the new element is not an OPTION or an OPTGROUP. Parameters element of type HTMLElement The element to add. before of type HTMLElement The element to insert before, or null for the tail of the list. Exceptions DOMException NOT_FOUND_ERR: Raised if before is not a descendant of the SELECT element. 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 OPTION elements for this SELECT. Does nothing if no element has the given index. Parameters index of type long 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 disabled of type boolean The control is unavailable in this context. See the disabled attribute definition in HTML 4.01. label of type DOMString 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; attribute boolean defaultSelected; readonly attribute DOMString text; readonly attribute long index; attribute boolean disabled; attribute DOMString label; attribute boolean selected; attribute DOMString value; }; Attributes defaultSelected of type boolean 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. disabled of type boolean The control is unavailable in this context. See the disabled attribute definition in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. index of type long, readonly The index of this OPTION in its parent SELECT, starting from 0. label of type DOMString Option label for use in hierarchical menus. See the label attribute definition in HTML 4.01. selected of type boolean 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. text of type DOMString, readonly The text contained within the option element. value of type DOMString 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; 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 accept of type DOMString 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. accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. align of type DOMString 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. alt of type DOMString Alternate text for user agents not rendering the normal content of this element. See the alt attribute definition in HTML 4.01. checked of type boolean When the type attribute of the element has the value "radio" or "checkbox", this represents the current state of the form control, in an interactive user agent. Changes to this attribute change the state of the form control, but do not change the value of the HTML checked attribute of the INPUT element. defaultChecked of type boolean When type has the value "radio" or "checkbox", this represents the HTML checked attribute of the element. The value of this attribute does not change if the state of the corresponding form control, in an interactive user agent, changes. See the checked attribute definition in HTML 4.01. defaultValue of type DOMString When the type attribute of the element has the value "text", "file" or "password", this represents the HTML value attribute of the element. The value of this attribute does not change if the contents of the corresponding form control, in an interactive user agent, changes. See the value attribute definition in HTML 4.01. disabled of type boolean The control is unavailable in this context. See the disabled attribute definition in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. maxLength of type long Maximum number of characters for text fields, when type has the value "text" or "password". See the maxlength attribute definition in HTML 4.01. name of type DOMString Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01. readOnly of type boolean This control is read-only. Relevant only when type has the value "text" or "password". See the readonly attribute definition in HTML 4.01. size of type unsigned long Size information. The precise meaning is specific to each type of field. See the size attribute definition in HTML 4.01. src of type DOMString When the type attribute has the value "image", this attribute specifies the location of the image to be used to decorate the graphical submit button. See the src attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. type of type DOMString, modified in DOM Level 2 The type of control created (all lower case). See the type attribute definition in HTML 4.01. useMap of type DOMString Use client-side image map. See the usemap attribute definition in HTML 4.01. value of type DOMString When the type attribute of the element has the value "text", "file" or "password", this represents the current contents of the corresponding form control, in an interactive user agent. Changing this attribute changes the contents of the form control, but does not change the value of the HTML value attribute of the element. When the type attribute of the element has the value "button", "hidden", "submit", "reset", "image", "checkbox" or "radio", this represents the HTML value attribute of the element. See the value attribute definition in HTML 4.01. Methods blur Removes keyboard focus from this element. No Parameters No Return Value No Exceptions click Simulate a mouse-click. For INPUT elements whose type attribute 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 INPUT elements whose type attribute 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 { 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 accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. cols of type long Width of control (in characters). See the cols attribute definition in HTML 4.01. defaultValue of type DOMString 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. disabled of type boolean The control is unavailable in this context. See the disabled attribute definition in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. name of type DOMString Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01. readOnly of type boolean This control is read-only. See the readonly attribute definition in HTML 4.01. rows of type long Number of text rows. See the rows attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. type of type DOMString, readonly The type of this form control. This the string "textarea". value of type DOMString 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 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 select Select the contents of the TEXTAREA. No Parameters No Return Value No Exceptions 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 accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. disabled of type boolean The control is unavailable in this context. See the disabled attribute definition in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. name of type DOMString Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. type of type DOMString, readonly The type of button (all lower case). See the type attribute definition in HTML 4.01. value of type DOMString 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 accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. htmlFor of type DOMString This attribute links this label with another form control by id attribute. 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 form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if this control is not within the context of a form. Interface HTMLLegendElement Provides a caption for a FIELDSET grouping. 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 accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. align of type DOMString Text alignment relative to FIELDSET. See the align attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. form of type HTMLFormElement, readonly Returns the FORM element containing this control. Returns null if 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 compact of type boolean Reduce spacing between list items. See the compact attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. type of type DOMString 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 compact of type boolean Reduce spacing between list items. See the compact attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. start of type long Starting sequence number. See the start attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. type of type DOMString 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 compact of type boolean 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 compact of type boolean 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 compact of type boolean 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 type of type DOMString List item bullet style. See the type attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. value of type long 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 align of type DOMString 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 align of type DOMString Horizontal text alignment. See the align attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. Interface HTMLHeadingElement For the H1 to H6 elements. See the H1 element definition in HTML 4.01. IDL Definition interface HTMLHeadingElement : HTMLElement { attribute DOMString align; }; Attributes align of type DOMString Horizontal text alignment. See the align attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. Interface HTMLQuoteElement For the Q and BLOCKQUOTE elements. See the Q element definition in HTML 4.01. IDL Definition interface HTMLQuoteElement : HTMLElement { attribute DOMString cite; }; Attributes cite of type DOMString 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 width of type long 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 clear of type DOMString 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; attribute DOMString size; }; Attributes color of type DOMString Font color. See the color attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. face of type DOMString Font face identifier. See the face attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. size of type DOMString 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 color of type DOMString Font color. See the color attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. face of type DOMString Font face identifier. See the face attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. size of type DOMString 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 align of type DOMString Align the rule on the page. See the align attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. noShade of type boolean 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. size of type DOMString The height of the rule. See the size attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. width of type DOMString 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 cite of type DOMString A URI [IETF RFC 2396] designating a document that describes the reason for the change. See the cite attribute definition in HTML 4.01. dateTime of type DOMString 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 accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. charset of type DOMString The character encoding of the linked resource. See the charset attribute definition in HTML 4.01. coords of type DOMString Comma-separated list of lengths, defining an active region geometry. See also shape for the shape of the region. See the coords attribute definition in HTML 4.01. href of type DOMString The absolute URI [IETF RFC 2396] of the linked resource. See the href attribute definition in HTML 4.01. hreflang of type DOMString Language code of the linked resource. See the hreflang attribute definition in HTML 4.01. name of type DOMString Anchor name. See the name attribute definition in HTML 4.01. rel of type DOMString Forward link type. See the rel attribute definition in HTML 4.01. rev of type DOMString Reverse link type. See the rev attribute definition in HTML 4.01. shape of type DOMString The shape of the active area. The coordinates are given by coords. See the shape attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. target of type DOMString Frame to render the resource in. See the target attribute definition in HTML 4.01. type of type DOMString Advisory content type. See the type attribute definition in HTML 4.01. Methods 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 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 long border; attribute long height; attribute long hspace; attribute boolean isMap; attribute DOMString longDesc; attribute DOMString src; attribute DOMString useMap; attribute long vspace; attribute long width; }; Attributes align of type DOMString 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. alt of type DOMString Alternate text for user agents not rendering the normal content of this element. See the alt attribute definition in HTML 4.01. border of type long Width of border around image in pixels. 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 DOMString in DOM Level 1 HTML [DOM Level 1]. height of type long Height of the image in pixels. See the height attribute definition in HTML 4.01. Note that the type of this attribute was DOMString in DOM Level 1 HTML [DOM Level 1]. hspace of type long 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 DOMString in DOM Level 1 HTML [DOM Level 1]. isMap of type boolean Use server-side image map. See the ismap attribute definition in HTML 4.01. longDesc of type DOMString URI [IETF RFC 2396] designating a long description of this image or frame. See the longdesc attribute definition in HTML 4.01. name of type DOMString The name of the element (for backwards compatibility). src of type DOMString URI [IETF RFC 2396] designating the source of this image. See the src attribute definition in HTML 4.01. useMap of type DOMString Use client-side image map. See the usemap attribute definition in HTML 4.01. vspace of type long 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]. width of type long The width of the image in pixels. See the width attribute definition in HTML 4.01. Note that the type of this attribute was DOMString in 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 { attribute DOMString code; attribute DOMString align; attribute DOMString archive; attribute DOMString border; attribute DOMString codeBase; attribute DOMString codeType; attribute DOMString data; attribute boolean declare; attribute DOMString height; attribute DOMString hspace; attribute DOMString name; attribute DOMString standby; attribute long tabIndex; attribute DOMString type; attribute DOMString useMap; attribute DOMString vspace; attribute DOMString width; // Introduced in DOM Level 2: readonly attribute Document contentDocument; }; Attributes align of type DOMString 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. archive of type DOMString Space-separated list of archives. See the archive attribute definition in HTML 4.01. border of type DOMString Width of border around the object. See the border attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. code of type DOMString Applet class file. See the code attribute for HTMLAppletElement. codeBase of type DOMString Base URI [IETF RFC 2396] for classid, data, and archive attributes. See the codebase attribute definition in HTML 4.01. codeType of type DOMString Content type for data downloaded via classid attribute. See the codetype attribute definition in HTML 4.01. contentDocument of type Document, readonly, introduced in DOM Level 2 The document this object contains, if there is any and it is available, or null otherwise. data of type DOMString A URI [IETF RFC 2396] specifying the location of the object's data. See the data attribute definition in HTML 4.01. declare of type boolean Declare (for future reference), but do not instantiate, this object. See the declare attribute definition in HTML 4.01. height of type DOMString Override height. See the height attribute definition in HTML 4.01. hspace of type DOMString Horizontal space 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. name of type DOMString Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01. standby of type DOMString Message to render while loading the object. See the standby attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. type of type DOMString Content type for data downloaded via data attribute. See the type attribute definition in HTML 4.01. useMap of type DOMString Use client-side image map. See the usemap attribute definition in HTML 4.01. vspace of type DOMString Vertical space 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. width of type DOMString Override width. See the width attribute definition in HTML 4.01. Interface HTMLParamElement Parameters fed to the OBJECT element. 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 name of type DOMString The name of a run-time parameter. See the name attribute definition in HTML 4.01. type of type DOMString Content type for the value attribute when valuetype has the value "ref". See the type attribute definition in HTML 4.01. value of type DOMString The value of a run-time parameter. See the value attribute definition in HTML 4.01. valueType of type DOMString Information about the meaning of the value attribute 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; attribute DOMString hspace; attribute DOMString name; attribute DOMString object; attribute DOMString vspace; attribute DOMString width; }; Attributes align of type DOMString 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. alt of type DOMString 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. archive of type DOMString Comma-separated archive list. See the archive attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. code of type DOMString Applet class file. See the code attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. codeBase of type DOMString 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. height of type DOMString Override height. See the height attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. hspace of type DOMString Horizontal space 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. name of type DOMString The name of the applet. See the name attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. object of type DOMString Serialized applet file. See the object attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. vspace of type DOMString Vertical space 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. width of type DOMString 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 areas of type HTMLCollection, readonly The list of areas defined for the image map. name of type DOMString 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 accessKey of type DOMString A single character access key to give access to the form control. See the accesskey attribute definition in HTML 4.01. alt of type DOMString Alternate text for user agents not rendering the normal content of this element. See the alt attribute definition in HTML 4.01. coords of type DOMString Comma-separated list of lengths, defining an active region geometry. See also shape for the shape of the region. See the coords attribute definition in HTML 4.01. href of type DOMString The URI [IETF RFC 2396] of the linked resource. See the href attribute definition in HTML 4.01. noHref of type boolean Specifies that this area is inactive, i.e., has no associated action. See the nohref attribute definition in HTML 4.01. shape of type DOMString The shape of the active area. The coordinates are given by coords. See the shape attribute definition in HTML 4.01. tabIndex of type long Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01. target of type DOMString 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 charset of type DOMString The character encoding of the linked resource. See the charset attribute definition in HTML 4.01. defer of type boolean Indicates that the user agent can defer processing of the script. See the defer attribute definition in HTML 4.01. event of type DOMString Reserved for future use. htmlFor of type DOMString Reserved for future use. src of type DOMString URI [IETF RFC 2396] designating an external script. See the src attribute definition in HTML 4.01. text of type DOMString The script content of the element. type of type DOMString 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, and TFOOT elements may exist in a table. Therefore, if one exists, and the createTHead() or createTFoot() method is called, the method returns the existing THead or TFoot element. See the TABLE element definition in HTML 4.01. IDL Definition interface HTMLTableElement : HTMLElement { attribute HTMLTableCaptionElement caption; // raises(DOMException) on setting attribute HTMLTableSectionElement tHead; // raises(DOMException) on setting 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(); HTMLElement insertRow(in long index) raises(DOMException); void deleteRow(in long index) raises(DOMException); }; Attributes align of type DOMString 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. bgColor of type DOMString Cell background color. See the bgcolor attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. border of type DOMString The width of the border around the table. See the border attribute definition in HTML 4.01. caption of type HTMLTableCaptionElement Returns the table's CAPTION, or void if none exists. Exceptions on setting DOMException HIERARCHY_REQUEST_ERR: if the element is not a CAPTION. cellPadding of type DOMString Specifies the horizontal and vertical space between cell content and cell borders. See the cellpadding attribute definition in HTML 4.01. cellSpacing of type DOMString Specifies the horizontal and vertical separation between cells. See the cellspacing attribute definition in HTML 4.01. frame of type DOMString Specifies which external table borders to render. See the frame attribute definition in HTML 4.01. rows of type HTMLCollection, readonly Returns a collection of all the rows in the table, including all in THEAD, TFOOT, all TBODY elements. rules of type DOMString Specifies which internal table borders to render. See the rules attribute definition in HTML 4.01. summary of type DOMString Description about the purpose or structure of a table. See the summary attribute definition in HTML 4.01. tBodies of type HTMLCollection, readonly Returns a collection of the defined table bodies. tFoot of type HTMLTableSectionElement Returns the table's TFOOT, or null if none exists. Exceptions on setting DOMException HIERARCHY_REQUEST_ERR: if the element is not a TFOOT. tHead of type HTMLTableSectionElement Returns the table's THEAD, or null if none exists. Exceptions on setting DOMException HIERARCHY_REQUEST_ERR: if the element is not a THEAD. width of type DOMString 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 HTMLElement A CAPTION element. No Parameters No Exceptions createTFoot Create a table footer row or return an existing one. Return Value HTMLElement A footer element (TFOOT). No Parameters No Exceptions createTHead Create a table header row or return an existing one. Return Value HTMLElement 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 deleteRow Delete a table row. Parameters index of type long The index of the row to be deleted. This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage. Exceptions DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative. 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 insertRow 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. If index is equal to the number of rows, the new row is appended. In addition, when the table is empty the row is inserted into a TBODY which is created and inserted into the table. Note: A table row cannot be empty according to [HTML 4.01]. Parameters index of type long The row number where to insert a new row. This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage. Return Value HTMLElement The newly created row. Exceptions DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows or if the index is negative. Interface HTMLTableCaptionElement Table caption See the CAPTION element definition in HTML 4.01. IDL Definition interface HTMLTableCaptionElement : HTMLElement { attribute DOMString align; }; Attributes align of type DOMString 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 COL and COLGROUP elements. 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 align of type DOMString Horizontal alignment of cell data in column. See the align attribute definition in HTML 4.01. ch of type DOMString Alignment character for cells in a column. See the char attribute definition in HTML 4.01. chOff of type DOMString Offset of alignment character. See the charoff attribute definition in HTML 4.01. span of type long Indicates the number of columns in a group or affected by a grouping. See the span attribute definition in HTML 4.01. vAlign of type DOMString Vertical alignment of cell data in column. See the valign attribute definition in HTML 4.01. width of type DOMString Default column width. See the width attribute definition in HTML 4.01. Interface HTMLTableSectionElement The THEAD, TFOOT, and TBODY elements. IDL Definition interface HTMLTableSectionElement : HTMLElement { attribute DOMString align; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; readonly attribute HTMLCollection rows; HTMLElement insertRow(in long index) raises(DOMException); void deleteRow(in long index) raises(DOMException); }; Attributes align of type DOMString Horizontal alignment of data in cells. See the align attribute for HTMLTheadElement for details. ch of type DOMString Alignment character for cells in a column. See the char attribute definition in HTML 4.01. chOff of type DOMString Offset of alignment character. See the charoff attribute definition in HTML 4.01. rows of type HTMLCollection, readonly The collection of rows in this table section. vAlign of type DOMString Vertical alignment of data in cells. See the valign attribute for HTMLTheadElement for details. Methods deleteRow Delete a row from this section. Parameters index of type long The index of the row to be deleted. This index starts from 0 and is relative only to the rows contained inside this section, not all the rows in the table. Exceptions DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative. No Return Value insertRow Insert a row into this section. The new row is inserted immediately before the current indexth row in this section. If index is equal to the number of rows in this section, the new row is appended. Parameters index of type long 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 HTMLElement The newly created row. Exceptions DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows of if the index is negative. Interface HTMLTableRowElement A row in a table. See the TR element definition in HTML 4.01. IDL Definition interface HTMLTableRowElement : HTMLElement { readonly attribute long rowIndex; readonly attribute long sectionRowIndex; readonly attribute HTMLCollection cells; attribute DOMString align; attribute DOMString bgColor; attribute DOMString ch; attribute DOMString chOff; attribute DOMString vAlign; HTMLElement insertCell(in long index) raises(DOMException); void deleteCell(in long index) raises(DOMException); }; Attributes align of type DOMString Horizontal alignment of data within cells of this row. See the align attribute definition in HTML 4.01. bgColor of type DOMString Background color for rows. See the bgcolor attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. cells of type HTMLCollection, readonly The collection of cells in this row. ch of type DOMString Alignment character for cells in a column. See the char attribute definition in HTML 4.01. chOff of type DOMString Offset of alignment character. See the charoff attribute definition in HTML 4.01. rowIndex of type long, readonly The index of this row, relative to the entire table, starting from 0. This is in document tree order and not display order. The rowIndex does not take into account sections (THEAD, TFOOT, or TBODY) within the table. sectionRowIndex of type long, readonly The index of this row, relative to the current section (THEAD, TFOOT, or TBODY), starting from 0. vAlign of type DOMString Vertical alignment of data within cells of this row. See the valign attribute definition in HTML 4.01. Methods deleteCell Delete a cell from the current row. Parameters index of type long The index of the cell to delete, starting from 0. Exceptions DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of cells or if the index is negative. No Return Value insertCell Insert an empty TD cell into this row. If index is equal to the number of cells, the new cell is appended. Parameters index of type long The place to insert the cell, starting from 0. Return Value HTMLElement The newly created cell. Exceptions DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than the number of cells or if the index is negative. Interface HTMLTableCellElement The object used to represent the TH and TD elements. 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 abbr of type DOMString Abbreviation for header cells. See the abbr attribute definition in HTML 4.01. align of type DOMString Horizontal alignment of data in cell. See the align attribute definition in HTML 4.01. axis of type DOMString Names group of related headers. See the axis attribute definition in HTML 4.01. bgColor of type DOMString Cell background color. See the bgcolor attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. cellIndex of type long, readonly The index of this cell in the row, starting from 0. This index is in document tree order and not display order. ch of type DOMString Alignment character for cells in a column. See the char attribute definition in HTML 4.01. chOff of type DOMString Offset of alignment character. See the charoff attribute definition in HTML 4.01. colSpan of type long Number of columns spanned by cell. See the colspan attribute definition in HTML 4.01. headers of type DOMString List of id attribute values for header cells. See the headers attribute definition in HTML 4.01. height of type DOMString Cell height. See the height attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. noWrap of type boolean Suppress word wrapping. See the nowrap attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01. rowSpan of type long Number of rows spanned by cell. See the rowspan attribute definition in HTML 4.01. scope of type DOMString Scope covered by header cells. See the scope attribute definition in HTML 4.01. vAlign of type DOMString Vertical alignment of data in cell. See the valign attribute definition in HTML 4.01. width of type DOMString 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 cols of type DOMString The number of columns of frames in the frameset. See the cols attribute definition in HTML 4.01. rows of type DOMString 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 contentDocument of type Document, readonly, introduced in DOM Level 2 The document this frame contains, if there is any and it is available, or null otherwise. frameBorder of type DOMString Request frame borders. See the frameborder attribute definition in HTML 4.01. longDesc of type DOMString URI [IETF RFC 2396] designating a long description of this image or frame. See the longdesc attribute definition in HTML 4.01. marginHeight of type DOMString Frame margin height, in pixels. See the marginheight attribute definition in HTML 4.01. marginWidth of type DOMString Frame margin width, in pixels. See the marginwidth attribute definition in HTML 4.01. name of type DOMString The frame name (object of the target attribute). See the name attribute definition in HTML 4.01. noResize of type boolean When true, forbid user from resizing frame. See the noresize attribute definition in HTML 4.01. scrolling of type DOMString Specify whether or not the frame should have scrollbars. See the scrolling attribute definition in HTML 4.01. src of type DOMString 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 align of type DOMString 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. contentDocument of type Document, readonly, introduced in DOM Level 2 The document this frame contains, if there is any and it is available, or null otherwise. frameBorder of type DOMString Request frame borders. See the frameborder attribute definition in HTML 4.01. height of type DOMString Frame height. See the height attribute definition in HTML 4.01. longDesc of type DOMString URI [IETF RFC 2396] designating a long description of this image or frame. See the longdesc attribute definition in HTML 4.01. marginHeight of type DOMString Frame margin height, in pixels. See the marginheight attribute definition in HTML 4.01. marginWidth of type DOMString Frame marg