Package org.htmlunit.html
Class HtmlLink
- java.lang.Object
-
- org.htmlunit.html.DomNode
-
- org.htmlunit.html.DomNamespaceNode
-
- org.htmlunit.html.DomElement
-
- org.htmlunit.html.HtmlElement
-
- org.htmlunit.html.HtmlLink
-
- All Implemented Interfaces:
java.io.Serializable,java.lang.Cloneable,org.w3c.dom.Element,org.w3c.dom.Node
public class HtmlLink extends HtmlElement
Wrapper for the HTML element "link". Note: This is not a clickable link, that one is an HtmlAnchor- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.htmlunit.html.HtmlElement
HtmlElement.DisplayStyle
-
Nested classes/interfaces inherited from class org.htmlunit.html.DomElement
DomElement.ChildElementsIterator
-
Nested classes/interfaces inherited from class org.htmlunit.html.DomNode
DomNode.ChildIterator, DomNode.DescendantElementsIterator<T extends DomNode>
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringTAG_NAMEThe HTML tag represented by this element.-
Fields inherited from class org.htmlunit.html.HtmlElement
ATTRIBUTE_CHECKED, ATTRIBUTE_REQUIRED, TAB_INDEX_OUT_OF_BOUNDS
-
Fields inherited from class org.htmlunit.html.DomElement
ATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY, SRC_ATTRIBUTE
-
Fields inherited from class org.htmlunit.html.DomNode
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
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.StringgetCharsetAttribute()Returns the value of the attributecharset.HtmlElement.DisplayStylegetDefaultStyleDisplay()INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns the default display style.java.lang.StringgetHrefAttribute()Returns the value of the attributehref.java.lang.StringgetHrefLangAttribute()Returns the value of the attributehreflang.java.lang.StringgetMediaAttribute()Returns the value of the attributemedia.java.lang.StringgetRelAttribute()Returns the value of the attributerel.java.lang.StringgetRevAttribute()Returns the value of the attributerev.java.lang.StringgetTargetAttribute()Returns the value of the attributetarget.java.lang.StringgetTypeAttribute()Returns the value of the attributetype.WebRequestgetWebRequest()Returns the request which will allow us to retrieve the content referenced by thehrefattribute.WebResponsegetWebResponse(boolean downloadIfNeeded)POTENIAL PERFORMANCE KILLER - DOWNLOADS THE RESOURCE - USE AT YOUR OWN RISK.
If the linked content is not already downloaded it triggers a download.WebResponsegetWebResponse(boolean downloadIfNeeded, WebRequest request)INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
If the linked content is not already downloaded it triggers a download.booleanisStyleSheetLink()booleanmayBeDisplayed()Returnstrueif nodes of this type can ever be displayed,falseotherwise.voidonAllChildrenAddedToPage(boolean postponed)Lifecycle method invoked after a node and all its children have been added to a page, during parsing of the HTML.-
Methods inherited from class org.htmlunit.html.HtmlElement
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, handles, hasEventHandlers, isAltPressed, isAttributeCaseSensitive, isCtrlPressed, isDisplayed, isHidden, isOptional, isRequired, isRequiredSupported, isShiftPressed, isSubmittableByEnter, isValid, notifyAttributeChangeListeners, removeAttribute, removeChild, removeHtmlAttributeChangeListener, setAttributeNode, setAttributeNS, setRequired, type, type, type, type, typeDone
-
Methods inherited from class org.htmlunit.html.DomElement
blur, click, click, click, click, click, dblClick, dblClick, doClickFireChangeEvent, doClickFireClickEvent, doClickStateUpdate, fireEvent, fireEvent, focus, getAttribute, getAttributeDirect, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getChildElementCount, getChildElements, getElementsByTagName, getElementsByTagNameNS, getEventTargetElement, getFirstElementChild, getId, getLastElementChild, getNodeType, getSchemaTypeInfo, getStyleElement, getStyleElementCaseInSensitive, getStyleMap, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isDisabledElementAndDisabled, isEmptyXmlTagExpanded, 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
-
Methods inherited from class org.htmlunit.html.DomNamespaceNode
getLocalName, getLowercaseName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix
-
Methods inherited from class org.htmlunit.html.DomNode
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, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAddedToPage, parseHtmlSnippet, printChildrenAsXml, querySelector, querySelectorAll, quietlyRemoveAndMoveChildrenTo, remove, removeAllChildren, removeCharacterDataChangeListener, removeChild, removeDomChangeListener, replace, replaceChild, setEndLocation, setParentNode, setReadyState, setScriptableObject, setStartLocation, 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, setPrefix, setTextContent, setUserData
-
-
-
-
Field Detail
-
TAG_NAME
public static final java.lang.String TAG_NAME
The HTML tag represented by this element.- See Also:
- Constant Field Values
-
-
Method Detail
-
getCharsetAttribute
public final java.lang.String getCharsetAttribute()
Returns the value of the attributecharset. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
charsetor an empty string if that attribute isn't defined.
-
getHrefAttribute
public final java.lang.String getHrefAttribute()
Returns the value of the attributehref. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
hrefor an empty string if that attribute isn't defined.
-
getHrefLangAttribute
public final java.lang.String getHrefLangAttribute()
Returns the value of the attributehreflang. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
hreflangor an empty string if that attribute isn't defined.
-
getTypeAttribute
public final java.lang.String getTypeAttribute()
Returns the value of the attributetype. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
typeor an empty string if that attribute isn't defined.
-
getRelAttribute
public final java.lang.String getRelAttribute()
Returns the value of the attributerel. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
relor an empty string if that attribute isn't defined.
-
getRevAttribute
public final java.lang.String getRevAttribute()
Returns the value of the attributerev. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
revor an empty string if that attribute isn't defined.
-
getMediaAttribute
public final java.lang.String getMediaAttribute()
Returns the value of the attributemedia. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
mediaor an empty string if that attribute isn't defined.
-
getTargetAttribute
public final java.lang.String getTargetAttribute()
Returns the value of the attributetarget. Refer to the HTML 4.01 documentation for details on the use of this attribute.- Returns:
- the value of the attribute
targetor an empty string if that attribute isn't defined.
-
getWebResponse
public WebResponse getWebResponse(boolean downloadIfNeeded) throws java.io.IOException
POTENIAL PERFORMANCE KILLER - DOWNLOADS THE RESOURCE - USE AT YOUR OWN RISK.
If the linked content is not already downloaded it triggers a download. Then it stores the response for later use.- Parameters:
downloadIfNeeded- indicates if a request should be performed this hasn't been done previously- Returns:
nullif no download should be performed and when this wasn't already done; the response received when performing a request for the content referenced by this tag otherwise- Throws:
java.io.IOException- if an error occurs while downloading the content
-
getWebResponse
public WebResponse getWebResponse(boolean downloadIfNeeded, WebRequest request) throws java.io.IOException
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
If the linked content is not already downloaded it triggers a download. Then it stores the response for later use.- Parameters:
downloadIfNeeded- indicates if a request should be performed this hasn't been done previouslyrequest- the request; if null getWebRequest() is called to create one- Returns:
nullif no download should be performed and when this wasn't already done; the response received when performing a request for the content referenced by this tag otherwise- Throws:
java.io.IOException- if an error occurs while downloading the content
-
getWebRequest
public WebRequest getWebRequest() throws java.net.MalformedURLException
Returns the request which will allow us to retrieve the content referenced by thehrefattribute.- Returns:
- the request which will allow us to retrieve the content referenced by the
hrefattribute - Throws:
java.net.MalformedURLException- in case of problem resolving the URL
-
getDefaultStyleDisplay
public HtmlElement.DisplayStyle getDefaultStyleDisplay()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns the default display style.- Overrides:
getDefaultStyleDisplayin classHtmlElement- Returns:
- the default display style
-
mayBeDisplayed
public boolean mayBeDisplayed()
Returnstrueif nodes of this type can ever be displayed,falseotherwise. Examples of nodes that can never be displayed are<head>,<meta>,<script>, etc.- Overrides:
mayBeDisplayedin classDomNode- Returns:
trueif nodes of this type can ever be displayed,falseotherwise- See Also:
DomNode.isDisplayed()
-
onAllChildrenAddedToPage
public void onAllChildrenAddedToPage(boolean postponed)
Lifecycle method invoked after a node and all its children have been added to a page, during parsing of the HTML. Intended to be overridden by nodes which need to perform custom logic after they and all their child nodes have been processed by the HTML parser. This method is not recursive, and the default implementation is empty, so there is no need to callsuper.onAllChildrenAddedToPage()if you implement this method.- Overrides:
onAllChildrenAddedToPagein classDomNode- Parameters:
postponed- whether to usePostponedActionor no
-
isStyleSheetLink
public boolean isStyleSheetLink()
- Returns:
- true if the rel attribute is 'stylesheet'
-
-