org.htmlunit.javascript.host

Class Element

java.lang.Object

org.htmlunit.corejs.javascript.SlotMapOwner

org.htmlunit.corejs.javascript.ScriptableObject

org.htmlunit.javascript.HtmlUnitScriptable

org.htmlunit.javascript.host.event.EventTarget

org.htmlunit.javascript.host.dom.Node

org.htmlunit.javascript.host.Element

All Implemented Interfaces:

Serializable, Cloneable, org.htmlunit.corejs.javascript.ConstProperties, org.htmlunit.corejs.javascript.debug.DebuggableObject, org.htmlunit.corejs.javascript.Scriptable, org.htmlunit.corejs.javascript.SymbolScriptable

Direct Known Subclasses:

HTMLElement, SVGElement

public class Element
extends Node

A JavaScript object for Element.

Author:

Ahmed Ashour, Marc Guillemot, Sudhan Moghe, Ronald Brill, Frank Danek, Anton Demydenko

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.ScriptableObject

org.htmlunit.corejs.javascript.ScriptableObject.DescriptorInfo, org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator, org.htmlunit.corejs.javascript.ScriptableObject.LambdaGetterFunction, org.htmlunit.corejs.javascript.ScriptableObject.LambdaSetterFunction

Field Summary

Fields inherited from class org.htmlunit.javascript.host.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Fields inherited from class org.htmlunit.corejs.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor and Description
Element()

Method Summary

Modifier and Type	Method and Description
static void	after(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just after this ChildNode.
static void	append(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Inserts a set of Node objects or string objects after the last child of the Element.
static void	before(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just before this ChildNode.
static Element	closest(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Traverses the element and its parents (heading toward the document root) until it finds a node that matches the specified CSS selector.
protected NamedNodeMap	createAttributesObject() Creates the JS object for the property attributes.
protected void	createEventHandler(String eventName, String attrValue) Create the event handler function from the attribute value.
String	getAttribute(String attributeName)
HtmlUnitScriptable	getAttributeNode(String name) Retrieves an attribute node by name.
HtmlUnitScriptable	getAttributeNodeNS(String namespaceURI, String localName) Returns the specified attribute.
String	getAttributeNS(String namespaceURI, String localName) Gets the specified attribute.
NamedNodeMap	getAttributes() Returns the attributes of this XML element.
DOMRect	getBoundingClientRect() Retrieves an object that specifies the bounds of a collection of TextRectangle objects.
int	getChildElementCount() Returns the current number of child elements.
HTMLCollection	getChildren() Gets the children of the current node.
DOMTokenList	getClassList() Gets the token list of class attribute.
String	getClassName_js() Returns the class defined for this element.
int	getClientHeight() Returns the clientHeight attribute.
int	getClientLeft() Returns the clientLeft attribute.
DOMRectList	getClientRects() Retrieves a collection of rectangles that describes the layout of the contents of an object or range within the client.
int	getClientTop() Returns clientTop attribute.
int	getClientWidth() Returns the clientWidth attribute.
DomElement	getDomNodeOrDie() Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.
HTMLCollection	getElementsByClassName(String className) Returns all the descendant elements with the specified class.
HTMLCollection	getElementsByTagName(String tagName) Returns all the descendant elements with the specified tag name.
HTMLCollection	getElementsByTagNameNS(Object namespaceURI, String localName) Returns a list of elements with the given tag name belonging to the given namespace.
Element	getFirstElementChild() Returns the first element child.
String	getHTML() The getHTML function.
String	getId() Returns the element ID.
String	getInnerHTML() Gets the innerHTML attribute.
protected String	getInnerHTML(DomNode domNode) Helper for getInnerHtml (to be reuses bei HTMLTemplate.
Element	getLastElementChild() Returns the last element child.
String	getLocalName() Returns the local name of this attribute.
String	getNamespaceURI() Returns the URI that identifies an XML namespace.
Element	getNextElementSibling() Returns the next element sibling.
org.htmlunit.corejs.javascript.Function	getOnbeforecopy() Returns the onbeforecopy event handler for this element.
org.htmlunit.corejs.javascript.Function	getOnbeforecut() Returns the onbeforecut event handler for this element.
org.htmlunit.corejs.javascript.Function	getOnbeforepaste() Returns the onbeforepaste event handler for this element.
org.htmlunit.corejs.javascript.Function	getOnsearch() Returns the onsearch event handler for this element.
org.htmlunit.corejs.javascript.Function	getOnwebkitfullscreenchange() Returns the onwebkitfullscreenchange event handler for this element.
org.htmlunit.corejs.javascript.Function	getOnwebkitfullscreenerror() Returns the onwebkitfullscreenerror event handler for this element.
org.htmlunit.corejs.javascript.Function	getOnwheel() Returns the onwheel event handler for this element.
String	getOuterHTML() Gets the outerHTML of the node.
Element	getParentElement() Gets the first ancestor instance of Element.
String	getPrefix() Returns the namespace prefix.
Element	getPreviousElementSibling() Returns the previous element sibling.
int	getScrollHeight() Gets the scrollHeight for this element.
int	getScrollLeft() Gets the scrollLeft value for this element.
int	getScrollTop() Gets the scrollTop value for this element.
int	getScrollWidth() Gets the scrollWidth for this element.
protected CSSStyleDeclaration	getStyle() Returns the style object for this element.
String	getTagName() Returns the tag name of this element.
boolean	hasAttribute(String name) Returns true when an attribute with a given name is specified on this element or has a default value.
boolean	hasAttributeNS(String namespaceURI, String localName) Test for attribute.
boolean	hasAttributes() Returns true when the current element has any attributes or not.
Node	insertAdjacentElement(String where, Object insertedElement) Inserts the given element into the element at the location.
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.
void	insertAdjacentText(String where, String text) Inserts the given text into the element at the specified location.
protected boolean	isDisplayNone() Returns whether the display is none or not.
protected boolean	isEndTagForbidden() Returns whether the end tag is forbidden or not.
void	jsConstructor() JavaScript constructor.
static boolean	matches(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Returns true if the element would be selected by the specified selector string; otherwise, returns false.
static boolean	mozMatchesSelector(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Returns true if the element would be selected by the specified selector string; otherwise, returns false.
static void	prepend(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Inserts a set of Node objects or string objects before the first child of the Element.
protected void	printChildren(StringBuilder builder, DomNode node, boolean html) Helper for getting code back from nodes.
protected void	printNode(StringBuilder builder, DomNode node, boolean html)
Node	querySelector(String selectors) Returns the first element within the document that matches the specified group of selectors.
NodeList	querySelectorAll(String selectors) Retrieves all element nodes from descendants of the starting element node that match any selector within the supplied selector strings.
void	releaseCapture() Mock for the moment.
void	remove() Removes the DOM node from its parent.
void	removeAttribute(String name) Removes the specified attribute.
void	removeAttributeNode(Attr attribute) Removes the specified attribute.
void	removeAttributeNS(String namespaceURI, String localName) Removes the specified attribute.
static void	replaceChildren(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Replaces the existing children of a Node with a specified new set of children.
static void	replaceWith(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Replaces the node with a set of Node or DOMString objects.
void	scroll(org.htmlunit.corejs.javascript.Scriptable x, org.htmlunit.corejs.javascript.Scriptable y) Scrolls to a particular set of coordinates inside a given element.
void	scrollBy(org.htmlunit.corejs.javascript.Scriptable x, org.htmlunit.corejs.javascript.Scriptable y) Scrolls the element by the given amount.
void	scrollIntoView() Implement the scrollIntoView() JavaScript function but don't actually do anything.
void	scrollIntoViewIfNeeded() Implement the scrollIntoViewIfNeeded() JavaScript function but don't actually do anything.
void	scrollTo(org.htmlunit.corejs.javascript.Scriptable x, org.htmlunit.corejs.javascript.Scriptable y) Scrolls to a particular set of coordinates inside a given element.
void	setAttribute(String name, String value) Sets an attribute.
Attr	setAttributeNode(Attr newAtt) Sets the attribute node for the specified attribute.
void	setAttributeNS(String namespaceURI, String qualifiedName, String value) Sets the specified attribute.
void	setCapture(boolean retargetToElement) Mock for the moment.
void	setClassName_js(String className) Sets the class attribute for this element.
void	setDomNode(DomNode domNode) Sets the DOM node that corresponds to this JavaScript object.
void	setId(String newId) Sets the id value for this element.
void	setInnerHTML(Object value) Replaces all child elements of this element with the supplied value.
void	setOnbeforecopy(Object onbeforecopy) Sets the onbeforecopy event handler for this element.
void	setOnbeforecut(Object onbeforecut) Sets the onbeforecut event handler for this element.
void	setOnbeforepaste(Object onbeforepaste) Sets the onbeforepaste event handler for this element.
void	setOnsearch(Object onsearch) Sets the onsearch event handler for this element.
void	setOnwebkitfullscreenchange(Object onwebkitfullscreenchange) Sets the onwebkitfullscreenchange event handler for this element.
void	setOnwebkitfullscreenerror(Object onwebkitfullscreenerror) Sets the onwebkitfullscreenerror event handler for this element.
void	setOnwheel(Object onwheel) Sets the onwheel event handler for this element.
void	setOuterHTML(Object value) Replaces this element (including all child elements) with the supplied value.
void	setScrollLeft(int scroll) Sets the scrollLeft value for this element.
void	setScrollTop(int scroll) Sets the scrollTop value for this element.
protected void	setStyle(String style) Sets the styles for this element.
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.
static boolean	webkitMatchesSelector(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function) Returns true if the element would be selected by the specified selector string; otherwise, returns false.

Methods inherited from class org.htmlunit.javascript.host.dom.Node

after, append, appendChild, before, cloneNode, compareDocumentPosition, contains, getBaseURI, getChildNodes, getFirstChild, getJavaScriptNode, getLastChild, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParent, getParentNode, getPreviousSibling, getRootNode, getTextContent, hasChildNodes, insertBefore, insertBeforeImpl, isEqualNode, isSameNode, lookupPrefix, normalize, prepend, removeChild, replaceChild, replaceChildren, replaceWith, setNodeValue, setTextContent

Methods inherited from class org.htmlunit.javascript.host.event.EventTarget

addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventListenersContainer, hasEventHandlers, isEventHandlerOnWindow, removeEventListener, setEventHandler

Methods inherited from class org.htmlunit.javascript.HtmlUnitScriptable

clone, equivalentValues, get, getBrowserVersion, getClassName, getDefaultValue, getDomNodeOrNull, getPrototype, getScriptableFor, getWindow, getWindow, getWindowFromTopCallScope, getWithPreemption, has, hasInstance, initParentScope, makeScriptableFor, put, setClassName, setDomNode, setParentScope, setupPromise, setupRejectedPromise

Methods inherited from class org.htmlunit.corejs.javascript.ScriptableObject

applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkNotSealed, checkPropertyChangeForSlot, checkPropertyChangeForSlot, checkPropertyDefinition, checkSlotRemoval, defineBuiltinProperty, defineBuiltinProperty, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureScriptableObjectButNotSymbol, ensureSymbolScriptable, ensureType, get, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getSuperProperty, getSuperProperty, getSuperProperty, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, put, putConst, putConstProperty, putOwnProperty, putOwnProperty, putOwnProperty, putProperty, putProperty, putProperty, putSuperProperty, putSuperProperty, putSuperProperty, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setPrototype, size

Methods inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

createSlotMap

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

getAttributes

public NamedNodeMap getAttributes()

Returns the attributes of this XML element.

Overrides:

getAttributes in class Node

Returns:

the attributes of this XML element

See Also:

Gecko DOM Reference

createAttributesObject

protected NamedNodeMap createAttributesObject()

Creates the JS object for the property attributes. This object will 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

getParentElement

public Element getParentElement()

Gets the first ancestor instance of Element. It is mostly identical to Node.getParent() except that it skips non Element nodes.

Overrides:

getParentElement in class Node

Returns:

the parent element

See Also:

Node.getParent()

getChildren

public HTMLCollection getChildren()

Gets the children of the current node.

Overrides:

getChildren in class Node

Returns:

the child at the given position

See Also:

MSDN documentation

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

printNode

protected void printNode(StringBuilder builder,
                         DomNode node,
                         boolean html)

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

scroll

public void scroll(org.htmlunit.corejs.javascript.Scriptable x,
                   org.htmlunit.corejs.javascript.Scriptable y)

Scrolls to a particular set of coordinates inside a given element.

Parameters:

x - the horizontal pixel value that you want to scroll to

y - the vertical pixel value that you want to scroll to

scrollBy

public void scrollBy(org.htmlunit.corejs.javascript.Scriptable x,
                     org.htmlunit.corejs.javascript.Scriptable y)

Scrolls the element by the given amount.

Parameters:

x - the horizontal pixel value that you want to scroll by

y - the vertical pixel value that you want to scroll by

scrollTo

public void scrollTo(org.htmlunit.corejs.javascript.Scriptable x,
                     org.htmlunit.corejs.javascript.Scriptable y)

Scrolls to a particular set of coordinates inside a given element.

Parameters:

x - the horizontal pixel value that you want to scroll to

y - the vertical pixel value that you want to scroll to

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

getOnbeforecut

public org.htmlunit.corejs.javascript.Function getOnbeforecut()

Returns the onbeforecut event handler for this element.

Returns:

the onbeforecut 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

getOnsearch

public org.htmlunit.corejs.javascript.Function getOnsearch()

Returns the onsearch event handler for this element.

Returns:

the onsearch 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

getOnwheel

public org.htmlunit.corejs.javascript.Function getOnwheel()

Returns the onwheel event handler for this element.

Returns:

the onwheel 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

remove

public void remove()

Removes the DOM node from its parent.

Overrides:

remove in class Node

See Also:

MDN documentation

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.

before

public static void before(org.htmlunit.corejs.javascript.Context context,
                          org.htmlunit.corejs.javascript.Scriptable scope,
                          org.htmlunit.corejs.javascript.Scriptable thisObj,
                          Object[] args,
                          org.htmlunit.corejs.javascript.Function function)

Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just before this ChildNode.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function

after

public static void after(org.htmlunit.corejs.javascript.Context context,
                         org.htmlunit.corejs.javascript.Scriptable scope,
                         org.htmlunit.corejs.javascript.Scriptable thisObj,
                         Object[] args,
                         org.htmlunit.corejs.javascript.Function function)

Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just after this ChildNode.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function

replaceWith

public static void replaceWith(org.htmlunit.corejs.javascript.Context context,
                               org.htmlunit.corejs.javascript.Scriptable scope,
                               org.htmlunit.corejs.javascript.Scriptable thisObj,
                               Object[] args,
                               org.htmlunit.corejs.javascript.Function function)

Replaces the node with a set of Node or DOMString objects.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function

matches

public static boolean matches(org.htmlunit.corejs.javascript.Context context,
                              org.htmlunit.corejs.javascript.Scriptable scope,
                              org.htmlunit.corejs.javascript.Scriptable thisObj,
                              Object[] args,
                              org.htmlunit.corejs.javascript.Function function)

Returns true if the element would be selected by the specified selector string; otherwise, returns false.

Parameters:

context - the JavaScript context

scope - the scope

thisObj - the scriptable

args - the arguments passed into the method

function - the function

Returns:

the value

mozMatchesSelector

public static boolean mozMatchesSelector(org.htmlunit.corejs.javascript.Context context,
                                         org.htmlunit.corejs.javascript.Scriptable scope,
                                         org.htmlunit.corejs.javascript.Scriptable thisObj,
                                         Object[] args,
                                         org.htmlunit.corejs.javascript.Function function)

Returns true if the element would be selected by the specified selector string; otherwise, returns false.

Parameters:

context - the JavaScript context

scope - the scope

thisObj - the scriptable

args - the arguments passed into the method

function - the function

Returns:

the value

webkitMatchesSelector

public static boolean webkitMatchesSelector(org.htmlunit.corejs.javascript.Context context,
                                            org.htmlunit.corejs.javascript.Scriptable scope,
                                            org.htmlunit.corejs.javascript.Scriptable thisObj,
                                            Object[] args,
                                            org.htmlunit.corejs.javascript.Function function)

Returns true if the element would be selected by the specified selector string; otherwise, returns false.

Parameters:

context - the JavaScript context

scope - the scope

thisObj - the scriptable

args - the arguments passed into the method

function - the function

Returns:

the value

closest

public static Element closest(org.htmlunit.corejs.javascript.Context context,
                              org.htmlunit.corejs.javascript.Scriptable scope,
                              org.htmlunit.corejs.javascript.Scriptable thisObj,
                              Object[] args,
                              org.htmlunit.corejs.javascript.Function function)

Traverses the element and its parents (heading toward the document root) until it finds a node that matches the specified CSS selector.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function

Returns:

the found element or null

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()

append

public static void append(org.htmlunit.corejs.javascript.Context context,
                          org.htmlunit.corejs.javascript.Scriptable scope,
                          org.htmlunit.corejs.javascript.Scriptable thisObj,
                          Object[] args,
                          org.htmlunit.corejs.javascript.Function function)

Inserts a set of Node objects or string objects after the last child of the Element. String objects are inserted as equivalent Text nodes.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function

prepend

public static void prepend(org.htmlunit.corejs.javascript.Context context,
                           org.htmlunit.corejs.javascript.Scriptable scope,
                           org.htmlunit.corejs.javascript.Scriptable thisObj,
                           Object[] args,
                           org.htmlunit.corejs.javascript.Function function)

Inserts a set of Node objects or string objects before the first child of the Element. String objects are inserted as equivalent Text nodes.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function

replaceChildren

public static void replaceChildren(org.htmlunit.corejs.javascript.Context context,
                                   org.htmlunit.corejs.javascript.Scriptable scope,
                                   org.htmlunit.corejs.javascript.Scriptable thisObj,
                                   Object[] args,
                                   org.htmlunit.corejs.javascript.Function function)

Replaces the existing children of a Node with a specified new set of children. These can be string or Node objects.

Parameters:

context - the context

scope - the scope

thisObj - this object

args - the arguments

function - the function