The HTMLLinkElement
interface represents reference information for external resources and the relationship of those resources to a document and vice-versa (corresponds to <link>
element; not to be confused with <a>
, which is represented by HTMLAnchorElement
). 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="/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="/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="/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="/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="/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 being loaded by the HTML link. 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 thereferrerpolicy
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 therel
HTML attribute, as a list of tokens. HTMLLinkElement.sizes
Read only- Is a
DOMSettableTokenList
that reflects thesizes
HTML attribute, as a list of tokens. LinkStyle.sheet
Read only- Returns the
StyleSheet
object associated with the given element, ornull
if there is none. HTMLLinkElement.type
- Is a
DOMString
representing the MIME type of the linked resource.
Obsolete properties
HTMLLinkElement.charset
- Is a
DOMString
representing the character encoding for the target resource. HTMLLinkElement.rev
- Is a
DOMString
representing the reverse relationship of the linked resource from the resource to the document.Note: Currently the W3C HTML 5.2 spec states thatrev
is no longer obsolete, whereas the WHATWG living standard still has it labeled obsolete. Until this discrepancy is resolved, you should still assume it is obsolete. HTMLLinkElement.target
- Is a
DOMString
representing the name of the target frame to which the resource applies.
Methods
No specific method; inherits methods from its parent, HTMLElement
, and LinkStyle
.
Specifications
Specification | Status | Comment |
---|---|---|
Preload | Candidate Recommendation | Defines <link rel="preload"> , and the as property. Note that currently Firefox only supports preloading of cacheable resources. |
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. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLLinkElement | Chrome Full support Yes | Edge Full support 12 | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
as | Chrome Full support 50 | Edge Full support 17 | Firefox Full support 56 | IE Full support Yes | Opera Full support 37 | Safari Full support Yes | WebView Android Full support 50 | Chrome Android Full support 50 | Firefox Android Full support 56 | Opera Android Full support 37 | Safari iOS Full support Yes | Samsung Internet Android Full support 5.0 |
crossOrigin | Chrome Full support Yes | Edge Full support 17 | Firefox Full support 18 | IE ? | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 18 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
referrerPolicy | Chrome Full support 51 | Edge Full support 79 | Firefox Full support 50 | IE No support No | Opera Full support 38 | Safari Full support 11.1 | WebView Android Full support 51 | Chrome Android Full support 51 | Firefox Android Full support 50 | Opera Android Full support 41 | Safari iOS No support No | Samsung Internet Android Full support 5.0 |
rel | Chrome Full support Yes | Edge Full support 12 | Firefox Full support Yes | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
relList | Chrome Full support 54 | Edge Full support 17 | Firefox Full support 30 | IE ? | Opera Full support Yes | Safari Full support Yes | WebView Android Full support 54 | Chrome Android Full support 54 | Firefox Android Full support 30 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support 6.0 |
sizes | Chrome
Full support
Yes
| Edge Full support 79 | Firefox No support No | IE ? | Opera
Full support
Yes
| Safari Full support Yes | WebView Android
Full support
Yes
| Chrome Android
Full support
Yes
| Firefox Android No support No | Opera Android
Full support
Yes
| Safari iOS Full support Yes | Samsung Internet Android
Full support
Yes
|
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
See also
- The HTML element implementing this interface:
<link>
.