public class HtmlAnchor extends HtmlElement
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_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 |
---|---|
<P extends Page> |
click(Event event,
boolean shiftKey,
boolean ctrlKey,
boolean altKey,
boolean ignoreVisibility)
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
protected boolean |
doClickStateUpdate(boolean shiftKey,
boolean ctrlKey)
This method implements the control state update part of the click action.
|
protected void |
doClickStateUpdate(boolean shiftKey,
boolean ctrlKey,
String hrefSuffix)
Same as
doClickStateUpdate(boolean, boolean) , except that it accepts an href suffix,
needed when a click is performed on an image map to pass information on the click position. |
String |
getAccessKeyAttribute()
Returns the value of the attribute
accesskey . |
String |
getCharsetAttribute()
Returns the value of the attribute
charset . |
String |
getCoordsAttribute()
Returns the value of the attribute
coords . |
HtmlElement.DisplayStyle |
getDefaultStyleDisplay()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
String |
getDownloadAttribute()
Returns the value of the attribute
download . |
String |
getHrefAttribute()
Returns the value of the attribute
href . |
String |
getHrefLangAttribute()
Returns the value of the attribute
hreflang . |
String |
getNameAttribute()
Returns the value of the attribute
name . |
String |
getOnBlurAttribute()
Returns the value of the attribute
onblur . |
String |
getOnFocusAttribute()
Returns the value of the attribute
onfocus . |
String |
getPingAttribute()
Returns the value of the attribute
ping . |
String |
getRelAttribute()
Returns the value of the attribute
rel . |
String |
getRevAttribute()
Returns the value of the attribute
rev . |
String |
getShapeAttribute()
Returns the value of the attribute
shape . |
String |
getTabIndexAttribute()
Returns the value of the attribute
tabindex . |
String |
getTargetAttribute()
Returns the value of the attribute
target . |
static URL |
getTargetUrl(String href,
HtmlPage page)
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
String |
getTypeAttribute()
Returns the value of the attribute
type . |
boolean |
handles(Event event)
Indicates if the provided event can be applied to this node.
|
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 "/>")
|
Page |
openLinkInNewWindow()
Open this link in a new window, much as web browsers do when you shift-click a link or use the context
menu to open in a new window.
|
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, 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, isMouseOver, isStateUpdateFirst, matches, mouseDown, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseOver, mouseUp, mouseUp, preventDefault, printOpeningTagContentAsXml, 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, basicRemove, 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, 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 <P extends Page> P click(Event event, boolean shiftKey, boolean ctrlKey, boolean altKey, boolean ignoreVisibility) throws IOException
click
in class DomElement
P
- the page typeevent
- the click event usedshiftKey
- true
if SHIFT is pressed during the clickctrlKey
- true
if CTRL is pressed during the clickaltKey
- true
if ALT is pressed during the clickignoreVisibility
- whether to ignore visibility or notWebClient.getCurrentWindow()
IOException
- if an IO error occursprotected void doClickStateUpdate(boolean shiftKey, boolean ctrlKey, String hrefSuffix) throws IOException
doClickStateUpdate(boolean, boolean)
, except that it accepts an href
suffix,
needed when a click is performed on an image map to pass information on the click position.shiftKey
- true
if SHIFT is pressedctrlKey
- true
if CTRL is pressedhrefSuffix
- the suffix to add to the anchor's href
attribute
(for instance coordinates from an image map)IOException
- if an IO error occurspublic static URL getTargetUrl(String href, HtmlPage page) throws MalformedURLException
href
- the hrefpage
- the HtmlPageMalformedURLException
- if an IO error occursprotected 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 occurspublic final String getCharsetAttribute()
charset
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.charset
or an empty string if that attribute isn't definedpublic final String getTypeAttribute()
type
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.type
or an empty string if that attribute isn't definedpublic final String getNameAttribute()
name
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.name
or an empty string if that attribute isn't definedpublic final String getHrefAttribute()
href
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.href
or an empty string if that attribute isn't definedpublic final String getHrefLangAttribute()
hreflang
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.hreflang
or an empty string if that attribute isn't definedpublic final String getRelAttribute()
rel
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.rel
or an empty string if that attribute isn't definedpublic final String getRevAttribute()
rev
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.rev
or an empty string if that attribute isn't definedpublic final String getAccessKeyAttribute()
accesskey
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.accesskey
or an empty string if that attribute isn't definedpublic final String getShapeAttribute()
shape
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.shape
or an empty string if that attribute isn't definedpublic final String getCoordsAttribute()
coords
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.coords
or an empty string if that attribute isn't definedpublic final String getTabIndexAttribute()
tabindex
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.tabindex
or an empty string if that attribute isn't definedpublic final String getOnFocusAttribute()
onfocus
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.onfocus
or an empty string if that attribute isn't definedpublic final String getOnBlurAttribute()
onblur
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.onblur
or an empty string if that attribute isn't definedpublic final String getTargetAttribute()
target
. Refer to the
HTML 4.01
documentation for details on the use of this attribute.target
or an empty string if that attribute isn't definedpublic final Page openLinkInNewWindow() throws MalformedURLException
It should be noted that even web browsers will sometimes not give the expected result when using this method of following links. Links that have no real href and rely on JavaScript to do their work will fail.
TopLevelWindow
MalformedURLException
- if the href could not be converted to a valid URLprotected boolean isEmptyXmlTagExpanded()
DomElement
isEmptyXmlTagExpanded
in class DomElement
false
by defaultpublic 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 appliedpublic final String getPingAttribute()
ping
.ping
public final String getDownloadAttribute()
download
.download
Copyright © 2002–2024 Gargoyle Software Inc.. All rights reserved.