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.
|
ATTRIBUTE_CHECKED, ATTRIBUTE_HIDDEN, ATTRIBUTE_REQUIRED, TAB_INDEX_OUT_OF_BOUNDS
ATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY, ID_ATTRIBUTE, NAME_ATTRIBUTE, SRC_ATTRIBUTE, TYPE_ATTRIBUTE, VALUE_ATTRIBUTE
PROPERTY_ELEMENT, READY_STATE_COMPLETE, READY_STATE_INTERACTIVE, READY_STATE_LOADED, READY_STATE_LOADING, READY_STATE_UNINITIALIZED
ATTRIBUTE_DISABLED
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 |
---|---|
protected void |
basicRemove()
Cuts off all relationships this node has with siblings and parents.
|
protected boolean |
doClickStateUpdate(boolean shiftKey,
boolean ctrlKey)
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.
|
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 . |
boolean |
handles(Event event)
Indicates if the provided event can be applied to this node.
|
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 |
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.
|
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 |
setSelectedFromJavaScript(boolean selected)
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
void |
setText(String text)
Sets the text for this HtmlOption.
|
void |
setValueAttribute(String newValue)
Sets the value of the attribute
value . |
acceptChar, addHtmlAttributeChangeListener, appendChildIfNoneExists, checkChildHierarchy, cloneNode, detach, doType, doType, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, getCanonicalXPath, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getSrcAttributeNormalized, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasEventHandlers, isAltPressed, isAttributeCaseSensitive, isCtrlPressed, isDisplayed, isHidden, isOptional, isRequired, isRequiredSupported, isShiftPressed, isSubmittableByEnter, isValid, notifyAttributeChangeListeners, removeAttribute, removeChild, removeHtmlAttributeChangeListener, setAttributeNode, setAttributeNS, setHidden, setHidden, setOwningForm, setRequired, type, type, type, type, typeDone
blur, click, click, click, click, click, dblClick, dblClick, doClickFireChangeEvent, doClickFireClickEvent, fireEvent, fireEvent, focus, getAttribute, getAttributeDirect, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getChildElementCount, getChildElements, getElementsByTagName, getElementsByTagNameNS, getEventTargetElement, getFirstElementChild, getId, getLastElementChild, getNodeType, getSchemaTypeInfo, getStaticElementsByTagName, getStyleElement, getStyleElementCaseInSensitive, getStyleMap, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isDisabledElementAndDisabled, isEmptyXmlTagExpanded, isMouseOver, matches, mouseDown, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseUp, mouseUp, preventDefault, printXml, propagateClickStateUpdateToParent, removeAttributeNode, removeAttributeNS, removeFocus, removeStyleAttribute, replaceStyleAttribute, rightClick, rightClick, setAttribute, setAttributeNodeNS, setAttributeNS, setDefaults, setId, setIdAttribute, setIdAttributeNode, setIdAttributeNS, setInnerHtml, setNodeValue, toString, writeStyleToElement
getLocalName, getLowercaseName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix
addCharacterDataChangeListener, addDomChangeListener, appendChild, asNormalizedText, asXml, closest, compareDocumentPosition, fireCharacterDataChanged, fireNodeAdded, fireNodeDeleted, getAncestors, getBaseURI, getByXPath, getByXPath, getChildNodes, getChildren, getDescendants, getDomElementDescendants, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstByXPath, getFirstChild, getHtmlElementDescendants, getHtmlPageOrNull, getIndex, getLastChild, getNextElementSibling, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousElementSibling, getPreviousSibling, getReadyState, getScriptableObject, getSelectorList, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, getVisibleText, hasChildNodes, hasFeature, insertBefore, isAncestorOf, isAncestorOfAny, isAttachedToPage, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, mayBeDisplayed, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAddedToPage, onAllChildrenAddedToPage, parseHtmlSnippet, printChildrenAsXml, querySelector, querySelectorAll, quietlyRemoveAndMoveChildrenTo, remove, removeAllChildren, removeCharacterDataChangeListener, removeChild, removeDomChangeListener, replace, replaceChild, setEndLocation, setParentNode, setReadyState, setScriptableObject, setStartLocation, 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, setPrefix, setTextContent, setUserData
public static final String TAG_NAME
public boolean isSelected()
true
if this option is currently selected.true
if this option is currently selectedpublic Page setSelected(boolean selected)
selected
- true if this option should be selectedpublic void setSelectedFromJavaScript(boolean selected)
selected
- true if this option should be selectedpublic void insertBefore(DomNode newNode)
insertBefore
in class DomNode
newNode
- the new node to insertpublic HtmlSelect getEnclosingSelect()
null
if no select is found (for instance malformed HTML)public void reset()
public final String getSelectedAttribute()
selected
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.selected
or an empty string if that attribute isn't defined.public final boolean isDefaultSelected()
public final boolean isDisabled()
DisabledElement
true
if the disabled attribute is set for this element.isDisabled
in interface DisabledElement
true
if the disabled attribute is set for this elementpublic final String getDisabledAttribute()
disabled
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.getDisabledAttribute
in interface DisabledElement
disabled
or an empty string if that attribute isn't definedpublic final String getLabelAttribute()
label
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.label
or an empty string if that attribute isn't definedpublic final void setLabelAttribute(String newLabel)
label
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.newLabel
- the value of the attribute label
public final String getValueAttribute()
value
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.value
public final void setValueAttribute(String newValue)
value
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.newValue
- the value of the attribute value
protected boolean doClickStateUpdate(boolean shiftKey, boolean ctrlKey) throws IOException
The default implementation only calls doClickStateUpdate on parent's DomElement (if any).
Subclasses requiring different behavior (like HtmlSubmitInput
) will override this method.
doClickStateUpdate
in class DomElement
shiftKey
- true
if SHIFT is pressedctrlKey
- true
if CTRL is pressedIOException
- if an IO error occursprotected boolean isStateUpdateFirst()
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
.isStateUpdateFirst
in class DomElement
true
if state updates should be done before onclick event handlingprotected void printOpeningTagContentAsXml(PrintWriter printWriter)
printOpeningTagContentAsXml
in class DomElement
printWriter
- the writer to print inpublic void setText(String text)
text
- the textpublic String getText()
public Page mouseOver(boolean shiftKey, boolean ctrlKey, boolean altKey, int button)
mouseOver
in class DomElement
shiftKey
- true
if SHIFT is pressed during the mouse movectrlKey
- true
if CTRL is pressed during the mouse movealtKey
- true
if ALT is pressed during the mouse movebutton
- the button code, must be MouseEvent.BUTTON_LEFT
, MouseEvent.BUTTON_MIDDLE
or MouseEvent.BUTTON_RIGHT
public HtmlElement.DisplayStyle getDefaultStyleDisplay()
getDefaultStyleDisplay
in class HtmlElement
public boolean handles(Event event)
handles
in class HtmlElement
event
- the eventfalse
if the event can't be appliedprotected void basicRemove()
basicRemove
in class DomNode
Copyright © 2002–2024 Gargoyle Software Inc.. All rights reserved.