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="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
.
- 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 that
rev
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 StandardThe definition of 'HTMLLinkElement' in that specification. | Living Standard | Adds the following properties: crossOrigin , referrerPolicy , and as .
|
HTML 5.1The definition of 'HTMLLinkElement' in that specification. | Recommendation | |
HTML5The definition of 'HTMLLinkElement' in that specification. | Recommendation | The following properties are now obsolete: charset , rev , and shape .
The following properties have been added: |
Document Object Model (DOM) Level 2 HTML SpecificationThe definition of 'HTMLLinkElement' in that specification. | Obsolete | Added a second inheritence, the LinkStyle interface.
|
Document Object Model (DOM) Level 1 SpecificationThe 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.
Update compatibility data on GitHub
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 |
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 | |
Chrome
Full support Yes |
Edge
Full support 17 |
Firefox
Full support 18 |
IE
No support No |
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
No support No |
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 Full support Yes Notes' Before Chrome 50, this property returned the deprecated child |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera Full support Yes Full support Yes Notes' Before Opera 37, this property returned the deprecated child |
Safari
Full support Yes |
WebView Android Full support Yes Full support Yes Notes' Before Chrome 50, this property returned the deprecated child |
Chrome Android Full support Yes Full support Yes Notes' Before Chrome 50, this property returned the deprecated child |
Firefox Android
No support No |
Opera Android Full support Yes Full support Yes Notes' Before Opera 37, this property returned the deprecated child |
Safari iOS
Full support Yes |
Samsung Internet Android Full support Yes Full support Yes Notes' Before Samsung Internet 5.0, this property returned the deprecated child |
Legend
- Full support
- Full support
- No support
- No support
- 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>
.
HTMLLinkElement by Mozilla Contributors is licensed under CC-BY-SA 2.5.