1.1.1 Conformance

1. A DOM application may use the hasFeature(feature, version) method of the DOMImplementation interface with parameter values "Events" and "3.0" (respectively).
2. An implementation that returns true for "Events" and "3.0" will also return true for the parameters "Events" and "2.0".

1.5 Event Types

1. Each event is associated with a type, called event type.
2. The event type is composed of a local name and a namespace URI.
3. All events defined in this specification are in no namespace.

1.6 Basic interfaces

• Event
  1. An object which implements the Event interface is passed as the parameter to an EventListener.
  2. To create an instance of the Event interface, use the DocumentEvent.createEvent("Event") method call.
  3. The defaultPrevented attribute is used to indicate whether Event.preventDefault() has been called for this event.
  4. The namespaceURI attribute indicates the associated with this event at initialization time.
  5. The initEventNS method initializes the attributes of an Event object.
  6. the namespaceURIArg of the initEventNS method specifies the namespace URI associated with this event.
  7. If no namespace is available for the namesapaceURIArg, then it's value is null.
  8. The stopImmediatePropagation method prevents other event listeners from being triggered.
  9. The effects of the stopImmediatePropagation method are immediate.
  10. The stopImmediatePropagation method does not prevent the default action from being invoked.
• CustomEvent
  1. The CustomEvent allows applications to provide contextual information about the event type.
  2. Application-specific event types should have an associated namespace to avoid clashes with future general-purpose event types.
  3. To create an instance of the CustomEvent interface, use the DocumentEvent.createEvent("CustomEvent") method call.
  4. The initCustomEventNS method initializes attributes of a CustomEvent object.
• EventTarget
  1. The addEventListenerNS method registers an event listener, depending on the useCapture parameter.
  2. The namespaceURI of the addEventListenerNS method specifies Specifies the Event.namespaceURI associated with the event for which the user is registering.
  3. The type parameter of the addEventListenerNS method specifies the Event type associated with the event for which the user is registering.
  4. The listener parameter of the addEventListenerNS method takes an object implemented by the user which implements the EventListener interface and contains the method to be called when the event occurs.
  5. If the useCapture parameter of the addEventListenerNS method set to "true" indicates that the user wishes to add the event listener for the capture phase only.
  6. If the useCapture parameter of the addEventListenerNS method set to "false" indicates that the event will be triggered during the target and bubbling phases.
  7. The dispatchEvent method dispatches an event into the implementation's event model.
  8. The event target of the event is the EventTarget object on which dispatchEvent is called (dispatchEvent method).
  9. The dispatchEvent method raises an UNSPECIFIED_EVENT_TYPE_ERR exception if the Event.type was not specified by initializing the event before dispatchEvent was called.
  10. The dispatchEvent method raises an EventException if the Event.type was set to null
  11. The dispatchEvent method raises a DISPATCH_REQUEST_ERR exception if the Event object is already being dispatched.
  12. The dispatchEvent method raises an NOT_SUPPORTED_ERR exception if the Event object has not been created using DocumentEvent.createEvent().
  13. The dispatchEvent method raises an INVALID_CHARACTER_ERR exception if Event.type is not an NCName as defined in [XML Namespaces 1.1].
  14. The removeEventListenerNS removes an event listener.
  15. Calling removeEventListenerNS with arguments which do not identify any currently registered EventListener on the EventTarget has no effect.
  16. The namespaceURI of the removeEventListenerNS method Specifies the Event.namespaceURI associated with the event for which the user registered the event listener.
  17. The type parameter of the removeEventListenerNS method specifies the Event.type associated with the event for which the user is registering.
  18. The listener parameter of the removeEventListenerNS method takes an object implemented by the user which implements the EventListener interface and contains the method to be called when the event occurs.
  19. The useCapture parameter of the removeEventListenerNS method removes an event listener.
  20. Calling the useCapture parameter of the removeEventListenerNS method with arguments which do not identify any currently registered EventListener on the EventTarget has no effect.

1.6.1 Event Creation

• DocumentEvent
  1. The canDispatch method tests if the implementation can generate events of a specified type.
  2. The canDispatch method return true if the implementation can dispatch the event.
  3. The canDispatch method return false if the implementation can not dispatch the event.
  4. The namespaceURI parameter of the canDispatch method specifies the Event.namespaceURI of the event.
  5. The type parameter of the canDispatch method specifies the Event.type of the event.

1.7.1 User Interface event types

• initUIEventNS
  1. The canDispatch method initializes attributes of an UIEvent object.
  2. The canDispatch method has the same behavior as Event.initEventNS().
  3. The namespaceURI parameter of the initUIEventNS method Specifies Event.namespaceURI, the namespace URI associated with this event, or null if no namespace.
  4. The typeArg parameter of the initUIEventNS method specifies Event.type, the local name of the event type.
  5. The canBubbleArg parameter of the initUIEventNS method specifies Event.bubbles. This parameter overrides the intrinsic bubbling behavior of the event.
  6. The cancelableArg parameter of the initUIEventNS method specifies Event.cancelable. This parameter overrides the intrinsic cancelable behavior of the event.
  7. The viewArg parameter of the initUIEventNS method specifies UIEvent.view.
  8. The viewArg parameter of the initUIEventNS method can be null
  9. The detailArg parameter of the initUIEventNS method specifies UIEvent.detail.

1.7.2 Text events types

• TextEvent
  1. The TextEvent interface provides specific contextual information associated with Text Events.
  2. To create an instance of the TextEvent interface, use the DocumentEvent.createEvent("TextEvent") method call.