public class HtmlOption extends HtmlElement implements DisabledElement
HtmlElement.DisplayStyle
DomElement.ChildElementsIterator
DomNode.ChildIterator, DomNode.DescendantElementsIterator<T extends DomNode>
Modifier and Type | Field and Description |
---|---|
static String |
TAG_NAME
The HTML tag represented by this element.
|
TAB_INDEX_OUT_OF_BOUNDS
ATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY
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
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
Modifier and Type | Method and Description |
---|---|
String |
asText()
Returns a textual representation of this element that represents what would
be visible to the user if this page was shown in a web browser.
|
<P extends Page> |
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. |
protected boolean |
doClickStateUpdate()
Selects the option if it's not already selected.
|
HtmlElement.DisplayStyle |
getDefaultStyleDisplay()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns the default display style. |
String |
getDisabledAttribute()
Returns the value of the attribute "disabled".
|
HtmlSelect |
getEnclosingSelect()
Gets the enclosing select of this option.
|
protected DomNode |
getEventTargetElement()
Returns the event target element.
|
String |
getLabelAttribute()
Returns the value of the attribute "label".
|
String |
getSelectedAttribute()
Returns the value of the attribute "selected".
|
String |
getText()
Gets the text.
|
String |
getValueAttribute()
Returns the value of the attribute "value".
|
void |
insertBefore(DomNode newNode)
Inserts the specified node as a new child node before this node into the child relationship this node is a
part of.
|
boolean |
isDefaultSelected()
Returns whether this Option is selected by default.
|
boolean |
isDisabled()
Returns true if the disabled attribute is set for this element.
|
boolean |
isSelected()
Returns true if this option is currently selected.
|
protected boolean |
isStateUpdateFirst()
Returns true if state updates should be done before onclick event handling.
|
Page |
mouseDown(boolean shiftKey,
boolean ctrlKey,
boolean altKey,
int button)
Selects the option if it's not already selected.
|
Page |
mouseUp(boolean shiftKey,
boolean ctrlKey,
boolean altKey,
int button)
Selects the option if it's not already selected.
|
protected void |
printOpeningTagContentAsXml(PrintWriter printWriter)
Prints the content between "<" and ">" (or "/>") in the output of the tag name
and its attributes in XML format.
|
void |
reset()
Resets the option to its original selected state.
|
void |
setLabelAttribute(String newLabel)
Sets the value of the attribute "label".
|
Page |
setSelected(boolean selected)
Sets the selected state of this option.
|
void |
setSelected(boolean selected,
boolean invokeOnFocus)
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Sets the selected state of this option. |
void |
setText(String text)
Sets the text for this HtmlOption.
|
void |
setValueAttribute(String newValue)
Sets the value of the attribute "value".
|
addHtmlAttributeChangeListener, appendChildIfNoneExists, blur, checkChildHierarchy, click, click, dblClick, dblClick, doClickFireChangeEvent, doClickFireClickEvent, doType, fireEvent, fireEvent, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, focus, getCanonicalXPath, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getHtmlElementsByTagName, getHtmlElementsByTagNames, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getSrcAttributeNormalized, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasEventHandlers, isAttributeCaseSensitive, isDisplayed, isSubmittableByEnter, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseOver, mouseUp, preventDefault, propagateClickStateUpdateToParent, querySelector, querySelectorAll, removeAttribute, removeChild, removeEventHandler, removeHtmlAttributeChangeListener, rightClick, rightClick, setAttributeNode, setAttributeNS, setEventHandler, setEventHandler, setId, toString, type, type, type, type, type, type
cloneNode, getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getChildElementCount, getChildElements, getElementsByTagName, getElementsByTagNameNS, getFirstElementChild, getId, getLastElementChild, getNextElementSibling, getNodeType, getPreviousElementSibling, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isEmptyXmlTagExpanded, namespaces, printXml, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNodeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
getLocalName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix
addDomChangeListener, appendChild, asXml, compareDocumentPosition, detach, fireNodeAdded, fireNodeDeleted, getAncestors, getBaseURI, getByXPath, getByXPath, getChildNodes, getChildren, getDescendants, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstByXPath, getFirstChild, getHtmlElementDescendants, getHtmlPageOrNull, getIndex, getLastChild, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousSibling, getReadyState, getScriptObject, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, hasChildNodes, hasFeature, insertBefore, isAncestorOf, isAncestorOfAny, isBlock, isDefaultNamespace, isDescendant, isDirectlyAttachedToPage, isEqualNode, isSameNode, isSupported, isTrimmedText, lookupNamespaceURI, lookupPrefix, mayBeDisplayed, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAddedToPage, onAllChildrenAddedToPage, printChildrenAsXml, remove, removeAllChildren, removeChild, removeDomChangeListener, replace, replaceChild, setNextSibling, setNodeValue, setParentNode, setPreviousSibling, setReadyState, setScriptObject, setTextContent, setUserData
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
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
public static final String TAG_NAME
public boolean isSelected()
public Page setSelected(boolean selected)
selected
- true if this option should be selectedpublic void setSelected(boolean selected, boolean invokeOnFocus)
selected
- true if this option should be selectedinvokeOnFocus
- whether to set focus or not.public void insertBefore(DomNode newNode) throws IllegalStateException
insertBefore
in class DomNode
newNode
- the new node to insertIllegalStateException
- if this node is not a child of any other nodepublic HtmlSelect getEnclosingSelect()
null
if no select is found (for instance malformed HTML)public void reset()
public final String getSelectedAttribute()
public final boolean isDefaultSelected()
public final boolean isDisabled()
isDisabled
in interface DisabledElement
public final String getDisabledAttribute()
getDisabledAttribute
in interface DisabledElement
public final String getLabelAttribute()
public final void setLabelAttribute(String newLabel)
newLabel
- the value of the attribute "label"public final String getValueAttribute()
public final void setValueAttribute(String newValue)
newValue
- the value of the attribute "value"public Page mouseDown(boolean shiftKey, boolean ctrlKey, boolean altKey, int button)
mouseDown
in class HtmlElement
shiftKey
- true if SHIFT is pressed during the mouse clickctrlKey
- true if CTRL is pressed during the mouse clickaltKey
- true if ALT is pressed during the mouse clickbutton
- the button code, must be MouseEvent.BUTTON_LEFT
, MouseEvent.BUTTON_MIDDLE
or MouseEvent.BUTTON_RIGHT
public Page mouseUp(boolean shiftKey, boolean ctrlKey, boolean altKey, int button)
mouseUp
in class HtmlElement
shiftKey
- true if SHIFT is pressed during the mouse click releasectrlKey
- true if CTRL is pressed during the mouse click releasealtKey
- true if ALT is pressed during the mouse click releasebutton
- the button code, must be MouseEvent.BUTTON_LEFT
, MouseEvent.BUTTON_MIDDLE
or MouseEvent.BUTTON_RIGHT
public <P extends Page> P click(Event event) throws IOException
click
in class HtmlElement
P
- the page typeevent
- the click event usedWebClient.getCurrentWindow()
IOException
- if an IO error occursprotected boolean doClickStateUpdate() throws IOException
The default implementation only calls doClickStateUpdate on parent's HtmlElement (if any).
Subclasses requiring different behavior (like HtmlSubmitInput
) will override this method.
doClickStateUpdate
in class HtmlElement
IOException
- if an IO error occursprotected DomNode getEventTargetElement()
getEventTargetElement
in class HtmlElement
protected boolean isStateUpdateFirst()
HtmlCheckBoxInput
.isStateUpdateFirst
in class HtmlElement
protected void printOpeningTagContentAsXml(PrintWriter printWriter)
printOpeningTagContentAsXml
in class DomElement
printWriter
- the writer to print inpublic String asText()
public void setText(String text)
text
- the textpublic String getText()
public HtmlElement.DisplayStyle getDefaultStyleDisplay()
getDefaultStyleDisplay
in class HtmlElement
Copyright © 2002–2015 Gargoyle Software Inc.. All rights reserved.