JavaScript is disabled on your browser.
Skip navigation links
org.htmlunit.javascript.host

Class Element

    • Constructor Detail

      • Element

        public Element()
    • Method Detail

      • jsConstructor

        public void jsConstructor()
        JavaScript constructor.
        Overrides:
        jsConstructor in class Node
      • setDomNode

        public void setDomNode(DomNode domNode)
        Sets the DOM node that corresponds to this JavaScript object.
        Overrides:
        setDomNode in class HtmlUnitScriptable
        Parameters:
        domNode - the DOM node
      • createEventHandler

        protected void createEventHandler(String eventName,
         String attrValue)
        Create the event handler function from the attribute value.
        Parameters:
        eventName - the event name (ex: "onclick")
        attrValue - the attribute value
      • getTagName

        public String getTagName()
        Returns the tag name of this element.
        Returns:
        the tag name
      • createAttributesObject

        protected NamedNodeMap createAttributesObject()
        Creates the JS object for the property attributes. This object will the be cached.
        Returns:
        the JS object
      • getAttribute

        public String getAttribute(String attributeName)
        Parameters:
        attributeName - attribute name
        Returns:
        the value of the specified attribute, null if the attribute is not defined
      • setAttribute

        public void setAttribute(String name,
         String value)
        Sets an attribute.
        Parameters:
        name - Name of the attribute to set
        value - Value to set the attribute to
      • getElementsByTagName

        public HTMLCollection getElementsByTagName(String tagName)
        Returns all the descendant elements with the specified tag name.
        Parameters:
        tagName - the name to search for
        Returns:
        all the descendant elements with the specified tag name
      • getAttributeNode

        public HtmlUnitScriptable getAttributeNode(String name)
        Retrieves an attribute node by name.
        Parameters:
        name - the name of the attribute to retrieve
        Returns:
        the XMLAttr node with the specified name or null if there is no such attribute
      • getElementsByTagNameNS

        public HTMLCollection getElementsByTagNameNS(Object namespaceURI,
         String localName)
        Returns a list of elements with the given tag name belonging to the given namespace.
        Parameters:
        namespaceURI - the namespace URI of elements to look for
        localName - is either the local name of elements to look for or the special value "*", which matches all elements.
        Returns:
        a live NodeList of found elements in the order they appear in the tree
      • hasAttribute

        public boolean hasAttribute(String name)
        Returns true when an attribute with a given name is specified on this element or has a default value. See also the DOM reference
        Parameters:
        name - the name of the attribute to look for
        Returns:
        true if an attribute with the given name is specified on this element or has a default value
      • hasAttributes

        public boolean hasAttributes()
        Returns true when the current element has any attributes or not.
        Overrides:
        hasAttributes in class Node
        Returns:
        true if an attribute is specified on this element
      • getDomNodeOrDie

        public DomElement getDomNodeOrDie()
        Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.
        Overrides:
        getDomNodeOrDie in class HtmlUnitScriptable
        Returns:
        the DOM node
      • removeAttribute

        public void removeAttribute(String name)
        Removes the specified attribute.
        Parameters:
        name - the name of the attribute to remove
      • getBoundingClientRect

        public DOMRect getBoundingClientRect()
        Retrieves an object that specifies the bounds of a collection of TextRectangle objects.
        Returns:
        an object that specifies the bounds of a collection of TextRectangle objects
        See Also:
        MSDN doc
      • getChildElementCount

        public int getChildElementCount()
        Returns the current number of child elements.
        Overrides:
        getChildElementCount in class Node
        Returns:
        the child element count
      • getFirstElementChild

        public Element getFirstElementChild()
        Returns the first element child.
        Overrides:
        getFirstElementChild in class Node
        Returns:
        the first element child
      • getLastElementChild

        public Element getLastElementChild()
        Returns the last element child.
        Overrides:
        getLastElementChild in class Node
        Returns:
        the last element child
      • getNextElementSibling

        public Element getNextElementSibling()
        Returns the next element sibling.
        Returns:
        the next element sibling
      • getPreviousElementSibling

        public Element getPreviousElementSibling()
        Returns the previous element sibling.
        Returns:
        the previous element sibling
      • getClassList

        public DOMTokenList getClassList()
        Gets the token list of class attribute.
        Returns:
        the token list of class attribute
      • getAttributeNS

        public String getAttributeNS(String namespaceURI,
         String localName)
        Gets the specified attribute.
        Parameters:
        namespaceURI - the namespace URI
        localName - the local name of the attribute to look for
        Returns:
        the value of the specified attribute, null if the attribute is not defined
      • hasAttributeNS

        public boolean hasAttributeNS(String namespaceURI,
         String localName)
        Test for attribute. See also the DOM reference
        Parameters:
        namespaceURI - the namespace URI
        localName - the local name of the attribute to look for
        Returns:
        true if the node has this attribute
      • setAttributeNS

        public void setAttributeNS(String namespaceURI,
         String qualifiedName,
         String value)
        Sets the specified attribute.
        Parameters:
        namespaceURI - the namespace URI
        qualifiedName - the qualified name of the attribute to look for
        value - the new attribute value
      • removeAttributeNS

        public void removeAttributeNS(String namespaceURI,
         String localName)
        Removes the specified attribute.
        Parameters:
        namespaceURI - the namespace URI of the attribute to remove
        localName - the local name of the attribute to remove
      • setAttributeNode

        public Attr setAttributeNode(Attr newAtt)
        Sets the attribute node for the specified attribute.
        Parameters:
        newAtt - the attribute to set
        Returns:
        the replaced attribute node, if any
      • querySelectorAll

        public NodeList querySelectorAll(String selectors)
        Retrieves all element nodes from descendants of the starting element node that match any selector within the supplied selector strings. The NodeList object returned by the querySelectorAll() method must be static, not live.
        Parameters:
        selectors - the selectors
        Returns:
        the static node list
      • querySelector

        public Node querySelector(String selectors)
        Returns the first element within the document that matches the specified group of selectors.
        Parameters:
        selectors - the selectors
        Returns:
        null if no matches are found; otherwise, it returns the first matching element
      • getClassName_js

        public String getClassName_js()
        Returns the class defined for this element.
        Returns:
        the class name
      • setClassName_js

        public void setClassName_js(String className)
        Sets the class attribute for this element.
        Parameters:
        className - the new class name
      • getClientHeight

        public int getClientHeight()
        Returns the clientHeight attribute.
        Returns:
        the clientHeight attribute
      • getClientWidth

        public int getClientWidth()
        Returns the clientWidth attribute.
        Returns:
        the clientWidth attribute
      • getClientLeft

        public int getClientLeft()
        Returns the clientLeft attribute.
        Returns:
        the clientLeft attribute
      • getClientTop

        public int getClientTop()
        Returns clientTop attribute.
        Returns:
        the clientTop attribute
      • getAttributeNodeNS

        public HtmlUnitScriptable getAttributeNodeNS(String namespaceURI,
         String localName)
        Returns the specified attribute.
        Parameters:
        namespaceURI - the namespace URI
        localName - the local name of the attribute to look for
        Returns:
        the specified attribute, null if the attribute is not defined
      • getElementsByClassName

        public HTMLCollection getElementsByClassName(String className)
        Returns all the descendant elements with the specified class.
        Parameters:
        className - the name to search for
        Returns:
        all the descendant elements with the specified class name
      • getClientRects

        public DOMRectList getClientRects()
        Retrieves a collection of rectangles that describes the layout of the contents of an object or range within the client. Each rectangle describes a single line.
        Returns:
        a collection of rectangles that describes the layout of the contents
      • isDisplayNone

        protected final boolean isDisplayNone()
        Returns whether the display is none or not.
        Returns:
        whether the display is none or not
      • insertAdjacentElement

        public Node insertAdjacentElement(String where,
         Object insertedElement)
        Inserts the given element into the element at the location.
        Parameters:
        where - specifies where to insert the element, using one of the following values (case-insensitive): beforebegin, afterbegin, beforeend, afterend
        insertedElement - the element to be inserted
        Returns:
        an element object
        See Also:
        MSDN
      • insertAdjacentText

        public void insertAdjacentText(String where,
         String text)
        Inserts the given text into the element at the specified location.
        Parameters:
        where - specifies where to insert the text, using one of the following values (case-insensitive): beforebegin, afterbegin, beforeend, afterend
        text - the text to insert
        See Also:
        MSDN
      • insertAdjacentHTML

        public void insertAdjacentHTML(String position,
         String text)
        Parses the given text as HTML or XML and inserts the resulting nodes into the tree in the position given by the position argument.
        Parameters:
        position - specifies where to insert the nodes, using one of the following values (case-insensitive): beforebegin, afterbegin, beforeend, afterend
        text - the text to parse
        See Also:
        W3C Spec, WhatWG Spec, Mozilla Developer Network, MSDN
      • getHTML

        public String getHTML()
        The getHTML function.
        Returns:
        the contents of this node as HTML
      • getInnerHTML

        public String getInnerHTML()
        Gets the innerHTML attribute.
        Returns:
        the contents of this node as HTML
      • setInnerHTML

        public void setInnerHTML(Object value)
        Replaces all child elements of this element with the supplied value.
        Parameters:
        value - the new value for the contents of this element
      • getInnerHTML

        protected String getInnerHTML(DomNode domNode)
        Helper for getInnerHtml (to be reuses bei HTMLTemplate.
        Parameters:
        domNode - the node
        Returns:
        the contents of this node as HTML
      • getOuterHTML

        public String getOuterHTML()
        Gets the outerHTML of the node.
        Returns:
        the contents of this node as HTML
        See Also:
        MSDN documentation
      • setOuterHTML

        public void setOuterHTML(Object value)
        Replaces this element (including all child elements) with the supplied value.
        Parameters:
        value - the new value for replacing this element
      • printChildren

        protected final void printChildren(StringBuilder builder,
         DomNode node,
         boolean html)
        Helper for getting code back from nodes.
        Parameters:
        builder - the builder to write to
        node - the node to be serialized
        html - flag
      • isEndTagForbidden

        protected boolean isEndTagForbidden()
        Returns whether the end tag is forbidden or not.
        Returns:
        whether the end tag is forbidden or not
        See Also:
        HTML 4 specs
      • getId

        public String getId()
        Returns the element ID.
        Returns:
        the ID of this element
      • setId

        public void setId(String newId)
        Sets the id value for this element.
        Parameters:
        newId - the newId value for this element
      • removeAttributeNode

        public void removeAttributeNode(Attr attribute)
        Removes the specified attribute.
        Parameters:
        attribute - the attribute to remove
      • getScrollTop

        public int getScrollTop()
        Gets the scrollTop value for this element.
        Returns:
        the scrollTop value for this element
        See Also:
        MSDN documentation
      • setScrollTop

        public void setScrollTop(int scroll)
        Sets the scrollTop value for this element.
        Parameters:
        scroll - the scrollTop value for this element
      • getScrollLeft

        public int getScrollLeft()
        Gets the scrollLeft value for this element.
        Returns:
        the scrollLeft value for this element
        See Also:
        MSDN documentation
      • setScrollLeft

        public void setScrollLeft(int scroll)
        Sets the scrollLeft value for this element.
        Parameters:
        scroll - the scrollLeft value for this element
      • getScrollHeight

        public int getScrollHeight()
        Gets the scrollHeight for this element.
        Returns:
        at the moment the same as client height
        See Also:
        MSDN documentation
      • getScrollWidth

        public int getScrollWidth()
        Gets the scrollWidth for this element.
        Returns:
        a dummy value of 10
        See Also:
        MSDN documentation
      • getStyle

        protected CSSStyleDeclaration getStyle()
        Returns the style object for this element.
        Returns:
        the style object for this element
      • setStyle

        protected void setStyle(String style)
        Sets the styles for this element.
        Parameters:
        style - the style of the element
      • scrollIntoView

        public void scrollIntoView()
        Implement the scrollIntoView() JavaScript function but don't actually do anything. The requirement is just to prevent scripts that call that method from failing
      • scrollIntoViewIfNeeded

        public void scrollIntoViewIfNeeded()
        Implement the scrollIntoViewIfNeeded() JavaScript function but don't actually do anything.
      • getPrefix

        public String getPrefix()
        Returns the namespace prefix.
        Overrides:
        getPrefix in class Node
        Returns:
        the namespace prefix
      • getLocalName

        public String getLocalName()
        Returns the local name of this attribute.
        Overrides:
        getLocalName in class Node
        Returns:
        the local name of this attribute
      • getNamespaceURI

        public String getNamespaceURI()
        Returns the URI that identifies an XML namespace.
        Overrides:
        getNamespaceURI in class Node
        Returns:
        the URI that identifies an XML namespace
      • getOnbeforecopy

        public org.htmlunit.corejs.javascript.Function getOnbeforecopy()
        Returns the onbeforecopy event handler for this element.
        Returns:
        the onbeforecopy event handler for this element
      • setOnbeforecopy

        public void setOnbeforecopy(Object onbeforecopy)
        Sets the onbeforecopy event handler for this element.
        Parameters:
        onbeforecopy - the onbeforecopy event handler for this element
      • setOnbeforecut

        public void setOnbeforecut(Object onbeforecut)
        Sets the onbeforecut event handler for this element.
        Parameters:
        onbeforecut - the onbeforecut event handler for this element
      • getOnbeforepaste

        public org.htmlunit.corejs.javascript.Function getOnbeforepaste()
        Returns the onbeforepaste event handler for this element.
        Returns:
        the onbeforepaste event handler for this element
      • setOnbeforepaste

        public void setOnbeforepaste(Object onbeforepaste)
        Sets the onbeforepaste event handler for this element.
        Parameters:
        onbeforepaste - the onbeforepaste event handler for this element
      • setOnsearch

        public void setOnsearch(Object onsearch)
        Sets the onsearch event handler for this element.
        Parameters:
        onsearch - the onsearch event handler for this element
      • getOnwebkitfullscreenchange

        public org.htmlunit.corejs.javascript.Function getOnwebkitfullscreenchange()
        Returns the onwebkitfullscreenchange event handler for this element.
        Returns:
        the onwebkitfullscreenchange event handler for this element
      • setOnwebkitfullscreenchange

        public void setOnwebkitfullscreenchange(Object onwebkitfullscreenchange)
        Sets the onwebkitfullscreenchange event handler for this element.
        Parameters:
        onwebkitfullscreenchange - the onwebkitfullscreenchange event handler for this element
      • getOnwebkitfullscreenerror

        public org.htmlunit.corejs.javascript.Function getOnwebkitfullscreenerror()
        Returns the onwebkitfullscreenerror event handler for this element.
        Returns:
        the onwebkitfullscreenerror event handler for this element
      • setOnwebkitfullscreenerror

        public void setOnwebkitfullscreenerror(Object onwebkitfullscreenerror)
        Sets the onwebkitfullscreenerror event handler for this element.
        Parameters:
        onwebkitfullscreenerror - the onwebkitfullscreenerror event handler for this element
      • setOnwheel

        public void setOnwheel(Object onwheel)
        Sets the onwheel event handler for this element.
        Parameters:
        onwheel - the onwheel event handler for this element
      • setCapture

        public void setCapture(boolean retargetToElement)
        Mock for the moment.
        Parameters:
        retargetToElement - if true, all events are targeted directly to this element; if false, events can also fire at descendants of this element
      • releaseCapture

        public void releaseCapture()
        Mock for the moment.
      • toggleAttribute

        public boolean toggleAttribute(String name,
         Object force)
        The toggleAttribute() method of the Element interface toggles a Boolean attribute (removing it if it is present and adding it if it is not present) on the given element. If force is true, adds boolean attribute with name. If force is false, removes attribute with name.
        Parameters:
        name - the name of the attribute to be toggled. The attribute name is automatically converted to all lower-case when toggleAttribute() is called on an HTML element in an HTML document.
        force - if true, the toggleAttribute method adds an attribute named name
        Returns:
        true if attribute name is eventually present, and false otherwise
        See Also:
        Element.toggleAttribute()
Skip navigation links

Copyright © 2002–2025 Gargoyle Software Inc.. All rights reserved.

AltStyle によって変換されたページ (->オリジナル) /