com.gargoylesoftware.htmlunit.html

Class DomElement

java.lang.Object

com.gargoylesoftware.htmlunit.html.DomNode

com.gargoylesoftware.htmlunit.html.DomNamespaceNode

com.gargoylesoftware.htmlunit.html.DomElement

All Implemented Interfaces:

Serializable, Cloneable, Element, ElementTraversal, Node

Direct Known Subclasses:

HtmlElement, SvgElement

public class DomElement
extends DomNamespaceNode
implements Element, ElementTraversal

Author:

Ahmed Ashour, Marc Guillemot, Tom Anderson, Ronald Brill

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DomElement.ChildElementsIterator An iterator over the DomElement children.

Nested classes/interfaces inherited from class com.gargoylesoftware.htmlunit.html.DomNode

DomNode.ChildIterator, DomNode.DescendantElementsIterator<T extends DomNode>

Field Summary

Fields

Modifier and Type	Field and Description
static String	ATTRIBUTE_NOT_DEFINED Constant meaning that the specified attribute was not defined.
static String	ATTRIBUTE_VALUE_EMPTY Constant meaning that the specified attribute was found but its value was empty.

Fields inherited from class com.gargoylesoftware.htmlunit.html.DomNode

AS_TEXT_BLANK, AS_TEXT_BLOCK_SEPARATOR, AS_TEXT_NEW_LINE, AS_TEXT_TAB, PROPERTY_ELEMENT, READY_STATE_COMPLETE, READY_STATE_INTERACTIVE, READY_STATE_LOADED, READY_STATE_LOADING, READY_STATE_UNINITIALIZED

Fields inherited from interface org.w3c.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

Constructor Summary

Constructors

Constructor and Description
DomElement(String namespaceURI, String qualifiedName, SgmlPage page, Map<String,DomAttr> attributes) Creates an instance of a DOM element that can have a namespace.

Method Summary

Methods

Modifier and Type	Method and Description
void	blur() Removes focus from this element.
<P extends Page> P	click() Simulates clicking on this element, returning the page in the window that has the focus after the element has been clicked.
<P extends Page> P	click(boolean shiftKey, boolean ctrlKey, boolean altKey) Simulates clicking on this element, returning the page in the window that has the focus after the element has been clicked.
<P extends Page> P	click(Event event) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK. Simulates clicking on this element, returning the page in the window that has the focus after the element has been clicked.
DomNode	cloneNode(boolean deep)
<P extends Page> P	dblClick() Simulates double-clicking on this element, returning the page in the window that has the focus after the element has been clicked.
<P extends Page> P	dblClick(boolean shiftKey, boolean ctrlKey, boolean altKey) Simulates double-clicking on this element, returning the page in the window that has the focus after the element has been clicked.
protected void	doClickFireChangeEvent() This method implements the control onchange handler call during the click action.
protected ScriptResult	doClickFireClickEvent(Event event) This method implements the control onclick handler call during the click action.
protected boolean	doClickStateUpdate() This method implements the control state update part of the click action.
ScriptResult	fireEvent(Event event) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK. Fires the event on the element.
ScriptResult	fireEvent(String eventType) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK. Shortcut for fireEvent(Event).
void	focus() Sets the focus on this element.
String	getAttribute(String attributeName) Returns the value of the attribute specified by name or an empty string.
DomAttr	getAttributeNode(String name)
DomAttr	getAttributeNodeNS(String namespaceURI, String localName)
String	getAttributeNS(String namespaceURI, String localName) Returns the value of the attribute specified by namespace and local name or an empty string.
NamedNodeMap	getAttributes()
Map<String,DomAttr>	getAttributesMap() Returns the map holding the attributes, keyed by name.
int	getChildElementCount()
Iterable<DomElement>	getChildElements()
DomNodeList<HtmlElement>	getElementsByTagName(String tagName)
DomNodeList<HtmlElement>	getElementsByTagNameNS(String namespace, String localName) Not yet implemented.
protected DomNode	getEventTargetElement() Returns the event target element.
DomElement	getFirstElementChild()
String	getId()
DomElement	getLastElementChild()
DomElement	getNextElementSibling()
String	getNodeName() Returns this node's node name.
short	getNodeType() Returns this node's node type.
DomElement	getPreviousElementSibling()
TypeInfo	getSchemaTypeInfo() Not yet implemented.
String	getTagName() Returns the tag name of this element.
boolean	hasAttribute(String attributeName) Returns whether the attribute specified by name has a value.
boolean	hasAttributeNS(String namespaceURI, String localName) Returns whether the attribute specified by namespace and local name has a value.
boolean	hasAttributes()
protected boolean	isAttributeCaseSensitive() Indicates if the attribute names are case sensitive.
protected boolean	isEmptyXmlTagExpanded() Indicates if a node without children should be written in expanded form as XML (i.e.
boolean	isMouseOver() Returns whether the Mouse is currently over this element or not.
protected boolean	isStateUpdateFirst() Returns true if state updates should be done before onclick event handling.
Page	mouseDown() Simulates clicking the mouse on this element, returning the page which this element's window contains after the mouse click.
Page	mouseDown(boolean shiftKey, boolean ctrlKey, boolean altKey, int button) Simulates clicking the mouse on this element, returning the page which this element's window contains after the mouse click.
Page	mouseMove() Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move.
Page	mouseMove(boolean shiftKey, boolean ctrlKey, boolean altKey, int button) Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move.
Page	mouseOut() Simulates moving the mouse out of this element, returning the page which this element's window contains after the mouse move.
Page	mouseOut(boolean shiftKey, boolean ctrlKey, boolean altKey, int button) Simulates moving the mouse out of this element, returning the page which this element's window contains after the mouse move.
Page	mouseOver() Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move.
Page	mouseOver(boolean shiftKey, boolean ctrlKey, boolean altKey, int button) Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move.
Page	mouseUp() Simulates releasing the mouse click on this element, returning the page which this element's window contains after the mouse click release.
Page	mouseUp(boolean shiftKey, boolean ctrlKey, boolean altKey, int button) Simulates releasing the mouse click on this element, returning the page which this element's window contains after the mouse click release.
protected Map<String,String>	namespaces() Returns namespaces.
protected void	preventDefault() This method is called if the current fired event is canceled by preventDefault() in FireFox, or by returning false in Internet Explorer.
protected void	printOpeningTagContentAsXml(PrintWriter printWriter) Prints the content between "<" and ">" (or "/>") in the output of the tag name and its attributes in XML format.
protected void	printXml(String indent, PrintWriter printWriter) Recursively write the XML data for the node tree starting at node.
protected boolean	propagateClickStateUpdateToParent()
void	removeAttribute(String attributeName) Removes an attribute specified by name from this element.
Attr	removeAttributeNode(Attr attribute) Not yet implemented.
void	removeAttributeNS(String namespaceURI, String localName) Removes an attribute specified by namespace and local name from this element.
void	removeFocus() INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK. Gets notified that it has lost the focus.
Page	rightClick() Simulates right clicking the mouse on this element, returning the page which this element's window contains after the mouse click.
Page	rightClick(boolean shiftKey, boolean ctrlKey, boolean altKey) Simulates right clicking the mouse on this element, returning the page which this element's window contains after the mouse click.
void	setAttribute(String attributeName, String attributeValue) Sets the value of the attribute specified by name.
Attr	setAttributeNode(Attr attribute)
Attr	setAttributeNodeNS(Attr attribute) Not yet implemented.
void	setAttributeNS(String namespaceURI, String qualifiedName, String attributeValue) Sets the value of the attribute specified by namespace and qualified name.
void	setIdAttribute(String name, boolean isId) Not yet implemented.
void	setIdAttributeNode(Attr idAttr, boolean isId) Not yet implemented.
void	setIdAttributeNS(String namespaceURI, String localName, boolean isId) Not yet implemented.
String	toString() Returns a string representation of this element.

Methods inherited from class com.gargoylesoftware.htmlunit.html.DomNamespaceNode

getLocalName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix

Methods inherited from class com.gargoylesoftware.htmlunit.html.DomNode

addCharacterDataChangeListener, addDomChangeListener, appendChild, asText, asXml, checkChildHierarchy, compareDocumentPosition, detach, fireCharacterDataChanged, fireNodeAdded, fireNodeDeleted, getAncestors, getBaseURI, getByXPath, getByXPath, getCanonicalXPath, getChildNodes, getChildren, getDescendants, getDomElementDescendants, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstByXPath, getFirstChild, getHtmlElementDescendants, getHtmlPageOrNull, getIndex, getLastChild, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousSibling, getReadyState, getScriptableObject, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, handles, hasChildNodes, hasFeature, insertBefore, insertBefore, isAncestorOf, isAncestorOfAny, isAttachedToPage, isDefaultNamespace, isDisplayed, isEqualNode, isSameNode, isSupported, isTrimmedText, lookupNamespaceURI, lookupPrefix, mayBeDisplayed, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAddedToPage, onAllChildrenAddedToPage, printChildrenAsXml, querySelector, querySelectorAll, remove, removeAllChildren, removeCharacterDataChangeListener, removeChild, removeDomChangeListener, replace, replaceChild, setNextSibling, setNodeValue, setParentNode, setPreviousSibling, setReadyState, setScriptableObject, setTextContent, setUserData

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.w3c.dom.Node

appendChild, compareDocumentPosition, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Field Detail

ATTRIBUTE_NOT_DEFINED

public static final String ATTRIBUTE_NOT_DEFINED

Constant meaning that the specified attribute was not defined.

ATTRIBUTE_VALUE_EMPTY

public static final String ATTRIBUTE_VALUE_EMPTY

Constant meaning that the specified attribute was found but its value was empty.

Constructor Detail

DomElement

public DomElement(String namespaceURI,
          String qualifiedName,
          SgmlPage page,
          Map<String,DomAttr> attributes)

Creates an instance of a DOM element that can have a namespace.

Parameters:

namespaceURI - the URI that identifies an XML namespace

qualifiedName - the qualified name of the element type to instantiate

page - the page that contains this element

attributes - a map ready initialized with the attributes for this element, or null. The map will be stored as is, not copied.

Method Detail

getNodeName

public String getNodeName()

Returns this node's node name.

Specified by:

getNodeName in interface Node

Specified by:

getNodeName in class DomNode

Returns:

this node's node name

getNodeType

public final short getNodeType()

Returns this node's node type.

Specified by:

getNodeType in interface Node

Specified by:

getNodeType in class DomNode

Returns:

this node's node type

namespaces

protected Map<String,String> namespaces()

Returns namespaces.

Returns:

namespaces

getTagName

public final String getTagName()

Returns the tag name of this element.

Specified by:

getTagName in interface Element

Returns:

the tag name of this element

hasAttributes

public final boolean hasAttributes()

Specified by:

hasAttributes in interface Node

Overrides:

hasAttributes in class DomNode

hasAttribute

public boolean hasAttribute(String attributeName)

Returns whether the attribute specified by name has a value.

Specified by:

hasAttribute in interface Element

Parameters:

attributeName - the name of the attribute

Returns:

true if an attribute with the given name is specified on this element or has a default value, false otherwise.

printOpeningTagContentAsXml

protected void printOpeningTagContentAsXml(PrintWriter printWriter)

Prints the content between "<" and ">" (or "/>") in the output of the tag name and its attributes in XML format.

Parameters:

printWriter - the writer to print in

printXml

protected void printXml(String indent,
            PrintWriter printWriter)

Recursively write the XML data for the node tree starting at node.

Overrides:

printXml in class DomNode

Parameters:

indent - white space to indent child nodes

printWriter - writer where child nodes are written

isEmptyXmlTagExpanded

protected boolean isEmptyXmlTagExpanded()

Indicates if a node without children should be written in expanded form as XML (i.e. with closing tag rather than with "/>")

Returns:

false by default

getAttribute

public String getAttribute(String attributeName)

Returns the value of the attribute specified by name or an empty string. If the result is an empty string then it will be either ATTRIBUTE_NOT_DEFINED if the attribute wasn't specified or ATTRIBUTE_VALUE_EMPTY if the attribute was specified but it was empty.

Specified by:

getAttribute in interface Element

Parameters:

attributeName - the name of the attribute

Returns:

the value of the attribute or ATTRIBUTE_NOT_DEFINED or ATTRIBUTE_VALUE_EMPTY

removeAttribute

public void removeAttribute(String attributeName)

Removes an attribute specified by name from this element.

Specified by:

removeAttribute in interface Element

Parameters:

attributeName - the attribute attributeName

removeAttributeNS

public final void removeAttributeNS(String namespaceURI,
                     String localName)

Removes an attribute specified by namespace and local name from this element.

Specified by:

removeAttributeNS in interface Element

Parameters:

namespaceURI - the URI that identifies an XML namespace

localName - the name within the namespace

removeAttributeNode

public final Attr removeAttributeNode(Attr attribute)

Not yet implemented.

Specified by:

removeAttributeNode in interface Element

hasAttributeNS

public final boolean hasAttributeNS(String namespaceURI,
                     String localName)

Returns whether the attribute specified by namespace and local name has a value.

Specified by:

hasAttributeNS in interface Element

Parameters:

namespaceURI - the URI that identifies an XML namespace

localName - the name within the namespace

Returns:

true if an attribute with the given name is specified on this element or has a default value, false otherwise.

getAttributesMap

public final Map<String,DomAttr> getAttributesMap()

Returns the map holding the attributes, keyed by name.

Returns:

the attributes map

getAttributes

public NamedNodeMap getAttributes()

Specified by:

getAttributes in interface Node

Overrides:

getAttributes in class DomNode

setAttribute

public final void setAttribute(String attributeName,
                String attributeValue)

Sets the value of the attribute specified by name.

Specified by:

setAttribute in interface Element

Parameters:

attributeName - the name of the attribute

attributeValue - the value of the attribute

setAttributeNS

public void setAttributeNS(String namespaceURI,
                  String qualifiedName,
                  String attributeValue)

Sets the value of the attribute specified by namespace and qualified name.

Specified by:

setAttributeNS in interface Element

Parameters:

namespaceURI - the URI that identifies an XML namespace

qualifiedName - the qualified name (prefix:local) of the attribute

attributeValue - the value of the attribute

isAttributeCaseSensitive

protected boolean isAttributeCaseSensitive()

Indicates if the attribute names are case sensitive.

Returns:

true

getAttributeNS

public final String getAttributeNS(String namespaceURI,
                    String localName)

Returns the value of the attribute specified by namespace and local name or an empty string. If the result is an empty string then it will be either ATTRIBUTE_NOT_DEFINED if the attribute wasn't specified or ATTRIBUTE_VALUE_EMPTY if the attribute was specified but it was empty.

Specified by:

getAttributeNS in interface Element

Parameters:

namespaceURI - the URI that identifies an XML namespace

localName - the name within the namespace

Returns:

the value of the attribute or ATTRIBUTE_NOT_DEFINED or ATTRIBUTE_VALUE_EMPTY

getAttributeNode

public DomAttr getAttributeNode(String name)

Specified by:

getAttributeNode in interface Element

getAttributeNodeNS

public DomAttr getAttributeNodeNS(String namespaceURI,
                         String localName)

Specified by:

getAttributeNodeNS in interface Element

getElementsByTagName

public DomNodeList<HtmlElement> getElementsByTagName(String tagName)

Specified by:

getElementsByTagName in interface Element

getElementsByTagNameNS

public DomNodeList<HtmlElement> getElementsByTagNameNS(String namespace,
                                              String localName)

Not yet implemented.

Specified by:

getElementsByTagNameNS in interface Element

getSchemaTypeInfo

public TypeInfo getSchemaTypeInfo()

Not yet implemented.

Specified by:

getSchemaTypeInfo in interface Element

setIdAttribute

public void setIdAttribute(String name,
                  boolean isId)

Not yet implemented.

Specified by:

setIdAttribute in interface Element

setIdAttributeNS

public void setIdAttributeNS(String namespaceURI,
                    String localName,
                    boolean isId)

Not yet implemented.

Specified by:

setIdAttributeNS in interface Element

setAttributeNode

public Attr setAttributeNode(Attr attribute)

Specified by:

setAttributeNode in interface Element

setAttributeNodeNS

public Attr setAttributeNodeNS(Attr attribute)

Not yet implemented.

Specified by:

setAttributeNodeNS in interface Element

setIdAttributeNode

public final void setIdAttributeNode(Attr idAttr,
                      boolean isId)

Not yet implemented.

Specified by:

setIdAttributeNode in interface Element

cloneNode

public DomNode cloneNode(boolean deep)

Specified by:

cloneNode in interface Node

Overrides:

cloneNode in class DomNode

getId

public final String getId()

Returns:

the identifier of this element

getFirstElementChild

public DomElement getFirstElementChild()

Specified by:

getFirstElementChild in interface ElementTraversal

getLastElementChild

public DomElement getLastElementChild()

Specified by:

getLastElementChild in interface ElementTraversal

getPreviousElementSibling

public DomElement getPreviousElementSibling()

Specified by:

getPreviousElementSibling in interface ElementTraversal

getNextElementSibling

public DomElement getNextElementSibling()

Specified by:

getNextElementSibling in interface ElementTraversal

getChildElementCount

public int getChildElementCount()

Specified by:

getChildElementCount in interface ElementTraversal

getChildElements

public final Iterable<DomElement> getChildElements()

Returns:

an Iterable over the DomElement children of this object, i.e. excluding the non-element nodes

toString

public String toString()

Returns a string representation of this element.

Overrides:

toString in class Object

Returns:

a string representation of this element

click

public <P extends Page> P click()
                     throws IOException

Simulates clicking on this element, returning the page in the window that has the focus after the element has been clicked. Note that the returned page may or may not be the same as the original page, depending on the type of element being clicked, the presence of JavaScript action listeners, etc.

Type Parameters:

P - the page type

Returns:

the page contained in the current window as returned by WebClient.getCurrentWindow()

Throws:

IOException - if an IO error occurs

click

public <P extends Page> P click(boolean shiftKey,
                       boolean ctrlKey,
                       boolean altKey)
                     throws IOException

Simulates clicking on this element, returning the page in the window that has the focus after the element has been clicked. Note that the returned page may or may not be the same as the original page, depending on the type of element being clicked, the presence of JavaScript action listeners, etc.

Type Parameters:

P - the page type

Parameters:

shiftKey - true if SHIFT is pressed during the click

ctrlKey - true if CTRL is pressed during the click

altKey - true if ALT is pressed during the click

Returns:

the page contained in the current window as returned by WebClient.getCurrentWindow()

Throws:

IOException - if an IO error occurs

getEventTargetElement

protected DomNode getEventTargetElement()

Returns the event target element. This could be overridden by subclasses to have other targets. The default implementation returns 'this'.

Returns:

the event target element.

click

public <P extends Page> P click(Event event)
                     throws IOException

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Simulates clicking on this element, returning the page in the window that has the focus after the element has been clicked. Note that the returned page may or may not be the same as the original page, depending on the type of element being clicked, the presence of JavaScript action listeners, etc.

Type Parameters:

P - the page type

Parameters:

event - the click event used

Returns:

the page contained in the current window as returned by WebClient.getCurrentWindow()

Throws:

IOException - if an IO error occurs

doClickStateUpdate

protected boolean doClickStateUpdate()
                              throws IOException

This method implements the control state update part of the click action.

The default implementation only calls doClickStateUpdate on parent's HtmlElement (if any). Subclasses requiring different behavior (like HtmlSubmitInput) will override this method.

Returns:

true if doClickFireEvent method has to be called later on (to signal, that the value was changed)

Throws:

IOException - if an IO error occurs

propagateClickStateUpdateToParent

protected boolean propagateClickStateUpdateToParent()

Returns:

true or false

See Also:

Usually the click is propagated to the parent. Overwrite if you like to disable this.

doClickFireChangeEvent

protected void doClickFireChangeEvent()

This method implements the control onchange handler call during the click action.

doClickFireClickEvent

protected ScriptResult doClickFireClickEvent(Event event)

This method implements the control onclick handler call during the click action.

Parameters:

event - the click event used

Returns:

the script result

dblClick

public <P extends Page> P dblClick()
                        throws IOException

Simulates double-clicking on this element, returning the page in the window that has the focus after the element has been clicked. Note that the returned page may or may not be the same as the original page, depending on the type of element being clicked, the presence of JavaScript action listeners, etc. Note also that click() is automatically called first.

Type Parameters:

P - the page type

Returns:

the page that occupies this element's window after the element has been double-clicked

Throws:

IOException - if an IO error occurs

dblClick

public <P extends Page> P dblClick(boolean shiftKey,
                          boolean ctrlKey,
                          boolean altKey)
                        throws IOException

Simulates double-clicking on this element, returning the page in the window that has the focus after the element has been clicked. Note that the returned page may or may not be the same as the original page, depending on the type of element being clicked, the presence of JavaScript action listeners, etc. Note also that click(boolean, boolean, boolean) is automatically called first.

Type Parameters:

P - the page type

Parameters:

shiftKey - true if SHIFT is pressed during the double-click

ctrlKey - true if CTRL is pressed during the double-click

altKey - true if ALT is pressed during the double-click

Returns:

the page that occupies this element's window after the element has been double-clicked

Throws:

IOException - if an IO error occurs

mouseOver

public Page mouseOver()

Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Returns:

the page which this element's window contains after the mouse move

mouseOver

public Page mouseOver(boolean shiftKey,
             boolean ctrlKey,
             boolean altKey,
             int button)

Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Parameters:

shiftKey - true if SHIFT is pressed during the mouse move

ctrlKey - true if CTRL is pressed during the mouse move

altKey - true if ALT is pressed during the mouse move

button - the button code, must be MouseEvent.BUTTON_LEFT, MouseEvent.BUTTON_MIDDLE or MouseEvent.BUTTON_RIGHT

Returns:

the page which this element's window contains after the mouse move

mouseMove

public Page mouseMove()

Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Returns:

the page which this element's window contains after the mouse move

mouseMove

public Page mouseMove(boolean shiftKey,
             boolean ctrlKey,
             boolean altKey,
             int button)

Simulates moving the mouse over this element, returning the page which this element's window contains after the mouse move. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Parameters:

shiftKey - true if SHIFT is pressed during the mouse move

ctrlKey - true if CTRL is pressed during the mouse move

altKey - true if ALT is pressed during the mouse move

button - the button code, must be MouseEvent.BUTTON_LEFT, MouseEvent.BUTTON_MIDDLE or MouseEvent.BUTTON_RIGHT

Returns:

the page which this element's window contains after the mouse move

mouseOut

public Page mouseOut()

Simulates moving the mouse out of this element, returning the page which this element's window contains after the mouse move. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Returns:

the page which this element's window contains after the mouse move

mouseOut

public Page mouseOut(boolean shiftKey,
            boolean ctrlKey,
            boolean altKey,
            int button)

Simulates moving the mouse out of this element, returning the page which this element's window contains after the mouse move. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Parameters:

shiftKey - true if SHIFT is pressed during the mouse move

ctrlKey - true if CTRL is pressed during the mouse move

altKey - true if ALT is pressed during the mouse move

button - the button code, must be MouseEvent.BUTTON_LEFT, MouseEvent.BUTTON_MIDDLE or MouseEvent.BUTTON_RIGHT

Returns:

the page which this element's window contains after the mouse move

mouseDown

public Page mouseDown()

Simulates clicking the mouse on this element, returning the page which this element's window contains after the mouse click. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Returns:

the page which this element's window contains after the mouse click

mouseDown

public Page mouseDown(boolean shiftKey,
             boolean ctrlKey,
             boolean altKey,
             int button)

Simulates clicking the mouse on this element, returning the page which this element's window contains after the mouse click. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Parameters:

shiftKey - true if SHIFT is pressed during the mouse click

ctrlKey - true if CTRL is pressed during the mouse click

altKey - true if ALT is pressed during the mouse click

button - the button code, must be MouseEvent.BUTTON_LEFT, MouseEvent.BUTTON_MIDDLE or MouseEvent.BUTTON_RIGHT

Returns:

the page which this element's window contains after the mouse click

mouseUp

public Page mouseUp()

Simulates releasing the mouse click on this element, returning the page which this element's window contains after the mouse click release. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Returns:

the page which this element's window contains after the mouse click release

mouseUp

public Page mouseUp(boolean shiftKey,
           boolean ctrlKey,
           boolean altKey,
           int button)

Simulates releasing the mouse click on this element, returning the page which this element's window contains after the mouse click release. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Parameters:

shiftKey - true if SHIFT is pressed during the mouse click release

ctrlKey - true if CTRL is pressed during the mouse click release

altKey - true if ALT is pressed during the mouse click release

button - the button code, must be MouseEvent.BUTTON_LEFT, MouseEvent.BUTTON_MIDDLE or MouseEvent.BUTTON_RIGHT

Returns:

the page which this element's window contains after the mouse click release

rightClick

public Page rightClick()

Simulates right clicking the mouse on this element, returning the page which this element's window contains after the mouse click. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Returns:

the page which this element's window contains after the mouse click

rightClick

public Page rightClick(boolean shiftKey,
              boolean ctrlKey,
              boolean altKey)

Simulates right clicking the mouse on this element, returning the page which this element's window contains after the mouse click. The returned page may or may not be the same as the original page, depending on JavaScript event handlers, etc.

Parameters:

shiftKey - true if SHIFT is pressed during the mouse click

ctrlKey - true if CTRL is pressed during the mouse click

altKey - true if ALT is pressed during the mouse click

Returns:

the page which this element's window contains after the mouse click

fireEvent

public ScriptResult fireEvent(String eventType)

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Shortcut for fireEvent(Event).

Parameters:

eventType - the event type (like "load", "click")

Returns:

the execution result, or null if nothing is executed

fireEvent

public ScriptResult fireEvent(Event event)

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Fires the event on the element. Nothing is done if JavaScript is disabled.

Parameters:

event - the event to fire

Returns:

the execution result, or null if nothing is executed

preventDefault

protected void preventDefault()

This method is called if the current fired event is canceled by preventDefault() in FireFox, or by returning false in Internet Explorer. The default implementation does nothing.

focus

public void focus()

Sets the focus on this element.

blur

public void blur()

Removes focus from this element.

removeFocus

public void removeFocus()

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Gets notified that it has lost the focus.

isStateUpdateFirst

protected boolean isStateUpdateFirst()

Returns true if state updates should be done before onclick event handling. This method returns false by default, and is expected to be overridden to return true by derived classes like HtmlCheckBoxInput.

Returns:

true if state updates should be done before onclick event handling

isMouseOver

public boolean isMouseOver()

Returns whether the Mouse is currently over this element or not.

Returns:

whether the Mouse is currently over this element or not