public class HtmlOption extends ClickableElement implements DisabledElement
HtmlElement.ChildElementsIterator
DomNode.ChildIterator, DomNode.DescendantElementsIterator
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.
|
protected Page |
doClickAction(Page defaultPage)
Selects the option if it's not already selected.
|
String |
getDisabledAttribute()
Returns the value of the attribute "disabled".
|
HtmlSelect |
getEnclosingSelect()
Gets the enclosing select of this option.
|
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 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 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 |
setText(String text)
Sets the text for this HtmlOption.
|
void |
setValueAttribute(String newValue)
Sets the value of the attribute "value".
|
getClassAttribute, getIdAttribute, getStyleAttribute, getTitleAttribute
addHtmlAttributeChangeListener, appendChildIfNoneExists, blur, checkChildHierarchy, click, click, click, dblClick, dblClick, doType, fireEvent, fireEvent, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, focus, getChildElements, getElementById, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getEventHandler, getHtmlElementsByTagName, getHtmlElementsByTagNames, getId, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasHtmlElementWithId, isAttributeCaseSensitive, isStateUpdateFirst, isSubmittableByEnter, mouseDown, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseOver, mouseUp, mouseUp, preventDefault, removeAttribute, removeChild, removeEventHandler, removeHtmlAttributeChangeListener, rightClick, rightClick, setAttributeNS, setEventHandler, setEventHandler, setId, toString, type, type, type, type
cloneNode, getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getElementsByTagName, getElementsByTagNameNS, getNodeType, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isEmptyXmlTagExpanded, namespaces, printXml, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
getLocalName, getNamespaceURI, getPrefix, getQualifiedName, setPrefix
addDomChangeListener, appendChild, asXml, compareDocumentPosition, fireNodeAdded, fireNodeDeleted, getAllHtmlChildElements, getAncestors, getBaseURI, getByXPath, getCanonicalXPath, getChildNodes, getChildren, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstChild, getLastChild, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousSibling, getReadyState, getScriptObject, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, hasChildNodes, insertBefore, isAncestorOf, isBlock, isDefaultNamespace, isDisplayed, isEqualNode, isSameNode, isSupported, isTrimmedText, lookupNamespaceURI, lookupPrefix, normalize, notifyIncorrectness, onAddedToPage, onAllChildrenAddedToPage, printChildrenAsXml, remove, removeAllChildren, removeChild, removeDomChangeListener, replace, replaceChild, selectNodes, selectSingleNode, 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 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"protected Page doClickAction(Page defaultPage) throws IOException
This method will be called if there either wasn't an onclick handler, or if there was one, but the result of that handler wasn't false. This is the default behavior of clicking the element.
The default implementation returns the current page. Subclasses requiring different
behavior (like HtmlSubmitInput
) will override this method.
doClickAction
in class HtmlElement
defaultPage
- the default page to return if the action does not load a new pageIOException
- if an IO error occursprotected 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()
Copyright © 2002–2014 Gargoyle Software Inc.. All rights reserved.