From 1d6cda7c464b289c9672d0698f82e1671e0211df Mon Sep 17 00:00:00 2001 From: jkesselm Date: Fri, 4 Jan 2002 20:20:52 +0000 Subject: [PATCH] Updating the W3C DOM documentation. 1) Added HTML Level 1. Xerces apparently wants this, and there's certainly no reason not to have it in xml-commons. 2) Fixed the generated @param comments. The DOM WG's stylesheet for producing Javadoc from their abstract XML markup had a glitch, and did not reliably produce a space between the parameter name and its description. I've submitted that as an erratum, to make sure they fix it. Meanwhile, I've gone through and fixed them all manually. (Not everything could be fixed by simply replacing "The" with " The"; some descriptions start with other words.) I'm an ex-member of the DOM WG, and still on the IG, so feel free to blame me for the fact that this wasn't caught before the DOM shipped ... and for making the change. The fact that these files are no longer byte-for-byte identical with those supplied by the W3C will annoy some folks, but I think it's fairly safe to assume that the DOM WG will accept the erratum. And we definitely want to fix it here rather than having each Apache project patch their own copy. git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@225942 13f79535-47bb-0310-9956-ffa450edef68 --- java/external/src/org/w3c/dom/Attr.java | 31 +-- .../src/org/w3c/dom/CDATASection.java | 4 +- .../src/org/w3c/dom/CharacterData.java | 15 -- .../src/org/w3c/dom/DOMException.java | 4 +- .../src/org/w3c/dom/DOMImplementation.java | 34 ++- java/external/src/org/w3c/dom/Document.java | 121 +++-------- .../src/org/w3c/dom/DocumentType.java | 9 +- java/external/src/org/w3c/dom/Element.java | 48 ++--- java/external/src/org/w3c/dom/Entity.java | 2 +- .../src/org/w3c/dom/NamedNodeMap.java | 28 +-- java/external/src/org/w3c/dom/Node.java | 176 ++-------------- java/external/src/org/w3c/dom/NodeList.java | 2 +- .../org/w3c/dom/ProcessingInstruction.java | 7 - .../src/org/w3c/dom/css/CSSRuleList.java | 2 +- .../src/org/w3c/dom/css/CSSValueList.java | 2 +- .../src/org/w3c/dom/events/DocumentEvent.java | 2 +- .../src/org/w3c/dom/events/Event.java | 6 +- .../src/org/w3c/dom/events/EventTarget.java | 14 +- .../src/org/w3c/dom/events/MouseEvent.java | 30 +-- .../src/org/w3c/dom/events/MutationEvent.java | 16 +- .../src/org/w3c/dom/events/UIEvent.java | 10 +- .../org/w3c/dom/html/HTMLAnchorElement.java | 111 ++++++++++ .../org/w3c/dom/html/HTMLAppletElement.java | 102 +++++++++ .../src/org/w3c/dom/html/HTMLAreaElement.java | 78 +++++++ .../src/org/w3c/dom/html/HTMLBRElement.java | 27 +++ .../src/org/w3c/dom/html/HTMLBaseElement.java | 33 +++ .../org/w3c/dom/html/HTMLBaseFontElement.java | 42 ++++ .../src/org/w3c/dom/html/HTMLBodyElement.java | 67 ++++++ .../org/w3c/dom/html/HTMLButtonElement.java | 67 ++++++ .../src/org/w3c/dom/html/HTMLCollection.java | 55 +++++ .../org/w3c/dom/html/HTMLDListElement.java | 27 +++ .../w3c/dom/html/HTMLDirectoryElement.java | 28 +++ .../src/org/w3c/dom/html/HTMLDivElement.java | 27 +++ .../src/org/w3c/dom/html/HTMLDocument.java | 162 ++++++++++++++ .../src/org/w3c/dom/html/HTMLElement.java | 65 ++++++ .../org/w3c/dom/html/HTMLFieldSetElement.java | 28 +++ .../src/org/w3c/dom/html/HTMLFontElement.java | 42 ++++ .../src/org/w3c/dom/html/HTMLFormElement.java | 86 ++++++++ .../org/w3c/dom/html/HTMLFrameElement.java | 76 +++++++ .../org/w3c/dom/html/HTMLFrameSetElement.java | 34 +++ .../src/org/w3c/dom/html/HTMLHRElement.java | 49 +++++ .../src/org/w3c/dom/html/HTMLHeadElement.java | 27 +++ .../org/w3c/dom/html/HTMLHeadingElement.java | 28 +++ .../src/org/w3c/dom/html/HTMLHtmlElement.java | 27 +++ .../org/w3c/dom/html/HTMLIFrameElement.java | 89 ++++++++ .../org/w3c/dom/html/HTMLImageElement.java | 109 ++++++++++ .../org/w3c/dom/html/HTMLInputElement.java | 198 ++++++++++++++++++ .../org/w3c/dom/html/HTMLIsIndexElement.java | 35 ++++ .../src/org/w3c/dom/html/HTMLLIElement.java | 35 ++++ .../org/w3c/dom/html/HTMLLabelElement.java | 42 ++++ .../org/w3c/dom/html/HTMLLegendElement.java | 43 ++++ .../src/org/w3c/dom/html/HTMLLinkElement.java | 82 ++++++++ .../src/org/w3c/dom/html/HTMLMapElement.java | 32 +++ .../src/org/w3c/dom/html/HTMLMenuElement.java | 28 +++ .../src/org/w3c/dom/html/HTMLMetaElement.java | 47 +++++ .../src/org/w3c/dom/html/HTMLModElement.java | 35 ++++ .../org/w3c/dom/html/HTMLOListElement.java | 41 ++++ .../org/w3c/dom/html/HTMLObjectElement.java | 151 +++++++++++++ .../org/w3c/dom/html/HTMLOptGroupElement.java | 35 ++++ .../org/w3c/dom/html/HTMLOptionElement.java | 78 +++++++ .../w3c/dom/html/HTMLParagraphElement.java | 27 +++ .../org/w3c/dom/html/HTMLParamElement.java | 50 +++++ .../src/org/w3c/dom/html/HTMLPreElement.java | 27 +++ .../org/w3c/dom/html/HTMLQuoteElement.java | 28 +++ .../org/w3c/dom/html/HTMLScriptElement.java | 66 ++++++ .../org/w3c/dom/html/HTMLSelectElement.java | 130 ++++++++++++ .../org/w3c/dom/html/HTMLStyleElement.java | 42 ++++ .../w3c/dom/html/HTMLTableCaptionElement.java | 27 +++ .../w3c/dom/html/HTMLTableCellElement.java | 125 +++++++++++ .../org/w3c/dom/html/HTMLTableColElement.java | 62 ++++++ .../org/w3c/dom/html/HTMLTableElement.java | 187 +++++++++++++++++ .../org/w3c/dom/html/HTMLTableRowElement.java | 101 +++++++++ .../w3c/dom/html/HTMLTableSectionElement.java | 84 ++++++++ .../org/w3c/dom/html/HTMLTextAreaElement.java | 114 ++++++++++ .../org/w3c/dom/html/HTMLTitleElement.java | 26 +++ .../org/w3c/dom/html/HTMLUListElement.java | 34 +++ .../src/org/w3c/dom/ranges/Range.java | 30 +-- .../org/w3c/dom/stylesheets/MediaList.java | 4 +- .../w3c/dom/stylesheets/StyleSheetList.java | 2 +- .../w3c/dom/traversal/DocumentTraversal.java | 16 +- .../src/org/w3c/dom/traversal/NodeFilter.java | 2 +- 81 files changed, 3665 insertions(+), 450 deletions(-) create mode 100644 java/external/src/org/w3c/dom/html/HTMLAnchorElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLAppletElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLAreaElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLBRElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLBaseElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLBaseFontElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLBodyElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLButtonElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLCollection.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLDListElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLDirectoryElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLDivElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLDocument.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLFieldSetElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLFontElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLFormElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLFrameElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLFrameSetElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLHRElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLHeadElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLHeadingElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLHtmlElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLIFrameElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLImageElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLInputElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLIsIndexElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLLIElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLLabelElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLLegendElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLLinkElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLMapElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLMenuElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLMetaElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLModElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLOListElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLObjectElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLOptGroupElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLOptionElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLParagraphElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLParamElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLPreElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLQuoteElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLScriptElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLSelectElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLStyleElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTableCaptionElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTableCellElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTableColElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTableElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTableRowElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTableSectionElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTextAreaElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLTitleElement.java create mode 100644 java/external/src/org/w3c/dom/html/HTMLUListElement.java diff --git a/java/external/src/org/w3c/dom/Attr.java b/java/external/src/org/w3c/dom/Attr.java index 4ba62e2..05b0c12 100644 --- a/java/external/src/org/w3c/dom/Attr.java +++ b/java/external/src/org/w3c/dom/Attr.java @@ -13,7 +13,7 @@ package org.w3c.dom; /** - * The Attr interface represents an attribute in an + * The Attr interface represents an attribute in an * Element object. Typically the allowable values for the * attribute are defined in a document type definition. *

Attr objects inherit the Node interface, but @@ -33,7 +33,7 @@ package org.w3c.dom; * DOM need to be aware that Attr nodes have some things in * common with other objects inheriting the Node interface, but * they also are quite distinct. - *

The attribute's effective value is determined as follows: if this + *

The attribute's effective value is determined as follows: if this * attribute has been explicitly assigned any value, that value is the * attribute's effective value; otherwise, if there is a declaration for * this attribute, and that declaration includes a default value, then that @@ -41,19 +41,19 @@ package org.w3c.dom; * attribute does not exist on this element in the structure model until it * has been explicitly added. Note that the nodeValue attribute * on the Attr instance can also be used to retrieve the string - * version of the attribute's value(s). + * version of the attribute's value(s). *

In XML, where the value of an attribute can contain entity references, * the child nodes of the Attr node may be either * Text or EntityReference nodes (when these are * in use; see the description of EntityReference for * discussion). Because the DOM Core is not aware of attribute types, it * treats all attribute values as simple strings, even if the DTD or schema - * declares them as having tokenized types. + * declares them as having tokenized types. *

See also the Document Object Model (DOM) Level 2 Core Specification. */ public interface Attr extends Node { /** - * Returns the name of this attribute. + * Returns the name of this attribute. */ public String getName(); @@ -69,14 +69,14 @@ public interface Attr extends Node { * implementation will then make a new attribute available with * specified set to false and the default * value (if one exists). - *
In summary: If the attribute has an assigned value in the document + *
In summary: If the attribute has an assigned value in the document * then specified is true, and the value is - * the assigned value.If the attribute has no assigned value in the + * the assigned value. If the attribute has no assigned value in the * document and has a default value in the DTD, then * specified is false, and the value is the - * default value in the DTD.If the attribute has no assigned value in + * default value in the DTD. If the attribute has no assigned value in * the document and has a value of #IMPLIED in the DTD, then the - * attribute does not appear in the structure model of the document.If + * attribute does not appear in the structure model of the document. If * the ownerElement attribute is null (i.e. * because it was just created or was set to null by the * various removal and cloning operations) specified is @@ -98,19 +98,6 @@ public interface Attr extends Node { * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. */ public String getValue(); - /** - * On retrieval, the value of the attribute is returned as a string. - * Character and general entity references are replaced with their - * values. See also the method getAttribute on the - * Element interface. - *
On setting, this creates a Text node with the unparsed - * contents of the string. I.e. any characters that an XML processor - * would recognize as markup are instead treated as literal text. See - * also the method setAttribute on the Element - * interface. - * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. - */ public void setValue(String value) throws DOMException; diff --git a/java/external/src/org/w3c/dom/CDATASection.java b/java/external/src/org/w3c/dom/CDATASection.java index f3aea8a..9e74734 100644 --- a/java/external/src/org/w3c/dom/CDATASection.java +++ b/java/external/src/org/w3c/dom/CDATASection.java @@ -24,8 +24,8 @@ package org.w3c.dom; * contain characters that need to be escaped outside of CDATA sections and * that, depending on the character encoding ("charset") chosen for * serialization, it may be impossible to write out some characters as part - * of a CDATA section. - *

The CDATASection interface inherits from the + * of a CDATA section. + *

The CDATASection interface inherits from the * CharacterData interface through the Text * interface. Adjacent CDATASection nodes are not merged by use * of the normalize method of the Node interface. diff --git a/java/external/src/org/w3c/dom/CharacterData.java b/java/external/src/org/w3c/dom/CharacterData.java index c067120..d4a36cc 100644 --- a/java/external/src/org/w3c/dom/CharacterData.java +++ b/java/external/src/org/w3c/dom/CharacterData.java @@ -44,21 +44,6 @@ public interface CharacterData extends Node { */ public String getData() throws DOMException; - /** - * The character data of the node that implements this interface. The DOM - * implementation may not put arbitrary limits on the amount of data - * that may be stored in a CharacterData node. However, - * implementation limits may mean that the entirety of a node's data may - * not fit into a single DOMString. In such cases, the user - * may call substringData to retrieve the data in - * appropriately sized pieces. - * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. - * @exception DOMException - * DOMSTRING_SIZE_ERR: Raised when it would return more characters than - * fit in a DOMString variable on the implementation - * platform. - */ public void setData(String data) throws DOMException; diff --git a/java/external/src/org/w3c/dom/DOMException.java b/java/external/src/org/w3c/dom/DOMException.java index 16866ce..098c6c5 100644 --- a/java/external/src/org/w3c/dom/DOMException.java +++ b/java/external/src/org/w3c/dom/DOMException.java @@ -18,10 +18,10 @@ package org.w3c.dom; * because data is lost, or because the implementation has become unstable). * In general, DOM methods return specific error values in ordinary * processing situations, such as out-of-bound errors when using - * NodeList. + * NodeList. *

Implementations should raise other exceptions under other circumstances. * For example, implementations should raise an implementation-dependent - * exception if a null argument is passed. + * exception if a null argument is passed. *

Some languages and object systems do not support the concept of * exceptions. For such systems, error conditions may be indicated using * native error reporting mechanisms. For some bindings, for example, diff --git a/java/external/src/org/w3c/dom/DOMImplementation.java b/java/external/src/org/w3c/dom/DOMImplementation.java index 6e9a554..5defc8e 100644 --- a/java/external/src/org/w3c/dom/DOMImplementation.java +++ b/java/external/src/org/w3c/dom/DOMImplementation.java @@ -26,7 +26,11 @@ public interface DOMImplementation { * specifications and listed in the section. The name must be an XML * name. To avoid possible conflicts, as a convention, names referring * to features defined outside the DOM specification should be made - * unique. + * unique by reversing the name of the Internet domain name of the + * person (or the organization that the person belongs to) who defines + * the feature, component by component, and using this as a prefix. + * For instance, the W3C SVG Working Group defines the feature + * "org.w3c.dom.svg". * @param version This is the version number of the feature to test. In * Level 2, the string can be either "2.0" or "1.0". If the version is * not specified, supporting any version of the feature causes the @@ -43,8 +47,9 @@ public interface DOMImplementation { * default attribute additions do not occur. It is expected that a * future version of the DOM will provide a way for populating a * DocumentType. + *
HTML-only DOM implementations do not need to implement this method. * @param qualifiedName The qualified name of the document type to be - * created. + * created. * @param publicId The external subset public identifier. * @param systemId The external subset system identifier. * @return A new DocumentType node with @@ -54,12 +59,6 @@ public interface DOMImplementation { * contains an illegal character. *
NAMESPACE_ERR: Raised if the qualifiedName is * malformed. - *
NOT_SUPPORTED_ERR: May be raised by DOM implementations which do - * not support the "XML" feature, if they choose not to - * support this method. Other features introduced in the future, by - * the DOM WG or in extensions defined by other groups, may also - * demand support for this method; please consult the definition of - * the feature to see if it requires this method. * @since DOM Level 2 */ public DocumentType createDocumentType(String qualifiedName, @@ -68,10 +67,10 @@ public interface DOMImplementation { throws DOMException; /** - * Creates a DOM Document object of the specified type with its document - * element. - * @param namespaceURI The namespace URI of the document element to - * create. + * Creates an XML Document object of the specified type with + * its document element. HTML-only DOM implementations do not need to + * implement this method. + * @param namespaceURI The namespace URI of the document element to create. * @param qualifiedName The qualified name of the document element to be * created. * @param doctype The type of document to be created or null. @@ -87,19 +86,10 @@ public interface DOMImplementation { * namespaceURI is null, or if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " - * http://www.w3.org/XML/1998/namespace" , or if the DOM - * implementation does not support the "XML" feature but - * a non-null namespace URI was provided, since namespaces were - * defined by XML. + * http://www.w3.org/XML/1998/namespace" . *
WRONG_DOCUMENT_ERR: Raised if doctype has already * been used with a different document or was created from a different * implementation. - *
NOT_SUPPORTED_ERR: May be raised by DOM implementations which do - * not support the "XML" feature, if they choose not to support this - * method. Other features introduced in the future, by the DOM WG or - * in extensions defined by other groups, may also demand support for - * this method; please consult the definition of the feature to see if - * it requires this method. * @since DOM Level 2 */ public Document createDocument(String namespaceURI, diff --git a/java/external/src/org/w3c/dom/Document.java b/java/external/src/org/w3c/dom/Document.java index 79214e0..320dbb7 100644 --- a/java/external/src/org/w3c/dom/Document.java +++ b/java/external/src/org/w3c/dom/Document.java @@ -62,7 +62,7 @@ public interface Document extends Node { * @param tagName The name of the element type to instantiate. For XML, * this is case-sensitive. For HTML, the tagName * parameter may be provided in any case, but it must be mapped to the - * canonical uppercase form by the DOM implementation. + * canonical uppercase form by the DOM implementation. * @return A new Element object with the * nodeName attribute set to tagName, and * localName, prefix, and @@ -75,7 +75,7 @@ public interface Document extends Node { throws DOMException; /** - * Creates an empty DocumentFragment object. + * Creates an empty DocumentFragment object. * @return A new DocumentFragment. */ public DocumentFragment createDocumentFragment(); @@ -148,7 +148,7 @@ public interface Document extends Node { * node is also unbound; (its namespaceURI is * null). The DOM Level 2 does not support any mechanism to * resolve namespace prefixes. - * @param name The name of the entity to reference. + * @param name The name of the entity to reference. * @return The new EntityReference object. * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified name contains an @@ -161,7 +161,7 @@ public interface Document extends Node { /** * Returns a NodeList of all the Elements with a * given tag name in the order in which they are encountered in a - * preorder traversal of the Document tree. + * preorder traversal of the Document tree. * @param tagname The name of the tag to match on. The special value "*" * matches all tags. * @return A new NodeList object containing all the matched @@ -255,7 +255,7 @@ public interface Document extends Node { * types of nodes inheriting from CharacterData copy their * data and length attributes from those of * the source node. - * + * * @param importedNode The node to import. * @param deep If true, recursively import the subtree under * the specified node; if false, import only the node @@ -272,57 +272,28 @@ public interface Document extends Node { throws DOMException; /** - * Creates an element of the given qualified name and namespace URI. + * Creates an element of the given qualified name and namespace URI. + * HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the element to create. * @param qualifiedName The qualified name of the element type to * instantiate. * @return A new Element object with the following - * attributes: - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
AttributeValue
Node.nodeName - * qualifiedName
Node.namespaceURI - * namespaceURI
Node.prefixprefix, extracted + * attributes:AttributeValueNode.nodeName + * qualifiedNameNode.namespaceURI + * namespaceURINode.prefixprefix, extracted * from qualifiedName, or null if there is - * no prefix
Node.localNamelocal name, extracted from - * qualifiedName
Element.tagName - * qualifiedName
+ * no prefixNode.localNamelocal name, extracted from + * qualifiedNameElement.tagName + * qualifiedName * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified qualified name - * contains an illegal character, per the XML 1.0 specification . + * contains an illegal character. *
NAMESPACE_ERR: Raised if the qualifiedName is - * malformed per the Namespaces in XML specification, if the - * qualifiedName has a prefix and the + * malformed, if the qualifiedName has a prefix and the * namespaceURI is null, or if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " * http://www.w3.org/XML/1998/namespace" . - *
NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the "XML" feature, since namespaces were - * defined by XML. * @since DOM Level 2 */ public Element createElementNS(String namespaceURI, @@ -330,65 +301,31 @@ public interface Document extends Node { throws DOMException; /** - * Creates an attribute of the given qualified name and namespace URI. + * Creates an attribute of the given qualified name and namespace URI. + * HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the attribute to create. - * @param qualifiedName The qualified name of the attribute to - * instantiate. + * @param qualifiedName The qualified name of the attribute to instantiate. * @return A new Attr object with the following attributes: - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
- * AttributeValue
Node.nodeNamequalifiedName
- * Node.namespaceURInamespaceURI
- * Node.prefixprefix, extracted from + * AttributeValueNode.nodeNamequalifiedName + * Node.namespaceURInamespaceURI + * Node.prefixprefix, extracted from * qualifiedName, or null if there is no - * prefix
Node.localNamelocal name, extracted from - * qualifiedName
Attr.name - * qualifiedName
Node.nodeValuethe empty - * string
+ * prefixNode.localNamelocal name, extracted from + * qualifiedNameAttr.name + * qualifiedNameNode.nodeValuethe empty + * string * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified qualified name - * contains an illegal character, per the XML 1.0 specification . + * contains an illegal character. *
NAMESPACE_ERR: Raised if the qualifiedName is - * malformed per the Namespaces in XML specification, if the - * qualifiedName has a prefix and the + * malformed, if the qualifiedName has a prefix and the * namespaceURI is null, if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " * http://www.w3.org/XML/1998/namespace", or if the - * qualifiedName, or its prefix, is "xmlns" and the + * qualifiedName is "xmlns" and the * namespaceURI is different from " * http://www.w3.org/2000/xmlns/". - *
NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the "XML" feature, since namespaces were - * defined by XML. * @since DOM Level 2 */ public Attr createAttributeNS(String namespaceURI, @@ -418,7 +355,7 @@ public interface Document extends Node { * information that says which attributes are of type ID. Attributes * with the name "ID" are not of type ID unless so defined. * Implementations that do not know whether attributes are of type ID or - * not are expected to return null. + * not are expected to return null. * @param elementId The unique id value for an element. * @return The matching element. * @since DOM Level 2 diff --git a/java/external/src/org/w3c/dom/DocumentType.java b/java/external/src/org/w3c/dom/DocumentType.java index 86c312b..b5537cb 100644 --- a/java/external/src/org/w3c/dom/DocumentType.java +++ b/java/external/src/org/w3c/dom/DocumentType.java @@ -68,11 +68,10 @@ public interface DocumentType extends Node { public String getSystemId(); /** - * The internal subset as a string, or null if there is none. - * This is does not contain the delimiting square brackets.The actual - * content returned depends on how much information is available to the - * implementation. This may vary depending on various parameters, - * including the XML processor used to build the document. + * The internal subset as a string. The actual content returned depends on + * how much information is available to the implementation. This may + * vary depending on various parameters, including the XML processor + * used to build the document. * @since DOM Level 2 */ public String getInternalSubset(); diff --git a/java/external/src/org/w3c/dom/Element.java b/java/external/src/org/w3c/dom/Element.java index 614ca87..b2a7123 100644 --- a/java/external/src/org/w3c/dom/Element.java +++ b/java/external/src/org/w3c/dom/Element.java @@ -39,7 +39,7 @@ public interface Element extends Node { * case-preserving in XML, as are all of the operations of the DOM. The * HTML DOM returns the tagName of an HTML element in the * canonical uppercase form, regardless of the case in the source HTML - * document. + * document. */ public String getTagName(); @@ -151,11 +151,8 @@ public interface Element extends Node { public NodeList getElementsByTagName(String name); /** - * Retrieves an attribute value by local name and namespace URI. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + * Retrieves an attribute value by local name and namespace URI. HTML-only + * DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the attribute to retrieve. * @param localName The local name of the attribute to retrieve. * @return The Attr value as a string, or the empty string @@ -180,6 +177,7 @@ public interface Element extends Node { * and use setAttributeNodeNS or * setAttributeNode to assign it as the value of an * attribute. + *
HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the attribute to create or * alter. * @param qualifiedName The qualified name of the attribute to create or @@ -187,21 +185,17 @@ public interface Element extends Node { * @param value The value to set in string form. * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified qualified name - * contains an illegal character, per the XML 1.0 specification . + * contains an illegal character. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. *
NAMESPACE_ERR: Raised if the qualifiedName is - * malformed per the Namespaces in XML specification, if the - * qualifiedName has a prefix and the + * malformed, if the qualifiedName has a prefix and the * namespaceURI is null, if the * qualifiedName has a prefix that is "xml" and the * namespaceURI is different from " * http://www.w3.org/XML/1998/namespace", or if the - * qualifiedName, or its prefix, is "xmlns" and the + * qualifiedName is "xmlns" and the * namespaceURI is different from " * http://www.w3.org/2000/xmlns/". - *
NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the "XML" feature, since namespaces were - * defined by XML. * @since DOM Level 2 */ public void setAttributeNS(String namespaceURI, @@ -214,10 +208,7 @@ public interface Element extends Node { * attribute has a default value it is immediately replaced. The * replacing attribute has the same namespace URI and local name, as * well as the original prefix. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + *
HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the attribute to remove. * @param localName The local name of the attribute to remove. * @exception DOMException @@ -229,11 +220,8 @@ public interface Element extends Node { throws DOMException; /** - * Retrieves an Attr node by local name and namespace URI. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + * Retrieves an Attr node by local name and namespace URI. + * HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the attribute to retrieve. * @param localName The local name of the attribute to retrieve. * @return The Attr node with the specified attribute local @@ -248,6 +236,7 @@ public interface Element extends Node { * Adds a new attribute. If an attribute with that local name and that * namespace URI is already present in the element, it is replaced by * the new one. + *
HTML-only DOM implementations do not need to implement this method. * @param newAttr The Attr node to add to the attribute list. * @return If the newAttr attribute replaces an existing * attribute with the same local name and namespace URI, the replaced @@ -261,9 +250,6 @@ public interface Element extends Node { * attribute of another Element object. The DOM user must * explicitly clone Attr nodes to re-use them in other * elements. - *
NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the "XML" feature, since namespaces were - * defined by XML. * @since DOM Level 2 */ public Attr setAttributeNodeNS(Attr newAttr) @@ -274,10 +260,7 @@ public interface Element extends Node { * Elements with a given local name and namespace URI in * the order in which they are encountered in a preorder traversal of * this Element tree. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + *
HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the elements to match on. The * special value "*" matches all namespaces. * @param localName The local name of the elements to match on. The @@ -304,11 +287,8 @@ public interface Element extends Node { /** * Returns true when an attribute with a given local name and * namespace URI is specified on this element or has a default value, - * false otherwise. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + * false otherwise. HTML-only DOM implementations do not + * need to implement this method. * @param namespaceURI The namespace URI of the attribute to look for. * @param localName The local name of the attribute to look for. * @return true if an attribute with the given local name diff --git a/java/external/src/org/w3c/dom/Entity.java b/java/external/src/org/w3c/dom/Entity.java index 11bd0df..ecbf6a9 100644 --- a/java/external/src/org/w3c/dom/Entity.java +++ b/java/external/src/org/w3c/dom/Entity.java @@ -61,7 +61,7 @@ public interface Entity extends Node { /** * For unparsed entities, the name of the notation for the entity. For - * parsed entities, this is null. + * parsed entities, this is null. */ public String getNotationName(); diff --git a/java/external/src/org/w3c/dom/NamedNodeMap.java b/java/external/src/org/w3c/dom/NamedNodeMap.java index 8437366..2c199c3 100644 --- a/java/external/src/org/w3c/dom/NamedNodeMap.java +++ b/java/external/src/org/w3c/dom/NamedNodeMap.java @@ -56,11 +56,6 @@ public interface NamedNodeMap { * Attr that is already an attribute of another * Element object. The DOM user must explicitly clone * Attr nodes to re-use them in other elements. - *
HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node - * doesn't belong in this NamedNodeMap. Examples would include trying - * to insert something other than an Attr node into an Element's map - * of attributes, or a non-Entity node into the DocumentType's map of - * Entities. */ public Node setNamedItem(Node arg) throws DOMException; @@ -94,16 +89,13 @@ public interface NamedNodeMap { /** * The number of nodes in this map. The range of valid child node indices - * is 0 to length-1 inclusive. + * is 0 to length-1 inclusive. */ public int getLength(); /** - * Retrieves a node specified by local name and namespace URI. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + * Retrieves a node specified by local name and namespace URI. HTML-only + * DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the node to retrieve. * @param localName The local name of the node to retrieve. * @return A Node (of any type) with the specified local @@ -119,6 +111,7 @@ public interface NamedNodeMap { * localName. If a node with that namespace URI and that * local name is already present in this map, it is replaced by the new * one. + *
HTML-only DOM implementations do not need to implement this method. * @param arg A node to store in this map. The node will later be * accessible using the value of its namespaceURI and * localName attributes. @@ -133,14 +126,6 @@ public interface NamedNodeMap { * Attr that is already an attribute of another * Element object. The DOM user must explicitly clone * Attr nodes to re-use them in other elements. - *
HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node - * doesn't belong in this NamedNodeMap. Examples would include trying - * to insert something other than an Attr node into an Element's map - * of attributes, or a non-Entity node into the DocumentType's map of - * Entities. - *
NOT_SUPPORTED_ERR: Always thrown if the current document does not - * support the "XML" feature, since namespaces were - * defined by XML. * @since DOM Level 2 */ public Node setNamedItemNS(Node arg) @@ -153,10 +138,7 @@ public interface NamedNodeMap { * attribute of the Node interface. If so, an attribute * immediately appears containing the default value as well as the * corresponding namespace URI, local name, and prefix when applicable. - *
Documents which do not support the "XML" feature will permit only - * the DOM Level 1 calls for creating/setting elements and attributes. - * Hence, if you specify a non-null namespace URI, these DOMs will never - * find a matching node. + *
HTML-only DOM implementations do not need to implement this method. * @param namespaceURI The namespace URI of the node to remove. * @param localName The local name of the node to remove. * @return The node removed from this map if a node with such a local diff --git a/java/external/src/org/w3c/dom/Node.java b/java/external/src/org/w3c/dom/Node.java index 56ed30a..58e4318 100644 --- a/java/external/src/org/w3c/dom/Node.java +++ b/java/external/src/org/w3c/dom/Node.java @@ -29,97 +29,6 @@ package org.w3c.dom; * ), this returns null. Note that the specialized interfaces * may contain additional and more convenient mechanisms to get and set the * relevant information. - *

The values of nodeName, - * nodeValue, and attributes vary according to the - * node type as follows: - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
InterfacenodeNamenodeValueattributes
Attrname of - * attributevalue of attributenull
CDATASection"#cdata-section" - * content of the CDATA Sectionnull
Comment"#comment"content of - * the commentnull
Document"#document"nullnull
DocumentFragment - * "#document-fragment"nullnull
DocumentTypedocument type name - * nullnull
Elementtag namenullNamedNodeMap
Entityentity namenullnull
- * EntityReferencename of entity referencednullnull
Notationnotation namenull - * null
ProcessingInstructiontargetentire content excluding the targetnull
Text - * "#text"content of the text nodenull
*

See also the Document Object Model (DOM) Level 2 Core Specification. */ public interface Node { @@ -174,7 +83,7 @@ public interface Node { public static final short NOTATION_NODE = 12; /** - * The name of this node, depending on its type; see the table above. + * The name of this node, depending on its type; see the table above. */ public String getNodeName(); @@ -190,16 +99,6 @@ public interface Node { */ public String getNodeValue() throws DOMException; - /** - * The value of this node, depending on its type; see the table above. - * When it is defined to be null, setting it has no effect. - * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. - * @exception DOMException - * DOMSTRING_SIZE_ERR: Raised when it would return more characters than - * fit in a DOMString variable on the implementation - * platform. - */ public void setNodeValue(String nodeValue) throws DOMException; @@ -251,7 +150,7 @@ public interface Node { /** * A NamedNodeMap containing the attributes of this node (if - * it is an Element) or null otherwise. + * it is an Element) or null otherwise. */ public NamedNodeMap getAttributes(); @@ -274,14 +173,13 @@ public interface Node { * refChild. If the newChild is already in the * tree, it is first removed. * @param newChild The node to insert. - * @param refChild The reference node, i.e., the node before which the - * new node must be inserted. + * @param refChild The reference node, i.e., the node before which the new + * node must be inserted. * @return The node being inserted. * @exception DOMException * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * allow children of the type of the newChild node, or if - * the node to insert is one of this node's ancestors or this node - * itself. + * the node to insert is one of this node's ancestors. *
WRONG_DOCUMENT_ERR: Raised if newChild was created * from a different document than the one that created this node. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or @@ -307,8 +205,7 @@ public interface Node { * @exception DOMException * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * allow children of the type of the newChild node, or if - * the node to put in is one of this node's ancestors or this node - * itself. + * the node to put in is one of this node's ancestors. *
WRONG_DOCUMENT_ERR: Raised if newChild was created * from a different document than the one that created this node. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of @@ -337,26 +234,24 @@ public interface Node { * Adds the node newChild to the end of the list of children * of this node. If the newChild is already in the tree, it * is first removed. - * @param newChild The node to add.If it is a - * DocumentFragment object, the entire contents of the - * document fragment are moved into the child list of this node + * @param newChild The node to add.If it is a DocumentFragment + * object, the entire contents of the document fragment are moved + * into the child list of this node * @return The node added. * @exception DOMException * HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not * allow children of the type of the newChild node, or if - * the node to append is one of this node's ancestors or this node - * itself. + * the node to append is one of this node's ancestors. *
WRONG_DOCUMENT_ERR: Raised if newChild was created * from a different document than the one that created this node. - *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or - * if the previous parent of the node being inserted is readonly. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. */ public Node appendChild(Node newChild) throws DOMException; /** * Returns whether this node has any children. - * @return true if this node has any children, + * @return true if this node has any children, * false otherwise. */ public boolean hasChildNodes(); @@ -382,7 +277,7 @@ public interface Node { * Notation nodes is implementation dependent. * @param deep If true, recursively clone the subtree under * the specified node; if false, clone only the node - * itself (and its attributes, if it is an Element). + * itself (and its attributes, if it is an Element). * @return The duplicate node. */ public Node cloneNode(boolean deep); @@ -457,51 +352,20 @@ public interface Node { * Document interface, this is always null. * @exception DOMException * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an - * illegal character, per the XML 1.0 specification . + * illegal character. *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. *
NAMESPACE_ERR: Raised if the specified prefix is - * malformed per the Namespaces in XML specification, if the - * namespaceURI of this node is null, if the - * specified prefix is "xml" and the namespaceURI of this - * node is different from "http://www.w3.org/XML/1998/namespace", if - * this node is an attribute and the specified prefix is "xmlns" and - * the namespaceURI of this node is different from " + * malformed, if the namespaceURI of this node is + * null, if the specified prefix is "xml" and the + * namespaceURI of this node is different from " + * http://www.w3.org/XML/1998/namespace", if this node is an attribute + * and the specified prefix is "xmlns" and the + * namespaceURI of this node is different from " * http://www.w3.org/2000/xmlns/", or if this node is an attribute and * the qualifiedName of this node is "xmlns" . * @since DOM Level 2 */ public String getPrefix(); - /** - * The namespace prefix of this node, or null if it is - * unspecified. - *
Note that setting this attribute, when permitted, changes the - * nodeName attribute, which holds the qualified name, as - * well as the tagName and name attributes of - * the Element and Attr interfaces, when - * applicable. - *
Note also that changing the prefix of an attribute that is known to - * have a default value, does not make a new attribute with the default - * value and the original prefix appear, since the - * namespaceURI and localName do not change. - *
For nodes of any type other than ELEMENT_NODE and - * ATTRIBUTE_NODE and nodes created with a DOM Level 1 - * method, such as createElement from the - * Document interface, this is always null. - * @exception DOMException - * INVALID_CHARACTER_ERR: Raised if the specified prefix contains an - * illegal character, per the XML 1.0 specification . - *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. - *
NAMESPACE_ERR: Raised if the specified prefix is - * malformed per the Namespaces in XML specification, if the - * namespaceURI of this node is null, if the - * specified prefix is "xml" and the namespaceURI of this - * node is different from "http://www.w3.org/XML/1998/namespace", if - * this node is an attribute and the specified prefix is "xmlns" and - * the namespaceURI of this node is different from " - * http://www.w3.org/2000/xmlns/", or if this node is an attribute and - * the qualifiedName of this node is "xmlns" . - * @since DOM Level 2 - */ public void setPrefix(String prefix) throws DOMException; diff --git a/java/external/src/org/w3c/dom/NodeList.java b/java/external/src/org/w3c/dom/NodeList.java index a90b4fd..2a6e238 100644 --- a/java/external/src/org/w3c/dom/NodeList.java +++ b/java/external/src/org/w3c/dom/NodeList.java @@ -34,7 +34,7 @@ public interface NodeList { /** * The number of nodes in the list. The range of valid child node indices - * is 0 to length-1 inclusive. + * is 0 to length-1 inclusive. */ public int getLength(); diff --git a/java/external/src/org/w3c/dom/ProcessingInstruction.java b/java/external/src/org/w3c/dom/ProcessingInstruction.java index fe447b5..f84fdf2 100644 --- a/java/external/src/org/w3c/dom/ProcessingInstruction.java +++ b/java/external/src/org/w3c/dom/ProcessingInstruction.java @@ -34,13 +34,6 @@ public interface ProcessingInstruction extends Node { * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. */ public String getData(); - /** - * The content of this processing instruction. This is from the first non - * white space character after the target to the character immediately - * preceding the ?>. - * @exception DOMException - * NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly. - */ public void setData(String data) throws DOMException; diff --git a/java/external/src/org/w3c/dom/css/CSSRuleList.java b/java/external/src/org/w3c/dom/css/CSSRuleList.java index ba40520..41c2c68 100644 --- a/java/external/src/org/w3c/dom/css/CSSRuleList.java +++ b/java/external/src/org/w3c/dom/css/CSSRuleList.java @@ -33,7 +33,7 @@ public interface CSSRuleList { * collection represents the order of the rules in the CSS style sheet. * If index is greater than or equal to the number of rules in the list, * this returns null. - * @param indexIndex into the collection + * @param index Index into the collection * @return The style rule at the index position in the * CSSRuleList, or null if that is not a * valid index. diff --git a/java/external/src/org/w3c/dom/css/CSSValueList.java b/java/external/src/org/w3c/dom/css/CSSValueList.java index b159165..bf15bb3 100644 --- a/java/external/src/org/w3c/dom/css/CSSValueList.java +++ b/java/external/src/org/w3c/dom/css/CSSValueList.java @@ -36,7 +36,7 @@ public interface CSSValueList extends CSSValue { * this collection represents the order of the values in the CSS style * property. If index is greater than or equal to the number of values * in the list, this returns null. - * @param indexIndex into the collection. + * @param index Index into the collection. * @return The CSSValue at the index position * in the CSSValueList, or null if that is * not a valid index. diff --git a/java/external/src/org/w3c/dom/events/DocumentEvent.java b/java/external/src/org/w3c/dom/events/DocumentEvent.java index 43cd1ac..76644bc 100644 --- a/java/external/src/org/w3c/dom/events/DocumentEvent.java +++ b/java/external/src/org/w3c/dom/events/DocumentEvent.java @@ -26,7 +26,7 @@ import org.w3c.dom.DOMException; public interface DocumentEvent { /** * - * @param eventTypeThe eventType parameter specifies the + * @param eventType The eventType parameter specifies the * type of Event interface to be created. If the * Event interface specified is supported by the * implementation this method will return a new Event of diff --git a/java/external/src/org/w3c/dom/events/Event.java b/java/external/src/org/w3c/dom/events/Event.java index f2baad6..14a9239 100644 --- a/java/external/src/org/w3c/dom/events/Event.java +++ b/java/external/src/org/w3c/dom/events/Event.java @@ -122,7 +122,7 @@ public interface Event { * Event interface only the values specified in the * initEvent method are modified, all other attributes are * left unchanged. - * @param eventTypeArgSpecifies the event type. This type may be any + * @param eventTypeArg Specifies the event type. This type may be any * event type currently defined in this specification or a new event * type.. The string must be an XML name. Any new event type must not * begin with any upper, lower, or mixed case version of the string @@ -130,8 +130,8 @@ public interface Event { * also strongly recommended that third parties adding their own * events use their own prefix to avoid confusion and lessen the * probability of conflicts with other new events. - * @param canBubbleArgSpecifies whether or not the event can bubble. - * @param cancelableArgSpecifies whether or not the event's default + * @param canBubbleArg Specifies whether or not the event can bubble. + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. */ public void initEvent(String eventTypeArg, diff --git a/java/external/src/org/w3c/dom/events/EventTarget.java b/java/external/src/org/w3c/dom/events/EventTarget.java index 65e6286..f076636 100644 --- a/java/external/src/org/w3c/dom/events/EventTarget.java +++ b/java/external/src/org/w3c/dom/events/EventTarget.java @@ -36,11 +36,11 @@ public interface EventTarget { * EventListener to be called twice and since they are * discarded they do not need to be removed with the * removeEventListener method. - * @param typeThe event type for which the user is registering - * @param listenerThe listener parameter takes an interface + * @param type The event type for which the user is registering + * @param listener The listener parameter takes an interface * implemented by the user which contains the methods to be called * when the event occurs. - * @param useCaptureIf true, useCapture indicates that the + * @param useCapture If true, useCapture indicates that the * user wishes to initiate capture. After initiating capture, all * events of the specified type will be dispatched to the registered * EventListener before being dispatched to any @@ -61,11 +61,11 @@ public interface EventTarget { *
Calling removeEventListener with arguments which do * not identify any currently registered EventListener on * the EventTarget has no effect. - * @param typeSpecifies the event type of the EventListener + * @param type Specifies the event type of the EventListener * being removed. - * @param listenerThe EventListener parameter indicates the + * @param listener The EventListener parameter indicates the * EventListener to be removed. - * @param useCaptureSpecifies whether the EventListener + * @param useCapture Specifies whether the EventListener * being removed was registered as a capturing listener or not. If a * listener was registered twice, one with capture and one without, * each must be removed separately. Removal of a capturing listener @@ -83,7 +83,7 @@ public interface EventTarget { * implementation. The target of the event is the * EventTarget on which dispatchEvent is * called. - * @param evtSpecifies the event type, behavior, and contextual + * @param evt Specifies the event type, behavior, and contextual * information to be used in processing the event. * @return The return value of dispatchEvent indicates * whether any of the listeners which handled the event called diff --git a/java/external/src/org/w3c/dom/events/MouseEvent.java b/java/external/src/org/w3c/dom/events/MouseEvent.java index 8df616e..2f3d203 100644 --- a/java/external/src/org/w3c/dom/events/MouseEvent.java +++ b/java/external/src/org/w3c/dom/events/MouseEvent.java @@ -110,27 +110,27 @@ public interface MouseEvent extends UIEvent { * dispatchEvent method, though it may be called multiple * times during that phase if necessary. If called multiple times, the * final invocation takes precedence. - * @param typeArgSpecifies the event type. - * @param canBubbleArgSpecifies whether or not the event can bubble. - * @param cancelableArgSpecifies whether or not the event's default + * @param typeArg Specifies the event type. + * @param canBubbleArg Specifies whether or not the event can bubble. + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. - * @param viewArgSpecifies the Event's + * @param viewArg Specifies the Event's * AbstractView. - * @param detailArgSpecifies the Event's mouse click count. - * @param screenXArgSpecifies the Event's screen x coordinate - * @param screenYArgSpecifies the Event's screen y coordinate - * @param clientXArgSpecifies the Event's client x coordinate - * @param clientYArgSpecifies the Event's client y coordinate - * @param ctrlKeyArgSpecifies whether or not control key was depressed + * @param detailArg Specifies the Event's mouse click count. + * @param screenXArg Specifies the Event's screen x coordinate + * @param screenYArg Specifies the Event's screen y coordinate + * @param clientXArg Specifies the Event's client x coordinate + * @param clientYArg Specifies the Event's client y coordinate + * @param ctrlKeyArg Specifies whether or not control key was depressed * during the Event. - * @param altKeyArgSpecifies whether or not alt key was depressed during + * @param altKeyArg Specifies whether or not alt key was depressed during * the Event. - * @param shiftKeyArgSpecifies whether or not shift key was depressed + * @param shiftKeyArg Specifies whether or not shift key was depressed * during the Event. - * @param metaKeyArgSpecifies whether or not meta key was depressed + * @param metaKeyArg Specifies whether or not meta key was depressed * during the Event. - * @param buttonArgSpecifies the Event's mouse button. - * @param relatedTargetArgSpecifies the Event's related + * @param buttonArg Specifies the Event's mouse button. + * @param relatedTargetArg Specifies the Event's related * EventTarget. */ public void initMouseEvent(String typeArg, diff --git a/java/external/src/org/w3c/dom/events/MutationEvent.java b/java/external/src/org/w3c/dom/events/MutationEvent.java index 8b80aac..351f77b 100644 --- a/java/external/src/org/w3c/dom/events/MutationEvent.java +++ b/java/external/src/org/w3c/dom/events/MutationEvent.java @@ -82,18 +82,18 @@ public interface MutationEvent extends Event { * dispatchEvent method, though it may be called multiple * times during that phase if necessary. If called multiple times, the * final invocation takes precedence. - * @param typeArgSpecifies the event type. - * @param canBubbleArgSpecifies whether or not the event can bubble. - * @param cancelableArgSpecifies whether or not the event's default + * @param typeArg Specifies the event type. + * @param canBubbleArg Specifies whether or not the event can bubble. + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. - * @param relatedNodeArgSpecifies the Event's related Node. - * @param prevValueArgSpecifies the Event's + * @param relatedNodeArg Specifies the Event's related Node. + * @param prevValueArg Specifies the Event's * prevValue attribute. This value may be null. - * @param newValueArgSpecifies the Event's + * @param newValueArg Specifies the Event's * newValue attribute. This value may be null. - * @param attrNameArgSpecifies the Event's + * @param attrNameArg Specifies the Event's * attrName attribute. This value may be null. - * @param attrChangeArgSpecifies the Event's + * @param attrChangeArg Specifies the Event's * attrChange attribute */ public void initMutationEvent(String typeArg, diff --git a/java/external/src/org/w3c/dom/events/UIEvent.java b/java/external/src/org/w3c/dom/events/UIEvent.java index 27d17b6..15affe8 100644 --- a/java/external/src/org/w3c/dom/events/UIEvent.java +++ b/java/external/src/org/w3c/dom/events/UIEvent.java @@ -41,13 +41,13 @@ public interface UIEvent extends Event { * dispatchEvent method, though it may be called multiple * times during that phase if necessary. If called multiple times, the * final invocation takes precedence. - * @param typeArgSpecifies the event type. - * @param canBubbleArgSpecifies whether or not the event can bubble. - * @param cancelableArgSpecifies whether or not the event's default + * @param typeArg Specifies the event type. + * @param canBubbleArg Specifies whether or not the event can bubble. + * @param cancelableArg Specifies whether or not the event's default * action can be prevented. - * @param viewArgSpecifies the Event's + * @param viewArg Specifies the Event's * AbstractView. - * @param detailArgSpecifies the Event's detail. + * @param detailArg Specifies the Event's detail. */ public void initUIEvent(String typeArg, boolean canBubbleArg, diff --git a/java/external/src/org/w3c/dom/html/HTMLAnchorElement.java b/java/external/src/org/w3c/dom/html/HTMLAnchorElement.java new file mode 100644 index 0000000..be2e61a --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLAnchorElement.java @@ -0,0 +1,111 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * The anchor element. See the A element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLAnchorElement extends HTMLElement { + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * The character encoding of the linked resource. See the charset + * attribute definition in HTML 4.0. + */ + public String getCharset(); + public void setCharset(String charset); + + /** + * 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.0. + */ + public String getCoords(); + public void setCoords(String coords); + + /** + * The URI of the linked resource. See the href attribute definition in + * HTML 4.0. + */ + public String getHref(); + public void setHref(String href); + + /** + * Language code of the linked resource. See the hreflang attribute + * definition in HTML 4.0. + */ + public String getHreflang(); + public void setHreflang(String hreflang); + + /** + * Anchor name. See the name attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Forward link type. See the rel attribute definition in HTML 4.0. + */ + public String getRel(); + public void setRel(String rel); + + /** + * Reverse link type. See the rev attribute definition in HTML 4.0. + */ + public String getRev(); + public void setRev(String rev); + + /** + * The shape of the active area. The coordinates are given by + * coords. See the shape attribute definition in HTML 4.0. + */ + public String getShape(); + public void setShape(String shape); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * Frame to render the resource in. See the target attribute definition in + * HTML 4.0. + */ + public String getTarget(); + public void setTarget(String target); + + /** + * Advisory content type. See the type attribute definition in HTML 4.0. + */ + public String getType(); + public void setType(String type); + + /** + * Removes keyboard focus from this element. + */ + public void blur(); + + /** + * Gives keyboard focus to this element. + */ + public void focus(); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLAppletElement.java b/java/external/src/org/w3c/dom/html/HTMLAppletElement.java new file mode 100644 index 0000000..9d86a5f --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLAppletElement.java @@ -0,0 +1,102 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * An embedded Java applet. See the APPLET element definition in HTML 4.0. + * This element is deprecated in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLAppletElement extends HTMLElement { + /** + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Alternate text for user agents not rendering the normal content of this + * element. See the alt attribute definition in HTML 4.0. This attribute + * is deprecated in HTML 4.0. + */ + public String getAlt(); + public void setAlt(String alt); + + /** + * Comma-separated archive list. See the archive attribute definition in + * HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getArchive(); + public void setArchive(String archive); + + /** + * Applet class file. See the code attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getCode(); + public void setCode(String code); + + /** + * Optional base URI for applet. See the codebase attribute definition in + * HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getCodeBase(); + public void setCodeBase(String codeBase); + + /** + * Override height. See the height attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getHeight(); + public void setHeight(String height); + + /** + * Horizontal space to the left and right of this image, applet, or + * object. See the hspace attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getHspace(); + public void setHspace(String hspace); + + /** + * The name of the applet. See the name attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Serialized applet file. See the object attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getObject(); + public void setObject(String object); + + /** + * Vertical space above and below this image, applet, or object. See the + * vspace attribute definition in HTML 4.0. This attribute is deprecated + * in HTML 4.0. + */ + public String getVspace(); + public void setVspace(String vspace); + + /** + * Override width. See the width attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLAreaElement.java b/java/external/src/org/w3c/dom/html/HTMLAreaElement.java new file mode 100644 index 0000000..f484834 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLAreaElement.java @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Client-side image map area definition. See the AREA element definition in + * HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLAreaElement extends HTMLElement { + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * Alternate text for user agents not rendering the normal content of this + * element. See the alt attribute definition in HTML 4.0. + */ + public String getAlt(); + public void setAlt(String alt); + + /** + * 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.0. + */ + public String getCoords(); + public void setCoords(String coords); + + /** + * The URI of the linked resource. See the href attribute definition in + * HTML 4.0. + */ + public String getHref(); + public void setHref(String href); + + /** + * Specifies that this area is inactive, i.e., has no associated action. + * See the nohref attribute definition in HTML 4.0. + */ + public boolean getNoHref(); + public void setNoHref(boolean noHref); + + /** + * The shape of the active area. The coordinates are given by + * coords. See the shape attribute definition in HTML 4.0. + */ + public String getShape(); + public void setShape(String shape); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * Frame to render the resource in. See the target attribute definition in + * HTML 4.0. + */ + public String getTarget(); + public void setTarget(String target); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLBRElement.java b/java/external/src/org/w3c/dom/html/HTMLBRElement.java new file mode 100644 index 0000000..252e226 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLBRElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Force a line break. See the BR element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLBRElement extends HTMLElement { + /** + * Control flow of text around floats. See the clear attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getClear(); + public void setClear(String clear); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLBaseElement.java b/java/external/src/org/w3c/dom/html/HTMLBaseElement.java new file mode 100644 index 0000000..518b049 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLBaseElement.java @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Document base URI. See the BASE element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLBaseElement extends HTMLElement { + /** + * The base URI. See the href attribute definition in HTML 4.0. + */ + public String getHref(); + public void setHref(String href); + + /** + * The default target frame. See the target attribute definition in HTML + * 4.0. + */ + public String getTarget(); + public void setTarget(String target); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLBaseFontElement.java b/java/external/src/org/w3c/dom/html/HTMLBaseFontElement.java new file mode 100644 index 0000000..0aafccd --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLBaseFontElement.java @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Base font. See the BASEFONT element definition in HTML 4.0. This element is + * deprecated in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLBaseFontElement extends HTMLElement { + /** + * Font color. See the color attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getColor(); + public void setColor(String color); + + /** + * Font face identifier. See the face attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getFace(); + public void setFace(String face); + + /** + * Font size. See the size attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getSize(); + public void setSize(String size); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLBodyElement.java b/java/external/src/org/w3c/dom/html/HTMLBodyElement.java new file mode 100644 index 0000000..d88b612 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLBodyElement.java @@ -0,0 +1,67 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * The HTML document body. This element is always present in the DOM API, even + * if the tags are not present in the source document. See the BODY element + * definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLBodyElement extends HTMLElement { + /** + * Color of active links (after mouse-button down, but before mouse-button + * up). See the alink attribute definition in HTML 4.0. This attribute + * is deprecated in HTML 4.0. + */ + public String getALink(); + public void setALink(String aLink); + + /** + * URI of the background texture tile image. See the background attribute + * definition in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBackground(); + public void setBackground(String background); + + /** + * Document background color. See the bgcolor attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBgColor(); + public void setBgColor(String bgColor); + + /** + * Color of links that are not active and unvisited. See the link + * attribute definition in HTML 4.0. This attribute is deprecated in + * HTML 4.0. + */ + public String getLink(); + public void setLink(String link); + + /** + * Document text color. See the text attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getText(); + public void setText(String text); + + /** + * Color of links that have been visited by the user. See the vlink + * attribute definition in HTML 4.0. This attribute is deprecated in + * HTML 4.0. + */ + public String getVLink(); + public void setVLink(String vLink); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLButtonElement.java b/java/external/src/org/w3c/dom/html/HTMLButtonElement.java new file mode 100644 index 0000000..a9c7ff3 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLButtonElement.java @@ -0,0 +1,67 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Push button. See the BUTTON element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLButtonElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * The control is unavailable in this context. See the disabled attribute + * definition in HTML 4.0. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * Form control or object name when submitted with a form. See the name + * attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * The type of button. See the type attribute definition in HTML 4.0. + */ + public String getType(); + + /** + * The current form control value. See the value attribute definition in + * HTML 4.0. + */ + public String getValue(); + public void setValue(String value); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLCollection.java b/java/external/src/org/w3c/dom/html/HTMLCollection.java new file mode 100644 index 0000000..1f373b2 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLCollection.java @@ -0,0 +1,55 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.Node; + +/** + * 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. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLCollection { + /** + * This attribute specifies the length or size of the list. + */ + public int getLength(); + + /** + * This method retrieves a node specified by ordinal index. Nodes are + * numbered in tree order (depth-first traversal order). + * @param index The index of the node to be fetched. The index origin is 0. + * @return The Node at the corresponding position upon + * success. A value of null is returned if the index is + * out of range. + */ + public Node item(int index); + + /** + * 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. + * @param name The name of the Node to be fetched. + * @return 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. + */ + public Node namedItem(String name); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLDListElement.java b/java/external/src/org/w3c/dom/html/HTMLDListElement.java new file mode 100644 index 0000000..414d171 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLDListElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Definition list. See the DL element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLDListElement extends HTMLElement { + /** + * Reduce spacing between list items. See the compact attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getCompact(); + public void setCompact(boolean compact); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLDirectoryElement.java b/java/external/src/org/w3c/dom/html/HTMLDirectoryElement.java new file mode 100644 index 0000000..674d645 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLDirectoryElement.java @@ -0,0 +1,28 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Directory list. See the DIR element definition in HTML 4.0. This element is + * deprecated in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLDirectoryElement extends HTMLElement { + /** + * Reduce spacing between list items. See the compact attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getCompact(); + public void setCompact(boolean compact); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLDivElement.java b/java/external/src/org/w3c/dom/html/HTMLDivElement.java new file mode 100644 index 0000000..0141bd2 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLDivElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Generic block container. See the DIV element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLDivElement extends HTMLElement { + /** + * Horizontal text alignment. See the align attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLDocument.java b/java/external/src/org/w3c/dom/html/HTMLDocument.java new file mode 100644 index 0000000..c1d43fc --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLDocument.java @@ -0,0 +1,162 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.Document; +import org.w3c.dom.NodeList; +import org.w3c.dom.Element; + +/** + * 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:alinkColorbackground + * bgColorfgColorlinkColorvlinkColor + *

+ *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLDocument extends Document { + /** + * The title of a document as specified by the TITLE element + * in the head of the document. + */ + public String getTitle(); + public void setTitle(String title); + + /** + * Returns the URI 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). + */ + public String getReferrer(); + + /** + * The domain name of the server that served the document, or null if the + * server cannot be identified by a domain name. + */ + public String getDomain(); + + /** + * The complete URI of the document. + */ + public String getURL(); + + /** + * 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. + */ + public HTMLElement getBody(); + public void setBody(HTMLElement body); + + /** + * A collection of all the IMG elements in a document. The + * behavior is limited to IMG elements for backwards + * compatibility. + */ + public HTMLCollection getImages(); + + /** + * A collection of all the OBJECT elements that include + * applets and APPLET (deprecated) elements in a document. + */ + public HTMLCollection getApplets(); + + /** + * A collection of all AREA elements and anchor ( + * A) elements in a document with a value for the + * href attribute. + */ + public HTMLCollection getLinks(); + + /** + * A collection of all the forms of a document. + */ + public HTMLCollection getForms(); + + /** + * A collection of all the anchor (A) elements in a document + * with a value for the name attribute.Note. For reasons of + * backwards compatibility, the returned set of anchors only contains + * those anchors created with the name attribute, not those + * created with the id attribute. + */ + public HTMLCollection getAnchors(); + + /** + * The cookies associated with this document. If there are none, the value + * is an empty string. Otherwise, the value is a string: a + * semicolon-delimited list of "name=value" pairs for all the cookies + * associated with the page. For example, + * name=value;expires=date. + */ + public String getCookie(); + public void setCookie(String cookie); + + /** + * 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. + * The following methods may be deprecated at some point in the future + * in favor of a more general-purpose mechanism. + *
Open a document stream for writing. If a document exists in the + * target, this method clears it. + */ + public void open(); + + /** + * Closes a document stream opened by open() and forces + * rendering. + */ + public void close(); + + /** + * Write a string of text to a document stream opened by + * open(). The text is parsed into the document's structure + * model. + * @param text The string to be parsed into some structure in the document + * structure model. + */ + public void write(String text); + + /** + * Write a string of text followed by a newline character to a document + * stream opened by open(). The text is parsed into the + * document's structure model. + * @param text The string to be parsed into some structure in the document + * structure model. + */ + public void writeln(String text); + + /** + * Returns the Element whose id is given by elementId. If no + * such element exists, returns null. Behavior is not + * defined if more than one element has this id. + * @param elementId The unique id value for an element. + * @return The matching element. + */ + public Element getElementById(String elementId); + + /** + * Returns the (possibly empty) collection of elements whose + * name value is given by elementName. + * @param elementName The name attribute value for an element. + * @return The matching elements. + */ + public NodeList getElementsByName(String elementName); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLElement.java b/java/external/src/org/w3c/dom/html/HTMLElement.java new file mode 100644 index 0000000..264247f --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLElement.java @@ -0,0 +1,65 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.Element; + +/** + * 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:HEAD + * special: SUB, SUP, SPAN, BDOfont: TT, I, B, U, S, STRIKE, BIG, SMALL + * phrase: EM, STRONG, DFN, CODE, SAMP, KBD, VAR, CITE, ACRONYM, ABBRlist: + * DD, DTNOFRAMES, NOSCRIPTADDRESS, CENTER + *

Note. The style attribute for this interface is reserved + * for future usage. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLElement extends Element { + /** + * The element's identifier. See the id attribute definition in HTML 4.0. + */ + public String getId(); + public void setId(String id); + + /** + * The element's advisory title. See the title attribute definition in + * HTML 4.0. + */ + public String getTitle(); + public void setTitle(String title); + + /** + * Language code defined in RFC 1766. See the lang attribute definition in + * HTML 4.0. + */ + public String getLang(); + public void setLang(String lang); + + /** + * Specifies the base direction of directionally neutral text and the + * directionality of tables. See the dir attribute definition in HTML + * 4.0. + */ + public String getDir(); + public void setDir(String dir); + + /** + * 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.0. + */ + public String getClassName(); + public void setClassName(String className); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLFieldSetElement.java b/java/external/src/org/w3c/dom/html/HTMLFieldSetElement.java new file mode 100644 index 0000000..de8f0ba --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLFieldSetElement.java @@ -0,0 +1,28 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Organizes form controls into logical groups. See the FIELDSET element + * definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLFieldSetElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLFontElement.java b/java/external/src/org/w3c/dom/html/HTMLFontElement.java new file mode 100644 index 0000000..be6fb9c --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLFontElement.java @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Local change to font. See the FONT element definition in HTML 4.0. This + * element is deprecated in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLFontElement extends HTMLElement { + /** + * Font color. See the color attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getColor(); + public void setColor(String color); + + /** + * Font face identifier. See the face attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getFace(); + public void setFace(String face); + + /** + * Font size. See the size attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getSize(); + public void setSize(String size); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLFormElement.java b/java/external/src/org/w3c/dom/html/HTMLFormElement.java new file mode 100644 index 0000000..d83d6f5 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLFormElement.java @@ -0,0 +1,86 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * The FORM element encompasses behavior similar to a collection + * and an element. It provides direct access to the contained input elements + * as well as the attributes of the form element. See the FORM element + * definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLFormElement extends HTMLElement { + /** + * Returns a collection of all control elements in the form. + */ + public HTMLCollection getElements(); + + /** + * The number of form controls in the form. + */ + public int getLength(); + + /** + * Names the form. + */ + public String getName(); + public void setName(String name); + + /** + * List of character sets supported by the server. See the accept-charset + * attribute definition in HTML 4.0. + */ + public String getAcceptCharset(); + public void setAcceptCharset(String acceptCharset); + + /** + * Server-side form handler. See the action attribute definition in HTML + * 4.0. + */ + public String getAction(); + public void setAction(String action); + + /** + * The content type of the submitted form, generally + * "application/x-www-form-urlencoded". See the enctype attribute + * definition in HTML 4.0. + */ + public String getEnctype(); + public void setEnctype(String enctype); + + /** + * HTTP method used to submit form. See the method attribute definition in + * HTML 4.0. + */ + public String getMethod(); + public void setMethod(String method); + + /** + * Frame to render the resource in. See the target attribute definition in + * HTML 4.0. + */ + public String getTarget(); + public void setTarget(String target); + + /** + * Submits the form. It performs the same action as a submit button. + */ + public void submit(); + + /** + * Restores a form element's default values. It performs the same action + * as a reset button. + */ + public void reset(); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLFrameElement.java b/java/external/src/org/w3c/dom/html/HTMLFrameElement.java new file mode 100644 index 0000000..c34fd70 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLFrameElement.java @@ -0,0 +1,76 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Create a frame. See the FRAME element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLFrameElement extends HTMLElement { + /** + * Request frame borders. See the frameborder attribute definition in HTML + * 4.0. + */ + public String getFrameBorder(); + public void setFrameBorder(String frameBorder); + + /** + * URI designating a long description of this image or frame. See the + * longdesc attribute definition in HTML 4.0. + */ + public String getLongDesc(); + public void setLongDesc(String longDesc); + + /** + * Frame margin height, in pixels. See the marginheight attribute + * definition in HTML 4.0. + */ + public String getMarginHeight(); + public void setMarginHeight(String marginHeight); + + /** + * Frame margin width, in pixels. See the marginwidth attribute definition + * in HTML 4.0. + */ + public String getMarginWidth(); + public void setMarginWidth(String marginWidth); + + /** + * The frame name (object of the target attribute). See the + * name attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * When true, forbid user from resizing frame. See the noresize attribute + * definition in HTML 4.0. + */ + public boolean getNoResize(); + public void setNoResize(boolean noResize); + + /** + * Specify whether or not the frame should have scrollbars. See the + * scrolling attribute definition in HTML 4.0. + */ + public String getScrolling(); + public void setScrolling(String scrolling); + + /** + * A URI designating the initial frame contents. See the src attribute + * definition in HTML 4.0. + */ + public String getSrc(); + public void setSrc(String src); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLFrameSetElement.java b/java/external/src/org/w3c/dom/html/HTMLFrameSetElement.java new file mode 100644 index 0000000..a332ff4 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLFrameSetElement.java @@ -0,0 +1,34 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Create a grid of frames. See the FRAMESET element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLFrameSetElement extends HTMLElement { + /** + * The number of columns of frames in the frameset. See the cols attribute + * definition in HTML 4.0. + */ + public String getCols(); + public void setCols(String cols); + + /** + * The number of rows of frames in the frameset. See the rows attribute + * definition in HTML 4.0. + */ + public String getRows(); + public void setRows(String rows); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLHRElement.java b/java/external/src/org/w3c/dom/html/HTMLHRElement.java new file mode 100644 index 0000000..57ff4ba --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLHRElement.java @@ -0,0 +1,49 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Create a horizontal rule. See the HR element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLHRElement extends HTMLElement { + /** + * Align the rule on the page. See the align attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * 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.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getNoShade(); + public void setNoShade(boolean noShade); + + /** + * The height of the rule. See the size attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getSize(); + public void setSize(String size); + + /** + * The width of the rule. See the width attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLHeadElement.java b/java/external/src/org/w3c/dom/html/HTMLHeadElement.java new file mode 100644 index 0000000..97d05b3 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLHeadElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Document head information. See the HEAD element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLHeadElement extends HTMLElement { + /** + * URI designating a metadata profile. See the profile attribute definition + * in HTML 4.0. + */ + public String getProfile(); + public void setProfile(String profile); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLHeadingElement.java b/java/external/src/org/w3c/dom/html/HTMLHeadingElement.java new file mode 100644 index 0000000..3b6bb31 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLHeadingElement.java @@ -0,0 +1,28 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * For the H1 to H6 elements. See the H1 element + * definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLHeadingElement extends HTMLElement { + /** + * Horizontal text alignment. See the align attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLHtmlElement.java b/java/external/src/org/w3c/dom/html/HTMLHtmlElement.java new file mode 100644 index 0000000..fe834e5 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLHtmlElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Root of an HTML document. See the HTML element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLHtmlElement extends HTMLElement { + /** + * Version information about the document's DTD. See the version attribute + * definition in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getVersion(); + public void setVersion(String version); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLIFrameElement.java b/java/external/src/org/w3c/dom/html/HTMLIFrameElement.java new file mode 100644 index 0000000..1e8e14d --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLIFrameElement.java @@ -0,0 +1,89 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Inline subwindows. See the IFRAME element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLIFrameElement extends HTMLElement { + /** + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Request frame borders. See the frameborder attribute definition in HTML + * 4.0. + */ + public String getFrameBorder(); + public void setFrameBorder(String frameBorder); + + /** + * Frame height. See the height attribute definition in HTML 4.0. + */ + public String getHeight(); + public void setHeight(String height); + + /** + * URI designating a long description of this image or frame. See the + * longdesc attribute definition in HTML 4.0. + */ + public String getLongDesc(); + public void setLongDesc(String longDesc); + + /** + * Frame margin height, in pixels. See the marginheight attribute + * definition in HTML 4.0. + */ + public String getMarginHeight(); + public void setMarginHeight(String marginHeight); + + /** + * Frame margin width, in pixels. See the marginwidth attribute definition + * in HTML 4.0. + */ + public String getMarginWidth(); + public void setMarginWidth(String marginWidth); + + /** + * The frame name (object of the target attribute). See the + * name attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Specify whether or not the frame should have scrollbars. See the + * scrolling attribute definition in HTML 4.0. + */ + public String getScrolling(); + public void setScrolling(String scrolling); + + /** + * A URI designating the initial frame contents. See the src attribute + * definition in HTML 4.0. + */ + public String getSrc(); + public void setSrc(String src); + + /** + * Frame width. See the width attribute definition in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLImageElement.java b/java/external/src/org/w3c/dom/html/HTMLImageElement.java new file mode 100644 index 0000000..aab000e --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLImageElement.java @@ -0,0 +1,109 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Embedded image. See the IMG element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLImageElement extends HTMLElement { + /** + * URI designating the source of this image, for low-resolution output. + */ + public String getLowSrc(); + public void setLowSrc(String lowSrc); + + /** + * The name of the element (for backwards compatibility). + */ + public String getName(); + public void setName(String name); + + /** + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Alternate text for user agents not rendering the normal content of this + * element. See the alt attribute definition in HTML 4.0. + */ + public String getAlt(); + public void setAlt(String alt); + + /** + * Width of border around image. See the border attribute definition in + * HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBorder(); + public void setBorder(String border); + + /** + * Override height. See the height attribute definition in HTML 4.0. + */ + public String getHeight(); + public void setHeight(String height); + + /** + * Horizontal space to the left and right of this image. See the hspace + * attribute definition in HTML 4.0. This attribute is deprecated in + * HTML 4.0. + */ + public String getHspace(); + public void setHspace(String hspace); + + /** + * Use server-side image map. See the ismap attribute definition in HTML + * 4.0. + */ + public boolean getIsMap(); + public void setIsMap(boolean isMap); + + /** + * URI designating a long description of this image or frame. See the + * longdesc attribute definition in HTML 4.0. + */ + public String getLongDesc(); + public void setLongDesc(String longDesc); + + /** + * URI designating the source of this image. See the src attribute + * definition in HTML 4.0. + */ + public String getSrc(); + public void setSrc(String src); + + /** + * Use client-side image map. See the usemap attribute definition in HTML + * 4.0. + */ + public String getUseMap(); + public void setUseMap(String useMap); + + /** + * Vertical space above and below this image. See the vspace attribute + * definition in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getVspace(); + public void setVspace(String vspace); + + /** + * Override width. See the width attribute definition in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLInputElement.java b/java/external/src/org/w3c/dom/html/HTMLInputElement.java new file mode 100644 index 0000000..05034e8 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLInputElement.java @@ -0,0 +1,198 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Form control. Note. Depending upon the environment in which the page is + * being viewed, the value property may be read-only for the file upload + * input type. For the "password" input type, the actual value returned may + * be masked to prevent unauthorized use. See the INPUT element definition + * in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLInputElement extends HTMLElement { + /** + * 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. Changing this attribute, however, resets the + * contents of the form control. See the value attribute definition in + * HTML 4.0. + */ + public String getDefaultValue(); + public void setDefaultValue(String defaultValue); + + /** + * 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. Changes to this + * attribute, however, resets the state of the form control. See the + * checked attribute definition in HTML 4.0. + */ + public boolean getDefaultChecked(); + public void setDefaultChecked(boolean defaultChecked); + + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * A comma-separated list of content types that a server processing this + * form will handle correctly. See the accept attribute definition in + * HTML 4.0. + */ + public String getAccept(); + public void setAccept(String accept); + + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Alternate text for user agents not rendering the normal content of this + * element. See the alt attribute definition in HTML 4.0. + */ + public String getAlt(); + public void setAlt(String alt); + + /** + * 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 value attribute of the element. + */ + public boolean getChecked(); + public void setChecked(boolean checked); + + /** + * The control is unavailable in this context. See the disabled attribute + * definition in HTML 4.0. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * Maximum number of characters for text fields, when type + * has the value "Text" or "Password". See the maxlength attribute + * definition in HTML 4.0. + */ + public int getMaxLength(); + public void setMaxLength(int maxLength); + + /** + * Form control or object name when submitted with a form. See the name + * attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * This control is read-only. Relevant only when type has the + * value "Text" or "Password". See the readonly attribute definition in + * HTML 4.0. + */ + public boolean getReadOnly(); + public void setReadOnly(boolean readOnly); + + /** + * Size information. The precise meaning is specific to each type of + * field. See the size attribute definition in HTML 4.0. + */ + public String getSize(); + public void setSize(String size); + + /** + * 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.0. + */ + public String getSrc(); + public void setSrc(String src); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * The type of control created. See the type attribute definition in HTML + * 4.0. + */ + public String getType(); + + /** + * Use client-side image map. See the usemap attribute definition in HTML + * 4.0. + */ + public String getUseMap(); + public void setUseMap(String useMap); + + /** + * 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.0. + */ + public String getValue(); + public void setValue(String value); + + /** + * Removes keyboard focus from this element. + */ + public void blur(); + + /** + * Gives keyboard focus to this element. + */ + public void focus(); + + /** + * Select the contents of the text area. For INPUT elements + * whose type attribute has one of the following values: + * "Text", "File", or "Password". + */ + public void select(); + + /** + * Simulate a mouse-click. For INPUT elements whose + * type attribute has one of the following values: + * "Button", "Checkbox", "Radio", "Reset", or "Submit". + */ + public void click(); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLIsIndexElement.java b/java/external/src/org/w3c/dom/html/HTMLIsIndexElement.java new file mode 100644 index 0000000..d54e679 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLIsIndexElement.java @@ -0,0 +1,35 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * This element is used for single-line text input. See the ISINDEX element + * definition in HTML 4.0. This element is deprecated in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLIsIndexElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * The prompt message. See the prompt attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getPrompt(); + public void setPrompt(String prompt); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLLIElement.java b/java/external/src/org/w3c/dom/html/HTMLLIElement.java new file mode 100644 index 0000000..4ee870c --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLLIElement.java @@ -0,0 +1,35 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * List item. See the LI element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLLIElement extends HTMLElement { + /** + * List item bullet style. See the type attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getType(); + public void setType(String type); + + /** + * Reset sequence number when used in OL. See the value + * attribute definition in HTML 4.0. This attribute is deprecated in + * HTML 4.0. + */ + public int getValue(); + public void setValue(int value); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLLabelElement.java b/java/external/src/org/w3c/dom/html/HTMLLabelElement.java new file mode 100644 index 0000000..069787c --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLLabelElement.java @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Form field label text. See the LABEL element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLLabelElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * This attribute links this label with another form control by + * id attribute. See the for attribute definition in HTML + * 4.0. + */ + public String getHtmlFor(); + public void setHtmlFor(String htmlFor); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLLegendElement.java b/java/external/src/org/w3c/dom/html/HTMLLegendElement.java new file mode 100644 index 0000000..875f8e0 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLLegendElement.java @@ -0,0 +1,43 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Provides a caption for a FIELDSET grouping. See the LEGEND + * element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLLegendElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * Text alignment relative to FIELDSET. See the align + * attribute definition in HTML 4.0. This attribute is deprecated in + * HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLLinkElement.java b/java/external/src/org/w3c/dom/html/HTMLLinkElement.java new file mode 100644 index 0000000..e54e711 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLLinkElement.java @@ -0,0 +1,82 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * The LINK element specifies a link to an external resource, and + * defines this document's relationship to that resource (or vice versa). + * See the LINK element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLLinkElement extends HTMLElement { + /** + * Enables/disables the link. This is currently only used for style sheet + * links, and may be used to activate or deactivate style sheets. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * The character encoding of the resource being linked to. See the charset + * attribute definition in HTML 4.0. + */ + public String getCharset(); + public void setCharset(String charset); + + /** + * The URI of the linked resource. See the href attribute definition in + * HTML 4.0. + */ + public String getHref(); + public void setHref(String href); + + /** + * Language code of the linked resource. See the hreflang attribute + * definition in HTML 4.0. + */ + public String getHreflang(); + public void setHreflang(String hreflang); + + /** + * Designed for use with one or more target media. See the media attribute + * definition in HTML 4.0. + */ + public String getMedia(); + public void setMedia(String media); + + /** + * Forward link type. See the rel attribute definition in HTML 4.0. + */ + public String getRel(); + public void setRel(String rel); + + /** + * Reverse link type. See the rev attribute definition in HTML 4.0. + */ + public String getRev(); + public void setRev(String rev); + + /** + * Frame to render the resource in. See the target attribute definition in + * HTML 4.0. + */ + public String getTarget(); + public void setTarget(String target); + + /** + * Advisory content type. See the type attribute definition in HTML 4.0. + */ + public String getType(); + public void setType(String type); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLMapElement.java b/java/external/src/org/w3c/dom/html/HTMLMapElement.java new file mode 100644 index 0000000..751ffdd --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLMapElement.java @@ -0,0 +1,32 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Client-side image map. See the MAP element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLMapElement extends HTMLElement { + /** + * The list of areas defined for the image map. + */ + public HTMLCollection getAreas(); + + /** + * Names the map (for use with usemap). See the name + * attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLMenuElement.java b/java/external/src/org/w3c/dom/html/HTMLMenuElement.java new file mode 100644 index 0000000..52bf6e1 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLMenuElement.java @@ -0,0 +1,28 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Menu list. See the MENU element definition in HTML 4.0. This element is + * deprecated in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLMenuElement extends HTMLElement { + /** + * Reduce spacing between list items. See the compact attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getCompact(); + public void setCompact(boolean compact); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLMetaElement.java b/java/external/src/org/w3c/dom/html/HTMLMetaElement.java new file mode 100644 index 0000000..f79b93d --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLMetaElement.java @@ -0,0 +1,47 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * This contains generic meta-information about the document. See the META + * element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLMetaElement extends HTMLElement { + /** + * Associated information. See the content attribute definition in HTML + * 4.0. + */ + public String getContent(); + public void setContent(String content); + + /** + * HTTP response header name. See the http-equiv attribute definition in + * HTML 4.0. + */ + public String getHttpEquiv(); + public void setHttpEquiv(String httpEquiv); + + /** + * Meta information name. See the name attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Select form of content. See the scheme attribute definition in HTML 4.0. + */ + public String getScheme(); + public void setScheme(String scheme); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLModElement.java b/java/external/src/org/w3c/dom/html/HTMLModElement.java new file mode 100644 index 0000000..4e161fe --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLModElement.java @@ -0,0 +1,35 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Notice of modification to part of a document. See the INS and DEL element + * definitions in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLModElement extends HTMLElement { + /** + * A URI designating a document that describes the reason for the change. + * See the cite attribute definition in HTML 4.0. + */ + public String getCite(); + public void setCite(String cite); + + /** + * The date and time of the change. See the datetime attribute definition + * in HTML 4.0. + */ + public String getDateTime(); + public void setDateTime(String dateTime); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLOListElement.java b/java/external/src/org/w3c/dom/html/HTMLOListElement.java new file mode 100644 index 0000000..c6cdc20 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLOListElement.java @@ -0,0 +1,41 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Ordered list. See the OL element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLOListElement extends HTMLElement { + /** + * Reduce spacing between list items. See the compact attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getCompact(); + public void setCompact(boolean compact); + + /** + * Starting sequence number. See the start attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public int getStart(); + public void setStart(int start); + + /** + * Numbering style. See the type attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getType(); + public void setType(String type); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLObjectElement.java b/java/external/src/org/w3c/dom/html/HTMLObjectElement.java new file mode 100644 index 0000000..be9b1c4 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLObjectElement.java @@ -0,0 +1,151 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Generic embedded object. Note. In principle, all properties on the object + * element are read-write but in some environments some properties may be + * read-only once the underlying object is instantiated. See the OBJECT + * element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLObjectElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * Applet class file. See the code attribute for + * HTMLAppletElement. + */ + public String getCode(); + public void setCode(String code); + + /** + * Aligns this object (vertically or horizontally) with respect to its + * surrounding text. See the align attribute definition in HTML 4.0. + * This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Space-separated list of archives. See the archive attribute definition + * in HTML 4.0. + */ + public String getArchive(); + public void setArchive(String archive); + + /** + * Width of border around the object. See the border attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBorder(); + public void setBorder(String border); + + /** + * Base URI for classid, data, and + * archive attributes. See the codebase attribute definition + * in HTML 4.0. + */ + public String getCodeBase(); + public void setCodeBase(String codeBase); + + /** + * Content type for data downloaded via classid attribute. + * See the codetype attribute definition in HTML 4.0. + */ + public String getCodeType(); + public void setCodeType(String codeType); + + /** + * A URI specifying the location of the object's data. See the data + * attribute definition in HTML 4.0. + */ + public String getData(); + public void setData(String data); + + /** + * Declare (for future reference), but do not instantiate, this object. + * See the declare attribute definition in HTML 4.0. + */ + public boolean getDeclare(); + public void setDeclare(boolean declare); + + /** + * Override height. See the height attribute definition in HTML 4.0. + */ + public String getHeight(); + public void setHeight(String height); + + /** + * Horizontal space to the left and right of this image, applet, or + * object. See the hspace attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getHspace(); + public void setHspace(String hspace); + + /** + * Form control or object name when submitted with a form. See the name + * attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Message to render while loading the object. See the standby attribute + * definition in HTML 4.0. + */ + public String getStandby(); + public void setStandby(String standby); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * Content type for data downloaded via data attribute. See + * the type attribute definition in HTML 4.0. + */ + public String getType(); + public void setType(String type); + + /** + * Use client-side image map. See the usemap attribute definition in HTML + * 4.0. + */ + public String getUseMap(); + public void setUseMap(String useMap); + + /** + * Vertical space above and below this image, applet, or object. See the + * vspace attribute definition in HTML 4.0. This attribute is deprecated + * in HTML 4.0. + */ + public String getVspace(); + public void setVspace(String vspace); + + /** + * Override width. See the width attribute definition in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLOptGroupElement.java b/java/external/src/org/w3c/dom/html/HTMLOptGroupElement.java new file mode 100644 index 0000000..1b9c128 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLOptGroupElement.java @@ -0,0 +1,35 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Group options together in logical subdivisions. See the OPTGROUP element + * definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLOptGroupElement extends HTMLElement { + /** + * The control is unavailable in this context. See the disabled attribute + * definition in HTML 4.0. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * Assigns a label to this option group. See the label attribute definition + * in HTML 4.0. + */ + public String getLabel(); + public void setLabel(String label); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLOptionElement.java b/java/external/src/org/w3c/dom/html/HTMLOptionElement.java new file mode 100644 index 0000000..861d798 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLOptionElement.java @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * A selectable choice. See the OPTION element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLOptionElement extends HTMLElement { + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * 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. Changing + * defaultSelected, however, resets the state of the form + * control. See the selected attribute definition in HTML 4.0. + */ + public boolean getDefaultSelected(); + public void setDefaultSelected(boolean defaultSelected); + + /** + * The text contained within the option element. + */ + public String getText(); + + /** + * The index of this OPTION in its parent SELECT + * , starting from 0. + */ + public int getIndex(); + + /** + * The control is unavailable in this context. See the disabled attribute + * definition in HTML 4.0. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * Option label for use in hierarchical menus. See the label attribute + * definition in HTML 4.0. + */ + public String getLabel(); + public void setLabel(String label); + + /** + * 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. + */ + public boolean getSelected(); + public void setSelected(boolean selected); + + /** + * The current form control value. See the value attribute definition in + * HTML 4.0. + */ + public String getValue(); + public void setValue(String value); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLParagraphElement.java b/java/external/src/org/w3c/dom/html/HTMLParagraphElement.java new file mode 100644 index 0000000..1a891e1 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLParagraphElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Paragraphs. See the P element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLParagraphElement extends HTMLElement { + /** + * Horizontal text alignment. See the align attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLParamElement.java b/java/external/src/org/w3c/dom/html/HTMLParamElement.java new file mode 100644 index 0000000..6c08697 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLParamElement.java @@ -0,0 +1,50 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Parameters fed to the OBJECT element. See the PARAM element + * definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLParamElement extends HTMLElement { + /** + * The name of a run-time parameter. See the name attribute definition in + * HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Content type for the value attribute when + * valuetype has the value "ref". See the type attribute + * definition in HTML 4.0. + */ + public String getType(); + public void setType(String type); + + /** + * The value of a run-time parameter. See the value attribute definition + * in HTML 4.0. + */ + public String getValue(); + public void setValue(String value); + + /** + * Information about the meaning of the value attribute + * value. See the valuetype attribute definition in HTML 4.0. + */ + public String getValueType(); + public void setValueType(String valueType); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLPreElement.java b/java/external/src/org/w3c/dom/html/HTMLPreElement.java new file mode 100644 index 0000000..5b292b9 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLPreElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Preformatted text. See the PRE element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLPreElement extends HTMLElement { + /** + * Fixed width for content. See the width attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public int getWidth(); + public void setWidth(int width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLQuoteElement.java b/java/external/src/org/w3c/dom/html/HTMLQuoteElement.java new file mode 100644 index 0000000..f78a746 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLQuoteElement.java @@ -0,0 +1,28 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * For the Q and BLOCKQUOTE elements. See the Q + * element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLQuoteElement extends HTMLElement { + /** + * A URI designating a source document or message. See the cite attribute + * definition in HTML 4.0. + */ + public String getCite(); + public void setCite(String cite); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLScriptElement.java b/java/external/src/org/w3c/dom/html/HTMLScriptElement.java new file mode 100644 index 0000000..39924f1 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLScriptElement.java @@ -0,0 +1,66 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Script statements. See the SCRIPT element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLScriptElement extends HTMLElement { + /** + * The script content of the element. + */ + public String getText(); + public void setText(String text); + + /** + * Reserved for future use. + */ + public String getHtmlFor(); + public void setHtmlFor(String htmlFor); + + /** + * Reserved for future use. + */ + public String getEvent(); + public void setEvent(String event); + + /** + * The character encoding of the linked resource. See the charset + * attribute definition in HTML 4.0. + */ + public String getCharset(); + public void setCharset(String charset); + + /** + * Indicates that the user agent can defer processing of the script. See + * the defer attribute definition in HTML 4.0. + */ + public boolean getDefer(); + public void setDefer(boolean defer); + + /** + * URI designating an external script. See the src attribute definition in + * HTML 4.0. + */ + public String getSrc(); + public void setSrc(String src); + + /** + * The content type of the script language. See the type attribute + * definition in HTML 4.0. + */ + public String getType(); + public void setType(String type); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLSelectElement.java b/java/external/src/org/w3c/dom/html/HTMLSelectElement.java new file mode 100644 index 0000000..7c428c4 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLSelectElement.java @@ -0,0 +1,130 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.DOMException; + +/** + * The select element allows the selection of an option. The contained options + * can be directly accessed through the select element as a collection. See + * the SELECT element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLSelectElement extends HTMLElement { + /** + * 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. + */ + public String getType(); + + /** + * 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. + */ + public int getSelectedIndex(); + public void setSelectedIndex(int selectedIndex); + + /** + * The current form control value. + */ + public String getValue(); + public void setValue(String value); + + /** + * The number of options in this SELECT. + */ + public int getLength(); + + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * The collection of OPTION elements contained by this + * element. + */ + public HTMLCollection getOptions(); + + /** + * The control is unavailable in this context. See the disabled attribute + * definition in HTML 4.0. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * If true, multiple OPTION elements may be selected in this + * SELECT. See the multiple attribute definition in HTML + * 4.0. + */ + public boolean getMultiple(); + public void setMultiple(boolean multiple); + + /** + * Form control or object name when submitted with a form. See the name + * attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * Number of visible rows. See the size attribute definition in HTML 4.0. + */ + public int getSize(); + public void setSize(int size); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * Add a new element to the collection of OPTION elements for + * this SELECT. + * @param element The element to add. + * @param before The element to insert before, or null for + * the tail of the list. + * @exception DOMException + * NOT_FOUND_ERR: Raised if before is not a descendant of + * the SELECT element. + */ + public void add(HTMLElement element, + HTMLElement before) + throws DOMException; + + /** + * Remove an element from the collection of OPTION elements + * for this SELECT. Does nothing if no element has the + * given index. + * @param index The index of the item to remove, starting from 0. + */ + public void remove(int index); + + /** + * Removes keyboard focus from this element. + */ + public void blur(); + + /** + * Gives keyboard focus to this element. + */ + public void focus(); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLStyleElement.java b/java/external/src/org/w3c/dom/html/HTMLStyleElement.java new file mode 100644 index 0000000..c94edd2 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLStyleElement.java @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Style information. A more detailed style sheet object model is planned to + * be defined in a separate document. See the STYLE element definition in + * HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLStyleElement extends HTMLElement { + /** + * Enables/disables the style sheet. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * Designed for use with one or more target media. See the media attribute + * definition in HTML 4.0. + */ + public String getMedia(); + public void setMedia(String media); + + /** + * The content type of the style sheet language. See the type attribute + * definition in HTML 4.0. + */ + public String getType(); + public void setType(String type); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTableCaptionElement.java b/java/external/src/org/w3c/dom/html/HTMLTableCaptionElement.java new file mode 100644 index 0000000..62fc3a8 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTableCaptionElement.java @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Table caption See the CAPTION element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTableCaptionElement extends HTMLElement { + /** + * Caption alignment with respect to the table. See the align attribute + * definition in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTableCellElement.java b/java/external/src/org/w3c/dom/html/HTMLTableCellElement.java new file mode 100644 index 0000000..3bfb4bf --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTableCellElement.java @@ -0,0 +1,125 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * The object used to represent the TH and TD + * elements. See the TD element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTableCellElement extends HTMLElement { + /** + * The index of this cell in the row, starting from 0. This index is in + * document tree order and not display order. + */ + public int getCellIndex(); + + /** + * Abbreviation for header cells. See the abbr attribute definition in + * HTML 4.0. + */ + public String getAbbr(); + public void setAbbr(String abbr); + + /** + * Horizontal alignment of data in cell. See the align attribute definition + * in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Names group of related headers. See the axis attribute definition in + * HTML 4.0. + */ + public String getAxis(); + public void setAxis(String axis); + + /** + * Cell background color. See the bgcolor attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBgColor(); + public void setBgColor(String bgColor); + + /** + * Alignment character for cells in a column. See the char attribute + * definition in HTML 4.0. + */ + public String getCh(); + public void setCh(String ch); + + /** + * Offset of alignment character. See the charoff attribute definition in + * HTML 4.0. + */ + public String getChOff(); + public void setChOff(String chOff); + + /** + * Number of columns spanned by cell. See the colspan attribute definition + * in HTML 4.0. + */ + public int getColSpan(); + public void setColSpan(int colSpan); + + /** + * List of id attribute values for header cells. See the + * headers attribute definition in HTML 4.0. + */ + public String getHeaders(); + public void setHeaders(String headers); + + /** + * Cell height. See the height attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getHeight(); + public void setHeight(String height); + + /** + * Suppress word wrapping. See the nowrap attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getNoWrap(); + public void setNoWrap(boolean noWrap); + + /** + * Number of rows spanned by cell. See the rowspan attribute definition in + * HTML 4.0. + */ + public int getRowSpan(); + public void setRowSpan(int rowSpan); + + /** + * Scope covered by header cells. See the scope attribute definition in + * HTML 4.0. + */ + public String getScope(); + public void setScope(String scope); + + /** + * Vertical alignment of data in cell. See the valign attribute definition + * in HTML 4.0. + */ + public String getVAlign(); + public void setVAlign(String vAlign); + + /** + * Cell width. See the width attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTableColElement.java b/java/external/src/org/w3c/dom/html/HTMLTableColElement.java new file mode 100644 index 0000000..07f1c77 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTableColElement.java @@ -0,0 +1,62 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Regroups the COL and COLGROUP elements. See the + * COL element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTableColElement extends HTMLElement { + /** + * Horizontal alignment of cell data in column. See the align attribute + * definition in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Alignment character for cells in a column. See the char attribute + * definition in HTML 4.0. + */ + public String getCh(); + public void setCh(String ch); + + /** + * Offset of alignment character. See the charoff attribute definition in + * HTML 4.0. + */ + public String getChOff(); + public void setChOff(String chOff); + + /** + * Indicates the number of columns in a group or affected by a grouping. + * See the span attribute definition in HTML 4.0. + */ + public int getSpan(); + public void setSpan(int span); + + /** + * Vertical alignment of cell data in column. See the valign attribute + * definition in HTML 4.0. + */ + public String getVAlign(); + public void setVAlign(String vAlign); + + /** + * Default column width. See the width attribute definition in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTableElement.java b/java/external/src/org/w3c/dom/html/HTMLTableElement.java new file mode 100644 index 0000000..320a9d5 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTableElement.java @@ -0,0 +1,187 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.DOMException; + +/** + * The create* and delete* methods on the table allow authors to construct and + * modify tables. HTML 4.0 specifies that only one of each of the + * CAPTION, THEAD, and TFOOT elements + * may exist in a table. Therefore, if one exists, and the createTHead() or + * createTFoot() method is called, the method returns the existing THead or + * TFoot element. See the TABLE element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTableElement extends HTMLElement { + /** + * Returns the table's CAPTION, or void if none exists. + */ + public HTMLTableCaptionElement getCaption(); + public void setCaption(HTMLTableCaptionElement caption); + + /** + * Returns the table's THEAD, or null if none + * exists. + */ + public HTMLTableSectionElement getTHead(); + public void setTHead(HTMLTableSectionElement tHead); + + /** + * Returns the table's TFOOT, or null if none + * exists. + */ + public HTMLTableSectionElement getTFoot(); + public void setTFoot(HTMLTableSectionElement tFoot); + + /** + * Returns a collection of all the rows in the table, including all in + * THEAD, TFOOT, all TBODY + * elements. + */ + public HTMLCollection getRows(); + + /** + * Returns a collection of the defined table bodies. + */ + public HTMLCollection getTBodies(); + + /** + * Specifies the table's position with respect to the rest of the + * document. See the align attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Cell background color. See the bgcolor attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBgColor(); + public void setBgColor(String bgColor); + + /** + * The width of the border around the table. See the border attribute + * definition in HTML 4.0. + */ + public String getBorder(); + public void setBorder(String border); + + /** + * Specifies the horizontal and vertical space between cell content and + * cell borders. See the cellpadding attribute definition in HTML 4.0. + */ + public String getCellPadding(); + public void setCellPadding(String cellPadding); + + /** + * Specifies the horizontal and vertical separation between cells. See the + * cellspacing attribute definition in HTML 4.0. + */ + public String getCellSpacing(); + public void setCellSpacing(String cellSpacing); + + /** + * Specifies which external table borders to render. See the frame + * attribute definition in HTML 4.0. + */ + public String getFrame(); + public void setFrame(String frame); + + /** + * Specifies which internal table borders to render. See the rules + * attribute definition in HTML 4.0. + */ + public String getRules(); + public void setRules(String rules); + + /** + * Description about the purpose or structure of a table. See the summary + * attribute definition in HTML 4.0. + */ + public String getSummary(); + public void setSummary(String summary); + + /** + * Specifies the desired table width. See the width attribute definition + * in HTML 4.0. + */ + public String getWidth(); + public void setWidth(String width); + + /** + * Create a table header row or return an existing one. + * @return A new table header element (THEAD). + */ + public HTMLElement createTHead(); + + /** + * Delete the header from the table, if one exists. + */ + public void deleteTHead(); + + /** + * Create a table footer row or return an existing one. + * @return A footer element (TFOOT). + */ + public HTMLElement createTFoot(); + + /** + * Delete the footer from the table, if one exists. + */ + public void deleteTFoot(); + + /** + * Create a new table caption object or return an existing one. + * @return A CAPTION element. + */ + public HTMLElement createCaption(); + + /** + * Delete the table caption, if one exists. + */ + public void deleteCaption(); + + /** + * 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.0 Recommendation. + * @param index 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 The newly created row. + * @exception DOMException + * INDEX_SIZE_ERR: Raised if the specified index is greater than the + * number of rows or if the index is negative. + */ + public HTMLElement insertRow(int index) + throws DOMException; + + /** + * Delete a table row. + * @param index 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. + * @exception 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. + */ + public void deleteRow(int index) + throws DOMException; + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTableRowElement.java b/java/external/src/org/w3c/dom/html/HTMLTableRowElement.java new file mode 100644 index 0000000..0cc8a0f --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTableRowElement.java @@ -0,0 +1,101 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.DOMException; + +/** + * A row in a table. See the TR element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTableRowElement extends HTMLElement { + /** + * 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. + */ + public int getRowIndex(); + + /** + * The index of this row, relative to the current section ( + * THEAD, TFOOT, or TBODY), + * starting from 0. + */ + public int getSectionRowIndex(); + + /** + * The collection of cells in this row. + */ + public HTMLCollection getCells(); + + /** + * Horizontal alignment of data within cells of this row. See the align + * attribute definition in HTML 4.0. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Background color for rows. See the bgcolor attribute definition in HTML + * 4.0. This attribute is deprecated in HTML 4.0. + */ + public String getBgColor(); + public void setBgColor(String bgColor); + + /** + * Alignment character for cells in a column. See the char attribute + * definition in HTML 4.0. + */ + public String getCh(); + public void setCh(String ch); + + /** + * Offset of alignment character. See the charoff attribute definition in + * HTML 4.0. + */ + public String getChOff(); + public void setChOff(String chOff); + + /** + * Vertical alignment of data within cells of this row. See the valign + * attribute definition in HTML 4.0. + */ + public String getVAlign(); + public void setVAlign(String vAlign); + + /** + * Insert an empty TD cell into this row. If + * index is equal to the number of cells, the new cell is + * appended. + * @param index The place to insert the cell, starting from 0. + * @return The newly created cell. + * @exception DOMException + * INDEX_SIZE_ERR: Raised if the specified index is greater + * than the number of cells or if the index is negative. + */ + public HTMLElement insertCell(int index) + throws DOMException; + + /** + * Delete a cell from the current row. + * @param index The index of the cell to delete, starting from 0. + * @exception 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. + */ + public void deleteCell(int index) + throws DOMException; + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTableSectionElement.java b/java/external/src/org/w3c/dom/html/HTMLTableSectionElement.java new file mode 100644 index 0000000..c3c8068 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTableSectionElement.java @@ -0,0 +1,84 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +import org.w3c.dom.DOMException; + +/** + * The THEAD, TFOOT, and TBODY + * elements. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTableSectionElement extends HTMLElement { + /** + * Horizontal alignment of data in cells. See the align + * attribute for HTMLTheadElement for details. + */ + public String getAlign(); + public void setAlign(String align); + + /** + * Alignment character for cells in a column. See the char attribute + * definition in HTML 4.0. + */ + public String getCh(); + public void setCh(String ch); + + /** + * Offset of alignment character. See the charoff attribute definition in + * HTML 4.0. + */ + public String getChOff(); + public void setChOff(String chOff); + + /** + * Vertical alignment of data in cells. See the valign + * attribute for HTMLTheadElement for details. + */ + public String getVAlign(); + public void setVAlign(String vAlign); + + /** + * The collection of rows in this table section. + */ + public HTMLCollection getRows(); + + /** + * 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. + * @param index 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 The newly created row. + * @exception DOMException + * INDEX_SIZE_ERR: Raised if the specified index is greater than the + * number of rows or if the index is negative. + */ + public HTMLElement insertRow(int index) + throws DOMException; + + /** + * Delete a row from this section. + * @param index 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. + * @exception 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. + */ + public void deleteRow(int index) + throws DOMException; + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTextAreaElement.java b/java/external/src/org/w3c/dom/html/HTMLTextAreaElement.java new file mode 100644 index 0000000..e8cdc0d --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTextAreaElement.java @@ -0,0 +1,114 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Multi-line text field. See the TEXTAREA element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTextAreaElement extends HTMLElement { + /** + * 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. Changing this attribute, however, + * resets the contents of the form control. + */ + public String getDefaultValue(); + public void setDefaultValue(String defaultValue); + + /** + * Returns the FORM element containing this control. Returns + * null if this control is not within the context of a + * form. + */ + public HTMLFormElement getForm(); + + /** + * A single character access key to give access to the form control. See + * the accesskey attribute definition in HTML 4.0. + */ + public String getAccessKey(); + public void setAccessKey(String accessKey); + + /** + * Width of control (in characters). See the cols attribute definition in + * HTML 4.0. + */ + public int getCols(); + public void setCols(int cols); + + /** + * The control is unavailable in this context. See the disabled attribute + * definition in HTML 4.0. + */ + public boolean getDisabled(); + public void setDisabled(boolean disabled); + + /** + * Form control or object name when submitted with a form. See the name + * attribute definition in HTML 4.0. + */ + public String getName(); + public void setName(String name); + + /** + * This control is read-only. See the readonly attribute definition in + * HTML 4.0. + */ + public boolean getReadOnly(); + public void setReadOnly(boolean readOnly); + + /** + * Number of text rows. See the rows attribute definition in HTML 4.0. + */ + public int getRows(); + public void setRows(int rows); + + /** + * Index that represents the element's position in the tabbing order. See + * the tabindex attribute definition in HTML 4.0. + */ + public int getTabIndex(); + public void setTabIndex(int tabIndex); + + /** + * The type of this form control. This the string "textarea". + */ + public String getType(); + + /** + * 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. + */ + public String getValue(); + public void setValue(String value); + + /** + * Removes keyboard focus from this element. + */ + public void blur(); + + /** + * Gives keyboard focus to this element. + */ + public void focus(); + + /** + * Select the contents of the TEXTAREA. + */ + public void select(); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLTitleElement.java b/java/external/src/org/w3c/dom/html/HTMLTitleElement.java new file mode 100644 index 0000000..bfa67b2 --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLTitleElement.java @@ -0,0 +1,26 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * The document title. See the TITLE element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLTitleElement extends HTMLElement { + /** + * The specified title as a string. + */ + public String getText(); + public void setText(String text); + +} diff --git a/java/external/src/org/w3c/dom/html/HTMLUListElement.java b/java/external/src/org/w3c/dom/html/HTMLUListElement.java new file mode 100644 index 0000000..fa5b45f --- /dev/null +++ b/java/external/src/org/w3c/dom/html/HTMLUListElement.java @@ -0,0 +1,34 @@ +/* + * Copyright (c) 2000 World Wide Web Consortium, + * (Massachusetts Institute of Technology, Institut National de + * Recherche en Informatique et en Automatique, Keio University). All + * Rights Reserved. This program is distributed under the W3C's Software + * Intellectual Property License. This program is distributed in the + * hope that it will be useful, but WITHOUT ANY WARRANTY; without even + * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + * PURPOSE. + * See W3C License http://www.w3.org/Consortium/Legal/ for more details. + */ + +package org.w3c.dom.html; + +/** + * Unordered list. See the UL element definition in HTML 4.0. + *

See also the Document Object Model (DOM) Level 1 Specification (Second Edition). + */ +public interface HTMLUListElement extends HTMLElement { + /** + * Reduce spacing between list items. See the compact attribute definition + * in HTML 4.0. This attribute is deprecated in HTML 4.0. + */ + public boolean getCompact(); + public void setCompact(boolean compact); + + /** + * Bullet style. See the type attribute definition in HTML 4.0. This + * attribute is deprecated in HTML 4.0. + */ + public String getType(); + public void setType(String type); + +} diff --git a/java/external/src/org/w3c/dom/ranges/Range.java b/java/external/src/org/w3c/dom/ranges/Range.java index 7743abe..da0f53d 100644 --- a/java/external/src/org/w3c/dom/ranges/Range.java +++ b/java/external/src/org/w3c/dom/ranges/Range.java @@ -78,9 +78,9 @@ public interface Range { /** * Sets the attributes describing the start of the Range. - * @param refNodeThe refNode value. This parameter must be + * @param refNode The refNode value. This parameter must be * different from null. - * @param offsetThe startOffset value. + * @param offset The startOffset value. * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if refNode or an ancestor * of refNode is an Entity, Notation, or DocumentType @@ -100,9 +100,9 @@ public interface Range { /** * Sets the attributes describing the end of a Range. - * @param refNodeThe refNode value. This parameter must be + * @param refNode The refNode value. This parameter must be * different from null. - * @param offsetThe endOffset value. + * @param offset The endOffset value. * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if refNode or an ancestor * of refNode is an Entity, Notation, or DocumentType @@ -122,7 +122,7 @@ public interface Range { /** * Sets the start position to be before a node - * @param refNodeRange starts before refNode + * @param refNode Range starts before refNode * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if the root container of * refNode is not an Attr, Document, or DocumentFragment @@ -137,7 +137,7 @@ public interface Range { /** * Sets the start position to be after a node - * @param refNodeRange starts after refNode + * @param refNode Range starts after refNode * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if the root container of * refNode is not an Attr, Document, or DocumentFragment @@ -152,7 +152,7 @@ public interface Range { /** * Sets the end position to be before a node. - * @param refNodeRange ends before refNode + * @param refNode Range ends before refNode * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if the root container of * refNode is not an Attr, Document, or DocumentFragment @@ -167,7 +167,7 @@ public interface Range { /** * Sets the end of a Range to be after a node - * @param refNodeRange ends after refNode. + * @param refNode Range ends after refNode. * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if the root container of * refNode is not an Attr, Document or DocumentFragment @@ -182,7 +182,7 @@ public interface Range { /** * Collapse a Range onto one of its boundary-points - * @param toStartIf TRUE, collapses the Range onto its start; if FALSE, + * @param toStart If TRUE, collapses the Range onto its start; if FALSE, * collapses it onto its end. * @exception DOMException * INVALID_STATE_ERR: Raised if detach() has already been @@ -193,7 +193,7 @@ public interface Range { /** * Select a node and its contents - * @param refNodeThe node to select. + * @param refNode The node to select. * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if an ancestor of refNode * is an Entity, Notation or DocumentType node or if @@ -208,7 +208,7 @@ public interface Range { /** * Select the contents within a node - * @param refNodeNode to select from + * @param refNode Node to select from * @exception RangeException * INVALID_NODE_TYPE_ERR: Raised if refNode or an ancestor * of refNode is an Entity, Notation or DocumentType node. @@ -247,8 +247,8 @@ public interface Range { /** * Compare the boundary-points of two Ranges in a document. - * @param howA code representing the type of comparison, as defined above. - * @param sourceRangeThe Range on which this current + * @param how A code representing the type of comparison, as defined above. + * @param sourceRange The Range on which this current * Range is compared to. * @return -1, 0 or 1 depending on whether the corresponding * boundary-point of the Range is respectively before, equal to, or @@ -315,7 +315,7 @@ public interface Range { * automatically merged. If the node to be inserted is a * DocumentFragment node, the children will be inserted rather than the * DocumentFragment node itself. - * @param newNodeThe node to insert at the start of the Range + * @param newNode The node to insert at the start of the Range * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of the * start of the Range is read-only. @@ -338,7 +338,7 @@ public interface Range { /** * Reparents the contents of the Range to the given node and inserts the * node at the position of the start of the Range. - * @param newParentThe node to surround the contents with. + * @param newParent The node to surround the contents with. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if an ancestor container of * either boundary-point of the Range is read-only. diff --git a/java/external/src/org/w3c/dom/stylesheets/MediaList.java b/java/external/src/org/w3c/dom/stylesheets/MediaList.java index 92c4660..eaf152f 100644 --- a/java/external/src/org/w3c/dom/stylesheets/MediaList.java +++ b/java/external/src/org/w3c/dom/stylesheets/MediaList.java @@ -57,7 +57,7 @@ public interface MediaList { /** * Deletes the medium indicated by oldMedium from the list. - * @param oldMediumThe medium to delete in the media list. + * @param oldMedium The medium to delete in the media list. * @exception DOMException * NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. *
NOT_FOUND_ERR: Raised if oldMedium is not in the @@ -69,7 +69,7 @@ public interface MediaList { /** * Adds the medium newMedium to the end of the list. If the * newMedium is already used, it is first removed. - * @param newMediumThe new medium to add. + * @param newMedium The new medium to add. * @exception DOMException * INVALID_CHARACTER_ERR: If the medium contains characters that are * invalid in the underlying style language. diff --git a/java/external/src/org/w3c/dom/stylesheets/StyleSheetList.java b/java/external/src/org/w3c/dom/stylesheets/StyleSheetList.java index 76c0c59..b8f9a44 100644 --- a/java/external/src/org/w3c/dom/stylesheets/StyleSheetList.java +++ b/java/external/src/org/w3c/dom/stylesheets/StyleSheetList.java @@ -32,7 +32,7 @@ public interface StyleSheetList { * Used to retrieve a style sheet by ordinal index. If index is greater * than or equal to the number of style sheets in the list, this returns * null. - * @param indexIndex into the collection + * @param index Index into the collection * @return The style sheet at the index position in the * StyleSheetList, or null if that is not a * valid index. diff --git a/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java b/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java index 0acd5f4..d27a9f1 100644 --- a/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java +++ b/java/external/src/org/w3c/dom/traversal/DocumentTraversal.java @@ -29,19 +29,19 @@ public interface DocumentTraversal { /** * Create a new NodeIterator over the subtree rooted at the * specified node. - * @param rootThe node which will be iterated together with its children. + * @param root The node which will be iterated together with its children. * The iterator is initially positioned just before this node. The * whatToShow flags and the filter, if any, are not * considered when setting this position. The root must not be * null. - * @param whatToShowThis flag specifies which node types may appear in + * @param whatToShow This flag specifies which node types may appear in * the logical view of the tree presented by the iterator. See the * description of NodeFilter for the set of possible * SHOW_ values.These flags can be combined using * OR. - * @param filterThe NodeFilter to be used with this + * @param filter The NodeFilter to be used with this * TreeWalker, or null to indicate no filter. - * @param entityReferenceExpansionThe value of this flag determines + * @param entityReferenceExpansion The value of this flag determines * whether entity reference nodes are expanded. * @return The newly created NodeIterator. * @exception DOMException @@ -57,7 +57,7 @@ public interface DocumentTraversal { /** * Create a new TreeWalker over the subtree rooted at the * specified node. - * @param rootThe node which will serve as the root for the + * @param root The node which will serve as the root for the * TreeWalker. The whatToShow flags and the * NodeFilter are not considered when setting this value; * any node type will be accepted as the root. The @@ -67,13 +67,13 @@ public interface DocumentTraversal { * methods that look upward in the document structure, such as * parentNode and nextNode. The root must * not be null. - * @param whatToShowThis flag specifies which node types may appear in + * @param whatToShow This flag specifies which node types may appear in * the logical view of the tree presented by the tree-walker. See the * description of NodeFilter for the set of possible * SHOW_ values.These flags can be combined using OR. - * @param filterThe NodeFilter to be used with this + * @param filter The NodeFilter to be used with this * TreeWalker, or null to indicate no filter. - * @param entityReferenceExpansionIf this flag is false, the contents of + * @param entityReferenceExpansion If this flag is false, the contents of * EntityReference nodes are not presented in the logical * view. * @return The newly created TreeWalker. diff --git a/java/external/src/org/w3c/dom/traversal/NodeFilter.java b/java/external/src/org/w3c/dom/traversal/NodeFilter.java index d8eaae6..1fcff59 100644 --- a/java/external/src/org/w3c/dom/traversal/NodeFilter.java +++ b/java/external/src/org/w3c/dom/traversal/NodeFilter.java @@ -133,7 +133,7 @@ public interface NodeFilter { * NodeIterator; it is not normally called directly from * user code. (Though you could do so if you wanted to use the same * filter to guide your own application logic.) - * @param nThe node to check to see if it passes the filter or not. + * @param n The node to check to see if it passes the filter or not. * @return a constant to determine whether the node is accepted, * rejected, or skipped, as defined above. */