HTMLLinkElement

In This Article

The HTMLLinkElement interface represents reference information for external resources and the relationship of those resources to a document and vice-versa. This object inherits all of the properties and methods of the HTMLElement interface.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLinkElement" target="_top"><rect x="341" y="65" width="150" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="416" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLLinkElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

Inherits properties from its parent, HTMLElement, and LinkStyle.


HTMLLinkElement.as: Is a DOMString representing the type of content that is being loaded by the HTML link.
HTMLLinkElement.charset: Is a DOMString representing the character encoding for the target resource.
HTMLLinkElement.crossOrigin: Is a DOMString that corresponds to the CORS setting for this link element. See CORS settings attributes for details.
HTMLLinkElement.disabled: Is a Boolean which represents whether the link is disabled; currently only used with style sheet links.
HTMLLinkElement.href: Is a DOMString representing the URI for the target resource.
HTMLLinkElement.hreflang: Is a DOMString representing the language code for the linked resource.
HTMLLinkElement.media: Is a DOMString representing a list of one or more media formats to which the resource applies.
HTMLLinkElement.referrerPolicy: Is a DOMString that reflects the referrerpolicy HTML attribute indicating which referrer to use.
HTMLLinkElement.rel: Is a DOMString representing the forward relationship of the linked resource from the document to the resource.
HTMLLinkElement.relList Read only: Is a DOMTokenList that reflects the rel HTML attribute, as a list of tokens.
HTMLLinkElement.rev: Is a DOMString representing the reverse relationship of the linked resource from the resource to the document.
HTMLLinkElement.sizes Read only: Is a DOMSettableTokenList that reflects the sizes HTML attribute, as a list of tokens.
LinkStyle.sheet Read only: Returns the StyleSheet object associated with the given element, or null if there is none.
HTMLLinkElement.target: Is a DOMString representing the name of the target frame to which the resource applies.
HTMLLinkElement.type: Is a DOMString representing the MIME type of the linked resource.

Methods

No specific method; inherits methods from its parent, HTMLElement, and LinkStyle.

Specifications

Specification	Status	Comment
Preload	Working Draft	Defines `<link rel="preload">`, and the `as` property.
HTML Living Standard The definition of 'HTMLLinkElement' in that specification.	Living Standard	Adds the following properties: `crossOrigin`, `referrerPolicy`, and `as`.
HTML 5.1 The definition of 'HTMLLinkElement' in that specification.	Recommendation
HTML5 The definition of 'HTMLLinkElement' in that specification.	Recommendation	The following properties are now obsolete: `charset`, `rev`, and `shape`. The following properties have been added: `relList`, and `sizes`.
Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLLinkElement' in that specification.	Obsolete	Added a second inheritence, the `LinkStyle` interface.
Document Object Model (DOM) Level 1 Specification The definition of 'HTMLLinkElement' in that specification.	Obsolete	Initial definition.

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	(Yes)	(Yes)	1.0 (1.7 or earlier)	(Yes)	(Yes)	(Yes)
`sizes`	(Yes)	No support	No support	?	(Yes)	?
`crossOrigin`	(Yes)	No support	18 (18)	?	(Yes)	?
`referrerPolicy`	58	No support	50 (50)	?	45	?
`as`	50	?	56 (56)	?	(Yes)	(Yes)

Feature	Android Webview	Chrome for Android	Edge	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	(Yes)	(Yes)	(Yes)	1.0 (1.0)	(Yes)	(Yes)	(Yes)
`sizes`	(Yes)	(Yes)	No support	No support	?	(Yes)	?
`crossOrigin`	(Yes)	(Yes)	No support	18.0 (18)	?	(Yes)	?
`referrerPolicy`	58	58	No support	50.0 (50)	?	45	?
`as`	50	50	?	56.0 (56)	?	(Yes)	?

Document Tags and Contributors

Tags:

Contributors to this page: chrisdavidmills, Sebastianz, jpmedley, erikadoyle, fscholz, slimsag, teoli, kscarfone, Sheppy, ethertank, ThomasACorey

Last updated by: chrisdavidmills, Jul 21, 2017, 3:54:43 AM