XULElement

This object is available to unprivileged JavaScript. It implements the following interfaces:

Constants

short DOCUMENT_POSITION_DISCONNECTED = 1
short DOCUMENT_POSITION_PRECEDING = 2
short DOCUMENT_POSITION_FOLLOWING = 4
short DOCUMENT_POSITION_CONTAINS = 8
short DOCUMENT_POSITION_CONTAINED_BY = 16
short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 32
The nsIDOMNode interface is the primary datatype for the entire Document Object Model. It represents a single node in the document tree.

For more information on this interface please see http://www.w3.org/TR/DOM-Level-2-Core/

short ELEMENT_NODE = 1
short ATTRIBUTE_NODE = 2
short TEXT_NODE = 3
short CDATA_SECTION_NODE = 4
short ENTITY_REFERENCE_NODE = 5
short ENTITY_NODE = 6
short PROCESSING_INSTRUCTION_NODE = 7
short COMMENT_NODE = 8
short DOCUMENT_NODE = 9
short DOCUMENT_TYPE_NODE = 10
short DOCUMENT_FRAGMENT_NODE = 11
short NOTATION_NODE = 12

Properties

String align

boolean allowEvents

readonly NamedNodeMap attributes

readonly String baseURI

readonly BoxObject boxObject

readonly XULTemplateBuilder builder

readonly NodeList childNodes

String className

boolean collapsed

String contextMenu

readonly XULControllers controllers

readonly nsIRDFCompositeDataSource database

String datasources

String dir

readonly Node firstChild

String flex

String flexGroup

String height

boolean hidden

String id

readonly Node lastChild

String left

readonly String localName

String maxHeight

String maxWidth

String menu

String minHeight

String minWidth

readonly String namespaceURI

readonly Node nextSibling

readonly String nodeName

readonly short nodeType

String nodeValue

String observes

String ordinal

String orient

readonly Document ownerDocument

String pack

readonly Node parentNode

String persist

String prefix

readonly Node previousSibling

String ref

readonly nsIRDFResource resource

String statusText

readonly CSSStyleDeclaration style

readonly String tagName

The nsIDOMElement interface represents an element in an HTML or XML document.

For more information on this interface please see http://www.w3.org/TR/DOM-Level-2-Core/

String textContent

String tooltip

String tooltipText

String top

String width


Methods

void addEventListener ( String type , EventListener listener , boolean useCapture ) Node appendChild ( Node newChild ) void blur ( ) void click ( ) Node cloneNode ( boolean deep ) short compareDocumentPosition ( Node other ) boolean dispatchEvent ( Event evt ) void doCommand ( ) void focus ( ) String getAttribute ( String name ) Attr getAttributeNode ( String name ) Attr getAttributeNodeNS ( String namespaceURI , String localName ) String getAttributeNS ( String namespaceURI , String localName ) NodeList getElementsByAttribute ( String name , String value ) NodeList getElementsByTagName ( String name ) NodeList getElementsByTagNameNS ( String namespaceURI , String localName ) nsISupports getFeature ( String feature , String version ) nsIVariant getUserData ( String key ) boolean hasAttribute ( String name ) boolean hasAttributeNS ( String namespaceURI , String localName ) boolean hasAttributes ( ) boolean hasChildNodes ( ) Node insertBefore ( Node newChild , Node refChild ) boolean isDefaultNamespace ( String namespaceURI ) boolean isEqualNode ( Node arg ) boolean isSameNode ( Node other ) boolean isSupported ( String feature , String version ) String lookupNamespaceURI ( String prefix ) String lookupPrefix ( String namespaceURI ) void normalize ( ) void removeAttribute ( String name ) Attr removeAttributeNode ( Attr oldAttr ) void removeAttributeNS ( String namespaceURI , String localName ) Node removeChild ( Node oldChild ) void removeEventListener ( String type , EventListener listener , boolean useCapture ) Node replaceChild ( Node newChild , Node oldChild ) void setAttribute ( String name , String value ) Attr setAttributeNode ( Attr newAttr ) Attr setAttributeNodeNS ( Attr newAttr ) void setAttributeNS ( String namespaceURI , String qualifiedName , String value ) nsIVariant setUserData ( String key , nsIVariant data , nsIDOMUserDataHandler handler )

void addEventListener ( String type , EventListener listener , boolean useCapture )

This method allows the registration of event listeners on the event target. If an EventListener is added to an EventTarget while it is processing an event, it will not be triggered by the current actions but may be triggered during a later stage of event flow, such as the bubbling phase.

If multiple identical EventListeners are registered on the same EventTarget with the same parameters the duplicate instances are discarded. They do not cause the EventListener to be called twice and since they are discarded they do not need to be removed with the removeEventListener method.

Arguments:
type: The event type for which the user is registering
listener: The listener parameter takes an interface implemented by the user which contains the methods to be called when the event occurs.
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 EventTargets beneath them in the tree. Events which are bubbling upward through the tree will not trigger an EventListener designated to use capture.

Node appendChild ( Node newChild )

Arguments:
newChild

void blur ( )


void click ( )


Node cloneNode ( boolean deep )

Arguments:
deep

short compareDocumentPosition ( Node other )

Arguments:
other

boolean dispatchEvent ( Event evt )

This method allows the dispatch of events into the implementations event model. Events dispatched in this manner will have the same capturing and bubbling behavior as events dispatched directly by the implementation. The target of the event is the EventTarget on which dispatchEvent is called.

Arguments:
evt: Specifies the event type, behavior, and contextual information to be used in processing the event.
Returns:
Indicates whether any of the listeners which handled the event called preventDefault. If preventDefault was called the value is false, else the value is true.

void doCommand ( )


void focus ( )


String getAttribute ( String name )

Arguments:
name

Attr getAttributeNode ( String name )

Arguments:
name

Attr getAttributeNodeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

String getAttributeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

NodeList getElementsByAttribute ( String name , String value )

Arguments:
name
value

NodeList getElementsByTagName ( String name )

Arguments:
name

NodeList getElementsByTagNameNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

nsISupports getFeature ( String feature , String version )

Arguments:
feature
version

nsIVariant getUserData ( String key )

Arguments:
key

boolean hasAttribute ( String name )

Arguments:
name

boolean hasAttributeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

boolean hasAttributes ( )


boolean hasChildNodes ( )


Node insertBefore ( Node newChild , Node refChild )

Arguments:
newChild
refChild

boolean isDefaultNamespace ( String namespaceURI )

Arguments:
namespaceURI

boolean isEqualNode ( Node arg )

Arguments:
arg

boolean isSameNode ( Node other )

Arguments:
other

boolean isSupported ( String feature , String version )

Arguments:
feature
version

String lookupNamespaceURI ( String prefix )

Arguments:
prefix

String lookupPrefix ( String namespaceURI )

Arguments:
namespaceURI

void normalize ( )


void removeAttribute ( String name )

Arguments:
name

Attr removeAttributeNode ( Attr oldAttr )

Arguments:
oldAttr

void removeAttributeNS ( String namespaceURI , String localName )

Arguments:
namespaceURI
localName

Node removeChild ( Node oldChild )

Arguments:
oldChild

void removeEventListener ( String type , EventListener listener , boolean useCapture )

This method allows the removal of event listeners from the event target. If an EventListener is removed from an EventTarget while it is processing an event, it will not be triggered by the current actions. EventListeners can never be invoked after being removed. Calling removeEventListener with arguments which do not identify any currently registered EventListener on the EventTarget has no effect.

Arguments:
type: Specifies the event type of the EventListener being removed.
listener: The EventListener parameter indicates the EventListener to be removed.
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 does not affect a non-capturing version of the same listener, and vice versa.

Node replaceChild ( Node newChild , Node oldChild )

Arguments:
newChild
oldChild

void setAttribute ( String name , String value )

Arguments:
name
value

Attr setAttributeNode ( Attr newAttr )

Arguments:
newAttr

Attr setAttributeNodeNS ( Attr newAttr )

Arguments:
newAttr

void setAttributeNS ( String namespaceURI , String qualifiedName , String value )

Arguments:
namespaceURI
qualifiedName
value

nsIVariant setUserData ( String key , nsIVariant data , nsIDOMUserDataHandler handler )

Arguments:
key
data
handler

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
May 18, 2004, 6:26 am ted at irc dot mozilla
If you want to use an object method as the listener for the addEventListener, you'd better pass the object itself to the addEventListener and ensure that the object contains a method called handleEvent(). Otherwise, any "this" reference in a object method listener will point to the wrong object.


object = {
handleEvent: function() {alert(this.item);},
this.item: "hello world!",
}

addEventListener('load', object, true);


Copyright © 1999 - 2005 XULPlanet.com