[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: New draft snapshot
Hi all, Attached you will find the latest version of the WebCGM DOM spec. What's new in this version... -Added the Event interface. -Added the EventListener interface. -Added the addEventListener method to the Picture interface. -Added the Hyperlink interface. -Added the DOMStringList interface. -Changed the METADATA_ELEMENT_NODE type to XML_METADATA_NODE. -Added wording to sections 1.1.b, 1.1.2 and 1.2 Questions that need to be answered... -Should the DOM be able to handle whitespaces? Do you think that specialized applications (wiring or others) will include xml:space="preserve" in the XML companion file? What are the user expectations regarding to this? -What happens if we are listening to the 'click' event on an object that has a linkuri attribute on it? Are both executed, which one comes first? Do we need the preventDefault() method to handle this or just a set of rules, please refer to the DOM Level 2 spec for more info on preventDefault(). -How should we deal with entities in XML companion file? Is a viewer suppose to resolve them? -Should we allow the character-height to be expressed in pt? -Do we need relatedTarget on the Event interface? I believe that some of the existing API offer something like this? Is it needed, is it useful? What's still missing... -The XML companion file DTD. (Dave) -Picture of architecture. (Benoit) -Wording for the Highlight() method. (all) -More comments on the spec. (all) I think we are getting there, but we still have a small number of details to work out (enumerated in this email). Thank you for your time and effort. Regards, -- Benoit mailto:benoit@itedo.comTitle: WebCGM DOM
WebCGM Document Object Model (DOM) SpecificationVersion 1.0Working Draft June 21, 2004This version:Latest version:Previous version:Editors:Authors:AbstractStatus of this documentTable of contentsExpanded Table of Contents Copyright Notice 1. WebCGM Document Object Model Appendix A: Changes Appendix B: IDL Definitions Appendix C: ECMAScript Language Binding Appendix D: Acknowledgements Glossary References Index 1. WebCGM Document Object Model1.1 Overview of the WebCGM DOM InterfacesThis section defines a set of objects and interfaces for accessing and manipulating WebCGM documents. The functionality specified in this section is to allow script writers to manipulate WebCGM documents and to access information found in standard WebCGM XML companion files. The WebCGM DOM API does not allow for the creation of new Nodes but instead provides methods to update a WebCGM Picture based on external metadata (XML companion file). 1.1.b Relationship with XML DOM Level 3Although inspired by the DOM Level 2 and Level 3 specifications, the WebCGM DOM remains oriented towards WebCGM specific functionality. Since WebCGM uses a tree structure to group graphical primitives, it was therefore appropriate to use interfaces similar to DOM Level 3 Node, Element and Document. However, since WebCGM is expressed in a non-XML syntax, several changes had to be made to a number of commonly known interfaces to improve the user experience for WebCGM script writers. The WebCGM DOM could almost be perceived as a 'readonly' DOM. It is true that some methods on interfaces allow users to change an Application Structure style but, unlike the DOM Level 3 specification, it does not allow for removal or insertion of new Nodes into the object model. This constitute a significant difference between DOM Level 3 and the WebCGM DOM. Since WebCGM currently offers interactivity functionality via hyperlinking and highlighting; the WebCGM DOM is based on some functionality found in the DOM Events Level 2 specification. The WebCGM DOM is making use of the addEventListener method and also customized an Event interface in order to meet the requirements of WebCGM users. 1.1.1 Relationship with XML companion fileThe WebCGM DOM is designed to provide access to XML metadata found in XML companion files. Practice has shown that some CGM illustrations are easier to maintain if some of the non graphical information remains outside the illustration. An example of such information could be for example; language sensitive tooltips. A scaled down DOM is then required to 'attach' the information from the XML companion file into the WebCGM document. For more information on XML companion files, please refer to the WebCGM XML companion file section. Another benefit of the XML companion file is to carry application specific data (or metadata) concerning a WebCGM illustration. This information is expressed using namespace attributes and elements in the XML companion file. The WebCGM DOM provides method to load the XML metadata into the user agent's (viewer's) object model. Using the DOM, a user can gain access to the metadata. Here is an example to better illustrate the concept, let us assume we are working with the following WebCGM document (expressed in clearText encoding):
The in memory tree representation of this illustration should be similar to the illustration found below. It is a simple tree structure with a root element Metafile, one of the children of the root is a Picture; the Picture contains a Layer and the layer contains an Application Structure of type grobject. Now let us assume example.cgm has the following XML companion file for...
As mentioned above, the WebCGM provides methods to 'apply' an XML companion file to a WebCGM document. A comforming user agent is expected to load and parse the XML companion file and possibly 'apply' the XML companion file to the user agent's object model. The purpose of applying a companion file is to: i) Replace standard Application Structure Attributes that are present in the WebCGM instance with new values (if found in XML companion file). ii) Supply standard Application Structure Attributes to Application Structures in the WebCGM instance that contain no values. iii) Add XML metadata to the user agent's object model to be retrieved using DOM APIs at a later stage (e.g., the <wiring:data> element is added as a child node of grobject G1; this would then allow the data to be used in an interactive -scripted- wiring application). Once the user agent has loaded the XML companion file into its memory model, the tree should resemble this: 1.1.2 Basic Data TypesType definition DOMString A DOMString is a sequence of 16-bit units. IDL Definition
In WebCGM, like DOM Level 3, the UTF-16 encoding was chosen because of its widespread industry practice. For Java and ECMAScript, DOMString is bound to the String type because both languages also use UTF-16 as their encoding.The DOM has many interfaces that imply string matching. For XML, string comparisons are case-sensitive and performed with a binary comparison of the 16-bit units of the DOMStrings. 1.1.3 Coordinate valuesNeed wording to say: Origin at lower left corner, width and height represent the VDC extent, coordinate axes x to the right, y up. Coordinate values are the resulting values after having read the WebCGM. 1.2 Fundamental InterfacesThe interfaces within this section are considered fundamental, and must be
fully implemented by all conforming implementations of the WebCGM DOM. The
WebCGM DOM presents WebCGM documents as a hierarchy of
The WebCGM DOM also specifices several other interfaces to facilitate
access to WebCGM attributes. The Exception DOMExceptionWebCGM operations only raise exceptions when an operation is impossible to perform. IDL Definition
Definition group ExceptionCode An integer indicating the type of error generated Defined Constants INDEX_SIZE_ERR; if index or size is negative, or greater than the allowed value. DOMSTRING_SIZE_ERR; if the specified range of text does not fit into a DOMString. INVALID_CHARACTER_ERR; if an invalid or illegal character is specified, such as in an XML name. NO_DATA_ALLOWED_ERR; if data is specified for a node which does not support data. NO_MODIFICATION_ALLOWED_ERR; if an attempt is made to modify an object where modifications are not allowed. NOT_SUPPORTED_ERR; if the implementation does not support the requested type of object or operation. INVALID_ACCESS_ERR; if a parameter or an operation is not supported by the underlying object. VALIDATION_ERR; if a call to a method such as insertBefore or removeChild would make the Node invalid with respect to "partial validity", this exception would be raised and the operation would not be done. This code is used in [DOM Level 3 Validation]. Refer to this specification for further information. FILE_NOT_FOUND_ERR; if the reference document could not be accessed FILE_INCOMPATIBILITY_ERR; if the reference document was not well-formed or in error. Interface GetWebCGMDocumentSince WebCGM documents are often embedded within a host document such as XHTML, WebCGM user agents are required to implement the GetWebCGMDocument interface for the element which references the WebCGM document (e.g., the 'object' tag). IDL Definition
Methods getWebCGMDocument Returns the Metafile object for the referenced WebCGM document. No parameters Return value Metafile; The Metafile object for the referenced WebCGM document. Exceptions DOMException; NOT_SUPPORTED_ERR: No Metafile object is available. Interface MetafileThe Metafile interface is the entry point to the entire WebCGM document. The interface expose information regarding the metafile and provides access to the first Picture of the WebCGM document. IDL Definition
Attributes metafileDescription of type DOMString, readonly Returns the Metafile Descriptor of the WebCGM document (e.g., "ProfileId:WebCGM,ProfileEd:1.0,Source:A software vendor,Date:20040602,ColourClass:monochrome" ). The cgmDescription must contain the ProfileId: and the ProfileEd:, other information such as Source, ColourClass etc... is considered optional. firstPicture of type Picture, readonly Returns the first Picture element of the WebCGM document. Subsequent Pictures can be accessed using the Picture interface. A WebCGM document contains at least one Picture. metafileID of type DOMString, readonly Returns the Metafile Identifier (also known as the cgm ID). metafileVersion of type integer, readonly Returns the Metafile Version of the WebCGM document. Interface NodeThe Node interface is the base datatype of the WebCGM Document Object Model. The Node object is the basis of several other interfaces; XMLElements and WebCGM specific elements (i.e., AppStructure & Picture). The Node interface specifies the attributes and methods to perform simple and generic tree traversal routines. IDL Definition
Definition group NodeType An integer indicating which type of node this is. Defined Constants: PICTURE_NODE; the node is a Picture. APP_STRUCTURE_NODE; the node is an AppStructure. XML_METADATA_NODE; the node is XML companion information attached to a CGM element. TEXT_NODE; the node is a Text. ATTR_NODE; the node is an Attr. The values of nodeName and nodeValue vary according to the node type as follows:
Attributes nodeName of type DOMString, readonly The name of this node, depending on its type; see the table above. nodeValue of type DOMString, readonly The value of this node, depending on its type; see the table above. Exceptions on retrieval DOMException; DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform. nodeType of type unsigned short, readonly A code representing the type of the underlying object, see the table above. parentNode of type Node, readonly The parent (immediate ancestor node of a node) of this node. All nodes, except Picture may have a parent. childNodes of type NodeList, readonly A NodeList that contains all children of this node. If there are no children, this returns an empty NodeList. firstChild of type Node, readonly The first child of this node. If there is no such node, this returns null. lastChild of type Node, readonly The last child of this node. If there is no such node, this returns null. previousSibling of type Node, readonly The node immediately preceding this node. If there is no such node, this returns null. nextSibling of type Node, readonly The node immediately following this node. If there is no such node, this returns null. ownerPicture of type Picture, readonly The Picture object associated with this node. When the node is a Picture node, this returns null. attributes of type NodeList, A NodeList containing the attributes (Application Structure and namespace attributes) of this node (must be a XML_METADATA_NODE, PICTURE_NODE or APP_STRUCTURE_NODE), null otherwise. For APP_STRUCTURE_NODE, all nodes within the NodeList are of type Attr exception for linkuri attributes, they are Hyperlink nodes. namespaceURI of type DOMString, readonly The namespace URI of this node (e.g., elementName xmlns="http://www.example.org/2004", returns "http://www.example.org/2004"). This returns null if the Node is not of type XML_METADATA_NODE. prefix of type DOMString, readonly The namespace prefix of this node (e.g., foo:elementName, returns "foo"). This returns null if the Node is not of type XML_METADATA_NODE. localName of type DOMString, readonly Returns the local part of the qualified name of this node (e.g., foo:elementName, returns "elementName"). This returns null if the Node is not of type XML_METADATA_NODE. Methods hasChildNodes Returns whether this node has any children. No Parameters Return Value boolean; true if this node has any children, false otherwise. No Exceptions hasAttributes Returns whether this node (if of type XML_METADATA_NODE) has any attributes. No Parameters Return Value boolean; true if this node has any attributes, false otherwise. Exceptions INVALID_ACCESS_ERR if called on a non XML_METADATA_NODE object. hasAttributeNS Returns true when an attribute with a given local name and namespace URI is specified on this Node (must be of type XML_METADATA_NODE), returns false otherwise. No Parameters Return Value boolean; true if this node has any children, false otherwise. Exceptions INVALID_ACCESS_ERR if called on a non XML_METADATA_NODE object. getAttributeNS Returns the node (must be of type XML_METADATA_NODE) attribute value by local name and namespace URI. Parameters namespaceURI of type DOMString The namespace URI of the attribute to retrieve. localName of type DOMString The local name of the attribute to retrieve. Return Value DOMString; The Attr value as a string, or the empty string if that attribute does not have a specified value. Exceptions INVALID_ACCESS_ERR if called on a non XML_METADATA_NODE object. getElementsByTagNameNS Returns a NodeList of all the descendant XML element (companion information) with a given local name and namspace URI in the order in which they are encountered in a preorder traversal of the Node tree. Parameters namespaceURI of type DOMString The namespace URI of the XML elements to match on. localName of type DOMString The local name of the XML elements to match on. Return Value NodeList; A list of matching XML element nodes. No Exceptions getElementsByAttrNameValueNS
No Parameters Return Value No Exceptions Interface PictureThe Picture interface allows for access to the application structures of the WebCGM document. It also specifies how to load an XML companion file into a WebCGM document. IDL Definition
Attributes width of type number, readonly Represents the Picture width in millimeters. Please refer to Coordinate Values section for more information. height of type number, readonly Represents the Picture height in millimeters. Please refer to Coordinate Values section for more information. Methods addEventListener This method allows the registration of event listeners on the current Picture node. If an EventListener is added to the Picture while it is processing an event, it will not be triggered by the current actions. If multiple identical EventListeners are registered on the same Picture with the same parameters the duplicate instances are discarded. They do not cause the EventListener to be called twice. Parameters type of type DOMString The event type for which the user is registering, (for example: "click", "mousemove"). EventListener of type EventListener The listener parameter takes an interface implemented by the user which contains the methods to be called when the event occurs. No Return Value No Exceptions applyCompanionFile The applyCompanionFile reads an XML companion file into the user agent's object model. If companion information is found in the companion file (in the form of namespace attributes and namespace children elements), the user agent will create new namespace application structures as children of existing WebCGM Application Structures within it's object model. This information will then be accessible using methods found on the Picture, AppStructure and Node interfaces. Depending on the parameters, the applyCompanionFile method may or may not 'apply' the XML companion file. Please refer to the Relationship with XML companion file section for more detail. Parameters fileURI of type DOMString The file name and location of the XML companion file to load and apply into the object model. refresh of type boolean When set to true, the method will delete any additional companion information that was added to the object model from a previous applyCompanionFile; a value of false implies that the caller may be loading companion information in addition to already loaded companion information. Return value boolean; true if the implementation was able to load and parse the XML companion file into memory as requested; false otherwise. Exceptions FILE_NOT_FOUND_ERR; if the reference document could not be accessed. Exceptions FILE_INCOMPATIBILITY_ERR; if the reference document was not well-formed or in error. getAppStructureById Returns the Application Structure whose ID is given by apsId. If no such Application Structure exists, returns null. Behavior is not defined if more than one element has this ID. The method does not apply to XML_METADATA_NODEs. Parameters apsId of type DOMString The unique id value for an Application Structure. Return value Node; the matching Application Structure. No Exceptions getAppStructuresByName Returns the list of Application Structures whose name are given by apsName. If no such Application Structures exists, returns null. The method does not apply to XML_METADATA_NODEs. Parameters apsName of type DOMString A non-unique name value for an Application Structure. Return value NodeList; the matching Application Structures. No Exceptions getAppStructuresByType Returns a NodeList of all Application Structures of the given type in the order in which they are encountered in a preorder traversal of the Picture tree. Possible values for WebCGM 1.0 Application Structure types are 'layer','grobject', 'para', 'subpara'. Parameters apsType of type DOMString The name of the Application Structure type to match on. Return value NodeList; A new NodeList object containing all the matched Application Struture Nodes. No Exceptions highlight Highlights a collection of Application Structures.
Parameters nodes of type NodeList A NodeList of APP_STRUCTURE_NODEs to highlight. state of type boolean A true value with highlight the nodes, where as false will remove the highlight. No Return value No Exceptions setStyleAttr Set a style attribute at the picture level by name. The following table describes in more details each style attribute, their scope and allowed values:
Note: Descriptions of all style attributes have to be provided. stroke-color includes CGM attributes edge-color, line-color and marker-color. stroke-weight includes CGM attributes edge-weight and line-weight. RGB colors are expressed has hexadecimal values. Absolute mm are expressed with a number followed by the 'mm' unit, ex: "3mm". Relative scale values are expressed as a number followed by a '%' unit, ex: "225%", the value can exceed 100%. Relative intensity values are expressed as a number followed by a '%' unit, ex: "75%", the value cannot exceed 100%.
Parameters style of type DOMString The name of the style attribute to modify. value of type DOMString The new value for the given style. No Return value No Exceptions clearStyleAttr Restores a style attribute to its original value (load time). Parameters style of type DOMString The name of the style attribute. The special value "*" matches all style attributes. No Return value No Exceptions clearData Removes all XML companion information that was loaded into the user agent's object model from one or multiple applyCompanionFile calls. The method clearData does not reset Application Structure attributes to their inital values if they were modified by an applyCompanionFile call, the purpose of this method is to remove additional companion information from the object model. No Parameters No Return value No Exceptions Interface AppStructureThe AppStructure interface offers method for setting and retrieving Application Structure attributes. The general methods for accessing Application Structure attributes are getAppStructureAttr and setAppStructureAttr, however; since some attributes are allowed to be set multiple times (e.g., linkuri), specific methods are offered for certain attributes. The following table identifies the attributes which can get access using getAppStructureAttr and setAppStructureAtt:
Note: Descriptions of all Application Structure attributes have to be provided. The AppStructure interface, like the Picture interface, provides methods for modifying style attributes at the Application Structure level. For more information about available style attribute, refer to the Style Attributes Table. IDL Definition
Attributes apsId of type DOMString, readonly The unique identifier of the Application Structure. Methods getAppStructureAttr Gets an Application Structure attribute by name. Please refer to the Application Structure Attributes table for more detailed information on retrievable and modifiable Application Structure attributes. Parameters name of type DOMString The name of the Application Structure attribute to retrieve. No Return value No Exceptions setAppStructureAttr Sets an Application Structure attribute by name. Please refer to the Application Structure Attributes table for more detailed information on retrievable and modifiable Application Structure attributes. Parameters name of type DOMString The name of the Application Structure attribute to set. value of type DOMString The new value for the given attribute. No Return value No Exceptions removeAppStructureAttr Removes an Application Structure attribute by name. Please refer to the Application Structure Attributes table for more detailed information on retrievable and modifiable Application Structure attributes. Parameters name of type DOMString The name of the Application Structure attribute to remove. No Return value No Exceptions getLinkuris Returns a list of all Hyperlinks associated with the given Application Structure. No Parameters No Return value Nodelist; A list of of Hyperlink Nodes containing hyperlink attributes. No Exceptions setLinkuris Associates one or several hyperlinks with the given Application Structure. Parameters hyperlinks of type NodeList The Hyperlink node list to be associated with the given Application Structure. No Return value No Exceptions getNames Need wording. Parameters style of type DOMString The name of the style attribute to modify. value of type DOMString The new value for the given style. No Return value No Exceptions setStyleAttr Set a style attribute at the picture level by name. Please refer to the Style Attributes Table for more detailed information on style attributes. Parameters style of type DOMString The name of the style attribute to modify. value of type DOMString The new value for the given style. No Return value No Exceptions clearStyleAttr Restores a style attribute to its original value (load time). Parameters style of type DOMString The name of the style attribute. The special value "*" matches all style attributes. No Return value No Exceptions getAppStructuresByType Returns a NodeList of all Application Structures of the given type in the order in which they are encountered in a preorder traversal of the AppStructure tree. Unlike the same method on the Picture interface, the valid types are defined by the current Application Structure type. Parameters apsType of type DOMString The name of the Application Structure type to match on. Return value NodeList; A new NodeList object containing all the matched Application Struture Nodes. No Exceptions SHOULD THROW AN EXCEPTION. Interface NodeListThe NodeList interface provides the abstraction of an ordered collection of nodes. NodeList objects in the WebCGM DOM are live. The index with the NodeList start at 0. IDL Definition
Attributes length of type unsigned long, readonly The number of nodes in the list. The range of valid child node indices is 0 to length-1 inclusive. Methods items Returns the index th item in the collection. Parameters index of type unsigned long Index into the collection. Return value Node; The node of the index th position in the NodeList, or null if that is not a valid index. No Exceptions Interface DOMStringListThe DOMStringList interface provides the abstraction of an ordered collection of DOMString values. The items in the DOMStringList are accessible via an integral index, starting from 0. IDL Definition
Attributes length of type unsigned long, readonly The number of DOMStrings in the list. The range of valid child node indices is 0 to length-1 inclusive. Methods items Returns the index th item in the collection. Parameters index of type unsigned long Index into the collection. Return value DOMString; The DOMString at the index th position in the DOMStringList, or null if that is not a valid index. No Exceptions Interface AttrThe IDL Definition
Attributes name of type DOMString, readonly Returns the name of this attribute. If Node.localName is different from null, this attribute is a qualified name. value of type DOMString, readonly 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. ownerNode of type Node, readonly The Element node this attribute is attached to or null if this attribute is not in use. Interface HyperlinkThe IDL Definition
Attributes href of type DOMString The location of the referenced object, expressed as a URI reference. Refer to the WebCGM Intelligent Content chaper for more information. title of type DOMString An optional string used to describe the meaning of a link or resource in a human-readable fashion. behavior of type DOMString Describes to the viewer how to display the picture. Refer to the WebCGM Intelligent Content chaper for more information. Interface
|
I very knowledgeable on the topic of entities; what happends in the textual content of an XML file contains entities? How do we handle that? |
IDL Definition
interface Text: Node {
readonly attribute boolean isElementContentWhitespace; // do we need this?
readonly attribute DOMString data;
readonly attribute unsigned long length;
};
|
Attributes
isElementContentWhitespace of type boolean, readonly
Returns whether this text node contains element content whitespace (see XML specification).
What does WebCGM say about Whitespace handling, would this be useful to us? |
data of type DOMString, readonly
The character data of the node that implements this interface.
Exceptions on retrieval
DOMException, DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.
length of type unsigned long, readonly
The number of 16-bit units that are available through 'data'. This may have the value zero, i.e., Text nodes may be empty.
EventListener
The EventListener interface is the primary method for handling events. Users implement the EventListener interface and register their listener on a Picture Node using the AddEventListener method.
IDL Definition
interface EventListener { void handleEvent(in Event evt); }; |
Methods
handleEvent
This method is called whenever an event occurs of the type for which the EventListener interface was registered.
Parameters
evtof type Event The
Event
contains contextual information about the event.
Return value
Event
The Event interface is used to provide contextual information about an event to the handler processing the event. An object which implements the Event interface is generally passed as the first parameter to an event handler.
IDL Definition
interface Event { readonly attribute DOMString type; readonly attribute Node target; readonly attribute unsigned short button; readonly attribute long numPressed; readonly attribute float clientX; readonly attribute float clientY; readonly attribute boolean ctrlKey; readonly attribute boolean shiftKey; readonly attribute boolean altKey; readonly attribute boolean metaKey; readonly attribute Node relatedTarget; // do we need this, see mouseout? void preventDefault(); // do we need this? }; |
Attributes
type of type DOMString, readonly
The name of the event (case-insensitive). The name must be an XML name.
target of type Node, readonly
Used to indicate the EventTarget to which the event was originally dispatched.
button of type unsigned short, readonly
During mouse events caused by the depression or release of a mouse button, button is used to indicate which mouse button changed state. The values for button range from zero to indicate the left button of the mouse, one to indicate the middle button if present, and two to indicate the right button. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.
numPressed of type long, readonly
Indicates the number of times a mouse button has been pressed and released over the same screen location during a user action. The attribute value is 1 when the user begins this action and increments by 1 for each full sequence of pressing and releasing. If the user moves the mouse between the mousedown and mouseup the value will be set to 0, indicating that no click is occurring.
clientX of type float, readonly
The horizontal coordinate at which the event occurred expressed in WebCGM user space.
clientY of type float, readonly
The vertical coordinate at which the event occurred expressed in WebCGM user space.
ctrlKey of type boolean, readonly
Used to indicate whether the 'ctrl' key was depressed during the firing of the event.
shiftKey of type boolean, readonly
Used to indicate whether the 'shift' key was depressed during the firing of the event.
altKey of type boolean, readonly
Used to indicate whether the 'alt' key was depressed during the firing of the event. On some platforms this key may map to an alternative key name.
metaKey of type boolean, readonly
Used to indicate whether the 'meta' key was depressed during the firing of the event. On some platforms this key may map to an alternative key name.
WebCGM supports the following types of events:
click The click event occurs when the pointing device button is clicked over an element. A click is defined as a mousedown and mouseup over the same screen location. The sequence of these events is: mousedown, mouseup, click. If multiple clicks occur at the same screen location, the sequence repeats with the detail attribute incrementing with each repetition.
mousedown The mousedown event occurs when the pointing device button is pressed over an element.
mouseup The mouseup event occurs when the pointing device button is released over an element.
mouseover The mouseover event occurs when the pointing device is moved onto an element, relatedTarget indicates the EventTarget the pointing device is exiting.
mouseout The mouseout event occurs when the pointing device is moved away from an element, relatedTarget indicates the EventTarget the pointing device is entering.
load The load event occurs when the DOM implementation finishes loading all content within a document, all frames within a FRAMESET, or an OBJECT element.
unload The unload event occurs when the DOM implementation removes a document from a window or frame. This event is valid for BODY and FRAMESET elements.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]