Element use

The 'use' element references another element and indicates that the graphical contents of that element is included/drawn at that given point in the document.

Extends

SVG11Element

Members Table

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

Show inherited members (marked with *)

Show: Attributes Properties Methods Events

Attribute Readonly Description id * true Element identifier. on*** * true Enables in-line handler for *** event. xlink:href false A URI reference to an element/fragment within an SVG document. xml:base * true Retrieves baseURI for the object. xml:space * true 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 $childNodesAnonymous * AMLNodeList true Contains collection of anonymous child nodes attached using $appendChildAnonymous. attributes * AMLNamedNodeMap true A collection containing the attributes of this node (if it is an AMLElement) 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 * AMLNodeList true A NodeList that contains all direct children of this node. firstChild * AMLNode true Retrieves a reference to the first child for the object. lastChild * AMLNode 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 * AMLNode 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 * AMLDocument true Retrieves the AMLDocument object associated with the node. parentNode * AMLNode true Retrieves the parent object in the object hierarchy. prefix * String true Retrieves the namespace prefix specifief for the node. previousSibling * AMLNode true Retrieves a reference to the previous child of the parent for the object. style * CSSStyleDeclaration true Return style declaration obejct. tagName * String true Retrieves the tag name of the object. Method Returns Description $abort * Void Aborts load operation initated by the call of $load method. Sytaxis: object.$abort() $activate * Void Activates element by dispatching DOMActivate event to the element. Sytaxis: object.$activate() $appendChildAnonymous * AMLElement Appends a child node to the sub-tree of the object. Sytaxis: object.$appendChildAnonymous(oNode) Arguments: Name Type O/R Description oNode AMLNode Required A child node to be added to the sub-tree. $getContainer * HTMLElement Returns a pointer to a (pseudo-) element in the shadow content. Sytaxis: object.$getContainer([sPseudoElement]) Arguments: Name Type O/R Description sPseudoElement String Optional Name of pseudo-element. $load * Void Loads element content from the remote resource specified by the sUrl argument Sytaxis: object.$load(sUrl) Arguments: Name Type O/R Description sUrl String Required URL $play * Number Starts playing effect and returns the process identifier. Sytaxis: object.$play(sStyle, nDuration, [nType]) Arguments: Name Type O/R Description sStyle String Required CSS declaration. nDuration Number Required Effect duration in milliseconds nType Number Optional Type of timing. $removeChildAnonymous * AMLElement Removes child node from the sub-tree of the object. Sytaxis: object.$removeChildAnonymous(oNode) Arguments: Name Type O/R Description oNode AMLNode Required A child node to be removed from the sub-tree. $setPseudoClass * Void Applies the pseudo class to an element. Sytaxis: object.$setPseudoClass(sName, bState, [sPseudoElement]) Arguments: Name Type O/R Description sName String Required Name of CSS pseudoclass bState Boolean Required Flag indicating wether pseudoclass should be set or reset. sPseudoElement String Optional Name of pseudo-element. $stop * Void Stops plying effect. Sytaxis: object.$stop(nEffect) Arguments: Name Type O/R Description nEffect String Required Process identifier got from play method call. 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(sType, fListener, bUseCapture) Arguments: Name Type O/R Description sType String Required Specifies the Event.type associated with the event for which the user is registering. fListener Function Required Function to be called when the event occurs. bUseCapture Boolean Required If true, user wishes to add the event listener for the capture phase only, if false - for target and bubbling phases. appendChild * AMLNode Appends a child element to the object. Sytaxis: object.appendChild(oElement) Arguments: Name Type O/R Description oElement AMLNode Required The node to add. canDispatch * Void Tests wether event of the specified namespace and type can be dispatched. Sytaxis: object.canDispatch(sNameSpaceURI, sType) Arguments: Name Type O/R Description sNameSpaceURI String Required NamespaceURI of the event to be tested. sType String Required Event type. cloneNode * AMLNode Creates a copy of node and returns it. Sytaxis: object.cloneNode(bDeep) Arguments: Name Type O/R Description bDeep 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(oNode) Arguments: Name Type O/R Description oNode AMLNode 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(oEvent) Arguments: Name Type O/R Description oEvent AMLEvent Required The event to be dispatched. getAttribute * String Retrieves the value of the specified attribute. Sytaxis: object.getAttribute(sName) Arguments: Name Type O/R Description sName String Required Attribute name getAttributeNS * String Retrieves the value of the specified attribute from the specified namespace. Sytaxis: object.getAttributeNS(sNameSpaceURI, sLocalName) Arguments: Name Type O/R Description sNameSpaceURI String Required Namespace URI sLocalName 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 * AMLNodeList Retrieves a AMLNodeList collection of AMLElement objects based on the specified element name. Sytaxis: object.getElementsByTagName(sName) Arguments: Name Type O/R Description sName String Required Element name. getElementsByTagNameNS * AMLNodeList Retrieves a AMLNodeList collection of AMLElement objects based on the specified element name from the given namespace. Sytaxis: object.getElementsByTagNameNS(sNameSpaceURI, sLocalName) Arguments: Name Type O/R Description sNameSpaceURI String Required Namespace URI. URI пространства имен элемента. sLocalName String Required Element name. hasAttribute * Boolean Returns a value that indicates whether the object has specified attribute. Sytaxis: object.hasAttribute(sName) Arguments: Name Type O/R Description sName String Required Attribute name. hasAttributeNS * Boolean Returns a value that indicates whether the object has specified attribute from the given namespace. Sytaxis: object.hasAttributeNS(sNameSpaceURI, sLocalName) Arguments: Name Type O/R Description sNameSpaceURI String Required Namespace URI. sLocalName 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 * AMLNode Inserts a chlid element after the specifyed element to the object. Sytaxis: object.insertBefore(oElement, oBefore) Arguments: Name Type O/R Description oElement AMLNode Required The node to insert. oBefore AMLNode 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(sNameSpaceURI) Arguments: Name Type O/R Description sNameSpaceURI 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(sPrefix) Arguments: Name Type O/R Description sPrefix 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(sNameSpaceURI) Arguments: Name Type O/R Description sNameSpaceURI 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 * AMLElement Returns AMLElement that matches CSS query. Sytaxis: object.querySelector(sQuery, [fResolver]) Arguments: Name Type O/R Description sQuery String Required CSS query. fResolver Function Optional Resolver function used to resolve namespace prefixes used in query. querySelectorAll * AMLNodeList Returns AMLNodeList of AMLElement that match CSS query. Sytaxis: object.querySelectorAll(sQuery, [fResolver]) Arguments: Name Type O/R Description sQuery String Required CSS query. fResolver Function Optional Resolver function used to resolve namespace prefixes used in query. removeAttribute * Void Removes the given attribute from the element. Sytaxis: object.removeAttribute(sName) Arguments: Name Type O/R Description sName String Required Attribute name. removeAttributeNS * Void Removes the given attribute from the given namespace from the element. Sytaxis: object.removeAttributeNS(sNameSpaceURI, sName) Arguments: Name Type O/R Description sNameSpaceURI String Required Namespace URI. sName String Required Attribute name. removeChild * AMLNode Removes a child node from the object. Sytaxis: object.removeChild(oChild) Arguments: Name Type O/R Description oChild AMLNode Required The node being removed. removeEventListener * Void This method allows the removal of event listeners from the default group. Sytaxis: object.removeEventListener(sType, fListener, bUseCapture) Arguments: Name Type O/R Description sType String Required Specifies the Event.type for which the user registered the event listener. fListener Function Required Listener to be removed. bUseCapture Boolean Required Specifies whether the EventListener being removed was registered for the capture phase or not. replaceChild * AMLNode Replaces the given child node by another node. Sytaxis: object.replaceChild(oNew, oChild) Arguments: Name Type O/R Description oNew AMLNode Required The new node to put in the child list. oChild AMLNode 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(sName, sValue) Arguments: Name Type O/R Description sName String Required Attribute name sValue String Required Attribute value setAttributeNS * Void Sets the value of the specified attribute from the given namespace. Sytaxis: object.setAttributeNS(sNameSpaceURI, sName, sValue) Arguments: Name Type O/R Description sNameSpaceURI String Required Namespace URI sName String Required Attribute name sValue String Required Attribute value 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. 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. click * + + MouseEvent A pointing device button is clicked over an element. contextmenu * + + MouseEvent * legacy. Fires when the user clicks the right mouse button in the client area, opening the context menu. It is recommended that you use click event and check button if its value is 2. dblclick * + + MouseEvent Fires when the user double-clicks the object. effectend * - - Event Fires when effect is ended. effectstart * - - Event Fires when effect is started. error * - - Event Fires when a resource failed to load. 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 * legacy. Fires when the user presses key on the keyboard. 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. 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 * + + MouseWheelEvent Fires when the user wheels the mouse within the boundaries of the 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 Constant Value Description