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:
Serializable, Cloneable, Element, 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:

  • Field Details

    • LOG

      private static final org.apache.commons.logging.Log LOG

    • TAG_NAME

      public static final String TAG_NAME
      The HTML tag represented by this element.
      See Also:

    • sheet_

      private CssStyleSheet sheet_
      The associated style sheet (only valid for links of type <link rel="stylesheet" type="text/css" href="..." />).

  • Constructor Details

    • HtmlLink

      HtmlLink(String qualifiedName, SgmlPage page, Map<String,DomAttr> attributes)
      Creates an instance of HtmlLink
      Parameters:
      qualifiedName - the qualified name of the element type to instantiate
      page - the HtmlPage that contains this element
      attributes - the initial attributes

  • Method Details

    • getCharsetAttribute

      public final String getCharsetAttribute()
      Returns the value of the attribute charset. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute charset or an empty string if that attribute isn't defined.

    • getHrefAttribute

      public final String getHrefAttribute()
      Returns the value of the attribute href. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute href or an empty string if that attribute isn't defined.

    • getHrefLangAttribute

      public final String getHrefLangAttribute()
      Returns the value of the attribute hreflang. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute hreflang or an empty string if that attribute isn't defined.

    • getTypeAttribute

      public final String getTypeAttribute()
      Returns the value of the attribute type. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute type or an empty string if that attribute isn't defined.

    • getRelAttribute

      public final String getRelAttribute()
      Returns the value of the attribute rel. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute rel or an empty string if that attribute isn't defined.

    • getRevAttribute

      public final String getRevAttribute()
      Returns the value of the attribute rev. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute rev or an empty string if that attribute isn't defined.

    • getMediaAttribute

      public final String getMediaAttribute()
      Returns the value of the attribute media. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute media or an empty string if that attribute isn't defined.

    • getTargetAttribute

      public final String getTargetAttribute()
      Returns the value of the attribute target. Refer to the HTML 4.01 documentation for details on the use of this attribute.
      Returns:
      the value of the attribute target or an empty string if that attribute isn't defined.

    • getWebResponse

      public WebResponse getWebResponse(boolean downloadIfNeeded) throws 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:
      null if 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:
      IOException - if an error occurs while downloading the content

    • getWebResponse

      public WebResponse getWebResponse(boolean downloadIfNeeded, WebRequest request) throws 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 previously
      request - the request; if null getWebRequest() is called to create one
      Returns:
      null if 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:
      IOException - if an error occurs while downloading the content

    • getWebRequest

      public WebRequest getWebRequest() throws MalformedURLException
      Returns the request which will allow us to retrieve the content referenced by the href attribute.
      Returns:
      the request which will allow us to retrieve the content referenced by the href attribute
      Throws:
      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:
      getDefaultStyleDisplay in class HtmlElement
      Returns:
      the default display style

    • mayBeDisplayed

      public boolean mayBeDisplayed()
      Returns true if nodes of this type can ever be displayed, false otherwise. Examples of nodes that can never be displayed are <head>, <meta>, <script>, etc.
      Overrides:
      mayBeDisplayed in class DomNode
      Returns:
      true if nodes of this type can ever be displayed, false otherwise
      See Also:

    • executeEvent

      private void executeEvent(String type)

    • 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 call super.onAllChildrenAddedToPage() if you implement this method.
      Overrides:
      onAllChildrenAddedToPage in class DomNode
      Parameters:
      postponed - whether to use PostponedAction or no

    • getSheet

      public CssStyleSheet getSheet()
      Returns the associated style sheet (only valid for links of type <link rel="stylesheet" type="text/css" href="..." />).
      Returns:
      the associated style sheet

    • isStyleSheetLink

      public boolean isStyleSheetLink()
      Returns:
      true if the rel attribute is 'stylesheet'

    • isActiveStyleSheetLink

      public boolean isActiveStyleSheetLink()

      Experimental API: May be changed in next release and may not yet work perfectly!

      Verifies if the provided node is a link node pointing to an active stylesheet.
      Returns:
      true if the provided node is a stylesheet link