Class Element

Represents an element.

Extends

Node

Members Table

The following table lists the members exposed by the Element object.

Show inherited members (marked with *)

Show: Attributes Properties Methods Events Pseudo-classes

Attribute Description aml:content Name of locale key to substitute element's content. aml:draggable Specifies wether element can be dragged by user. Acceptable values: Value Description true Element can be dragged. false Element can not be dragged. aml:droppable Specifies wether element can be used as drop target. Acceptable values: Value Description true Element can be used as drop target. false Element can not be used as drop target. aml:resizable Specifies whether element boundaries can be modified by user. Acceptable values: Value Description true Elements boundaries can be modified. false Elements boundaries can not be modified. aml:resize-edges Specifies what edges can be resized. The attribute value is a space separated list of "top", "right", "bottom" and "left" tokens. aml:selectable Enables/disables text selection on element. Acceptable values: Value Description true Text selection is enabled on element false Text selection is disabled on element inherit Text selection behavior is inherited from its parent container. aml:values Semicolon-separated list of name:locale key pairs to substitute element's attributes or properties. For example: value:key_value;.innerHTML:key_innerHTML id Element identifier. on*** Enables in-line handler for *** event. xml:base Retrieves baseURI for the object. xml:space Instructs DOM implementation on weather to preserve whitespace text nodes. Acceptable values: Value Description preserve All whitespaces will be preserved in the document. default Standard processing of whitespaces Property Type Readonly Description $draggable Boolean false If true, element is draggable. $droppable Boolean false If true, element is a valid drag target. $resizable Boolean false Keeps a flag indicating whether element size can be modified. $selectable Boolean false Keeps a flag indicating whether element's text content can be selected. attributes * Object true A collection containing the attributes of this node (if it is an Element) or null otherwise. baseURI * String true The absolute base URI of this node or null if the implementation wasn't able to obtain an absolute URI. childNodes * NodeList true A NodeList that contains all direct children of this node. contentFragment DocumentFragment false UI element definition API. A reference to the anonymous subtree. The subtree should be created in element constructor. firstChild * Node true Retrieves a reference to the first child for the object. lastChild * Node true Retrieves a reference to the last child for the object. localName * String true Retrieves the local name of node. namespaceURI * String true Retrieves the namespace URI. nextSibling * Node true Retrieves a reference to the next child of the parent for the object. nodeName * String true Retrieves the name of a particular type of node. nodeType * Number true Retrieves the type of the requested node. nodeValue * String true Retrieves the value of a node. ownerDocument * Document true Retrieves the Document object associated with the node. parentNode * Node true Retrieves the parent object in the object hierarchy. prefix * String true Retrieves the namespace prefix specifief for the node. previousSibling * Node true Retrieves a reference to the previous child of the parent for the object. style CSSStyleDeclaration true Return style declaration obejct. tabIndex Number false Sets value used to specify control position in tab sequence. When value is set to 0, control will be accessed in the document order, when -1, control will not be accessible at all. tagName String true Retrieves the tag name of the object. Method Returns Description $activate Void Activates element by dispatching DOMActivate event to the element. Sytaxis: object.$activate() $getContainer HTMLElement UI element definition API. Returns a pointer to a (pseudo-) element in the shadow content. Sytaxis: object.$getContainer([pseudoElement]) Arguments: Name Type O/R Description pseudoElement String Optional Name of pseudo-element. $getTagClose String UI element definition API. Provide your function to return shadow content to be inserted after element children. Sytaxis: object.$getTagClose() $getTagOpen String UI element definition API. Provide your function to return shadow content to be inserted before element children. Sytaxis: object.$getTagOpen() $isAccessible Boolean UI element definition API. Indicates wether element can be focused. Sytaxis: object.$isAccessible() $mapAttribute Void UI element definition API. Provide your function to map attribute value to shadow tree. Not called for id, class and style attributes. Sytaxis: object.$mapAttribute(name, value) Arguments: Name Type O/R Description name String Required Attribute name value String Required Attribute value. null if attribute is being removed. $setPseudoClass Void UI element definition API. Applies the pseudo class to an element. Sytaxis: object.$setPseudoClass(name, state, [pseudoElement]) Arguments: Name Type O/R Description name String Required Name of CSS pseudoclass state Boolean Required Flag indicating wether pseudoclass should be set or reset. pseudoElement String Optional Name of pseudo-element. addEventListener * Void This method allows the registration of an event listener in the default group and, depending on the useCapture parameter, on the capture phase of the DOM event flow or its target and bubbling phases. Sytaxis: object.addEventListener(type, listener, useCapture) Arguments: Name Type O/R Description type String Required Specifies the Event.type associated with the event for which the user is registering. listener Function Required Function to be called when the event occurs. useCapture Boolean Required If true, user wishes to add the event listener for the capture phase only, if false - for target and bubbling phases. appendChild * Node Appends a child element to the object. Sytaxis: object.appendChild(node) Arguments: Name Type O/R Description node Node Required The node to add. blur Void Removes focus from the element. Sytaxis: object.blur() canDispatch * Void Tests wether event of the specified namespace and type can be dispatched. Sytaxis: object.canDispatch(namespaceURI, type) Arguments: Name Type O/R Description namespaceURI String Required NamespaceURI of the event to be tested. type String Required Event type. cloneNode * Node Creates a copy of node and returns it. Sytaxis: object.cloneNode(deep) Arguments: Name Type O/R Description deep Boolean Required Indicates wether the childnodes are also to be cloned. compareDocumentPosition * Number Compares the reference node, i.e. the node on which this method is being called, with a node, i.e. the one passed as a parameter, with regard to their position in the document and according to the document order. Sytaxis: object.compareDocumentPosition(node) Arguments: Name Type O/R Description node Node Required The node to compare against the reference node. dispatchEvent * Boolean This method allows the dispatch of events into the implementation's event model. Return value indicates whether any of the listeners which handled the event called preventDefault method on Event object. Sytaxis: object.dispatchEvent(event) Arguments: Name Type O/R Description event Event Required The event to be dispatched. focus Void Moves focus to the element. Sytaxis: object.focus() getAttribute String Retrieves the value of the specified attribute. Sytaxis: object.getAttribute(name) Arguments: Name Type O/R Description name String Required Attribute name getAttributeNS String Retrieves the value of the specified attribute from the specified namespace. Sytaxis: object.getAttributeNS(namespaceURI, localName) Arguments: Name Type O/R Description namespaceURI String Required Namespace URI localName String Required Attribute name getBoundingClientRect TextRectangle Returns an object with top, right, bottom, left members keeping the absolute coordinates of the object in the screen. Sytaxis: object.getBoundingClientRect() getElementsByTagName NodeList Retrieves a NodeList collection of Element objects based on the specified element name. Sytaxis: object.getElementsByTagName(name) Arguments: Name Type O/R Description name String Required Element name. getElementsByTagNameNS NodeList Retrieves a NodeList collection of Element objects based on the specified element name from the given namespace. Sytaxis: object.getElementsByTagNameNS(namespaceURI, localName) Arguments: Name Type O/R Description namespaceURI String Required Namespace URI. URI пространства имен элемента. localName String Required Element name. hasAttribute Boolean Returns a value that indicates whether the object has specified attribute. Sytaxis: object.hasAttribute(name) Arguments: Name Type O/R Description name String Required Attribute name. hasAttributeNS Boolean Returns a value that indicates whether the object has specified attribute from the given namespace. Sytaxis: object.hasAttributeNS(namespaceURI, localName) Arguments: Name Type O/R Description namespaceURI String Required Namespace URI. localName String Required Attribute name. hasAttributes * Boolean Retrieves true if the node has any attributes. Sytaxis: object.hasAttributes() hasChildNodes * Boolean Returns a value that indicates whether the object has children. Sytaxis: object.hasChildNodes() insertBefore * Node Inserts a chlid element after the specifyed element to the object. Sytaxis: object.insertBefore(node, before) Arguments: Name Type O/R Description node Node Required The node to insert. before Node Required The reference node, i.e., the node before which the new node must be inserted. isDefaultNamespace * String This method checks if the specified namespaceURI is the default namespace or not. Sytaxis: object.isDefaultNamespace(namespaceURI) Arguments: Name Type O/R Description namespaceURI String Required The namespace URI to look for. lookupNamespaceURI * String Look up the namespace URI associated to the given prefix, starting from this node. Sytaxis: object.lookupNamespaceURI(prefix) Arguments: Name Type O/R Description prefix String Required The prefix to look for. If this parameter is null, the method will return the default namespace URI if any. lookupPrefix * String Look up the prefix associated to the given namespace URI, starting from this node. Sytaxis: object.lookupPrefix(namespaceURI) Arguments: Name Type O/R Description namespaceURI String Required The namespace URI to look for. normalize * Void Puts all Text nodes in the full depth of the sub-tree underneath this Node, including attribute nodes, into a "normal" form Sytaxis: object.normalize() querySelector Element Returns Element that matches CSS query. Sytaxis: object.querySelector(selector, [NSResolver]) Arguments: Name Type O/R Description selector String Required CSS query. NSResolver Function Optional Resolver function used to resolve namespace prefixes used in query. querySelectorAll NodeList Returns NodeList of Element that match CSS query. Sytaxis: object.querySelectorAll(selector, [NSResolver]) Arguments: Name Type O/R Description selector String Required CSS query. NSResolver Function Optional Resolver function used to resolve namespace prefixes used in query. releaseCapture Void Removes mouse capture from the object in the current document. Sytaxis: object.releaseCapture() removeAttribute Void Removes the given attribute from the element. Sytaxis: object.removeAttribute(name) Arguments: Name Type O/R Description name String Required Attribute name. removeAttributeNS Void Removes the given attribute from the given namespace from the element. Sytaxis: object.removeAttributeNS(namespaceURI, name) Arguments: Name Type O/R Description namespaceURI String Required Namespace URI. name String Required Attribute name. removeChild * Node Removes a child node from the object. Sytaxis: object.removeChild(child) Arguments: Name Type O/R Description child Node Required The node being removed. removeEventListener * Void This method allows the removal of event listeners from the default group. Sytaxis: object.removeEventListener(type, listener, useCapture) Arguments: Name Type O/R Description type String Required Specifies the Event.type for which the user registered the event listener. listener Function Required Listener to be removed. useCapture Boolean Required Specifies whether the EventListener being removed was registered for the capture phase or not. replaceChild * Node Replaces the given child node by another node. Sytaxis: object.replaceChild(new, child) Arguments: Name Type O/R Description new Node Required The new node to put in the child list. child Node Required The node being replaced in the list. scrollIntoView Void Causes the object to scroll into view, aligning it either at the top or bottom of the window. Sytaxis: object.scrollIntoView(top) Arguments: Name Type O/R Description top Boolean Required If value is true, scrolls the object so that top of the object is visible at the top of the window. setAttribute Void Sets the value of the specified attribute. Sytaxis: object.setAttribute(name, value) Arguments: Name Type O/R Description name String Required Attribute name value String Required Attribute value setAttributeNS Void Sets the value of the specified attribute from the given namespace. Sytaxis: object.setAttributeNS(namespaceURI, name, value) Arguments: Name Type O/R Description namespaceURI String Required Namespace URI name String Required Attribute name value String Required Attribute value setCapture Void Sets the mouse capture to the object that belongs to the current document. Sytaxis: object.setCapture([containerCapture]) Arguments: Name Type O/R Description containerCapture Boolean Optional A Boolean that specifies capture mode. toXML * String Serializes Node to string. Sytaxis: object.toXML() Event B C Interface Description DOMActivate + + UIEvent An activation behavior requested from element. DOMAttrModified + - MutationEvent Occurs after Attr.value has been modified and after an Attr node has been added to or removed from an Element. DOMFocusIn + - UIEvent An object receives focus. The focus is given to the element before the dispatch of this event type. This event type is dispatched after the event type focus. DOMFocusOut + - UIEvent An object loses focus. The focus is taken from the element before the dispatch of this event type. This event type is dispatched after the event type blur. DOMNodeInserted * + - MutationEvent A node has been added as a child of another node or, in case of Attr nodes, has been added to an Element. DOMNodeInsertedIntoDocument * - - MutationEvent A node has been inserted into a document. DOMNodeRemoved * + - MutationEvent A node is being removed from its parent node or, in case of Attr nodes, removed from its ownerElement. DOMNodeRemovedFromDocument * - - MutationEvent A node is being removed from a document. abort - - Event Fires when the loading of a resource has been aborted. blur - - UIEvent Fires when element looses focus. capture + - UIEvent Fires when user clicks outside element set to receive capture. click + + MouseEvent A pointing device button is clicked over an element. contextmenu + + MouseEvent Fires when the user clicks the right mouse button in the client area, opening the context menu. dblclick + + MouseEvent Fires when the user double-clicks the object. drag + + DragEvent Fires on the source object continuously during a drag operation. dragend + + DragEvent Fires on the source object when the user releases the mouse at the close of a drag operation. dragenter + + DragEvent Fires on the target element when the user drags the object to a valid drop target. dragleave + + DragEvent Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation. dragover + + DragEvent dragstart + + DragEvent Fires on the source object when the user starts to drag an object. drop + + DragEvent Fires on the target object when the mouse button is released during a drag-and-drop operation. effectend - - Event Fires when effect is ended. effectstart - - Event Fires when effect is started. error - - Event Fires when a resource failed to load. focus - - UIEvent Fires when element receives focus. gesturechange + + GestureEvent Sent when fingers are moved during a gesture. gestureend + + GestureEvent Sent when the gesture ends (when there are 1 or 0 fingers touching the surface). gesturestart + + GestureEvent Sent when two or more fingers touch the surface. keydown + + KeyboardEvent A key is pressed down. keypress + + KeyboardEvent It is recommended that you use textInput event instead. keyup + + KeyboardEvent A key is released. load - - Event Fires after the DOM implementation finishes loading the resource. localechange - - CustomEvent Fires when locale has been successfully changed. The detail property keeps the new locale name name. losecapture - - UIEvent Fires when the object is losing the mouse capture. modal + - UIEvent Fires when user clicks outside element set as modal. mousedown + + MouseEvent A pointing device button is pressed over an element. mouseenter - - MouseEvent Fires when the user moves the mouse pointer into the object. mouseleave - - MouseEvent Fires when the user moves the mouse pointer outside the boundaries of the object. mousemove + + MouseEvent A pointing device is moved while it is over an element. mouseout + + MouseEvent A pointing device is moved away from an element. mouseover + + MouseEvent A pointing device is moved onto an element. mouseup + + MouseEvent A pointing device button is released over an element. mousewheel + + WheelEvent Fires when the user wheels the mouse within the boundaries of the object. resize + + ResizeEvent Fires continuously while user is resizing object. resizeend + + ResizeEvent Fires when user ends resizing an object. resizestart + + ResizeEvent Fires when user starts resizing an object. textinput + + TextEvent User typed in a character. touchcancel + + TouchEvent Sent when the system cancels tracking for the touch. touchend + + TouchEvent Sent when a given event lifts from the surface. touchmove + + TouchEvent Sent when a given event moves on the surface. touchstart + + TouchEvent Sent when a finger for a given event touches the surface. unload - - Event Fires before the DOM Implementation removes from the environment the resource. Pseudo-class Description drag Applied to the drag source during operation drop Applied to the drop target when it is allowed focus Applied to the element when it has focus hover Applied to the element while mouse is over load Applied to the element being loaded resize Applied to the element being resized Constant Value Description