HTMLLinkElement

Edit
Advanced
- History
- Print this article

Jump to:

Properties
Methods
Specifications
Browser compatibility
See also

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 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 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.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.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 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

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLLinkElement`	Chrome Full support Yes	Edge Full support Yes	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	Edge Mobile Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android ?
`as` Experimental	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	Edge Mobile No support No	Firefox Android Full support 56	Opera Android Full support 37	Safari iOS ?	Samsung Internet Android ?
`crossOrigin` Experimental	Chrome Full support Yes	Edge Full support 17	Firefox Full support 18	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile No support No	Firefox Android Full support 18	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?
`referrerPolicy`	Chrome Full support 51	Edge No support No	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	Edge Mobile No support No	Firefox Android Full support 50	Opera Android Full support 38	Safari iOS No support No	Samsung Internet Android ?
`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	Edge Mobile Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android ?
`relList`	Chrome Full support 54	Edge Full support 17	Firefox Full support 30	IE ?	Opera ?	Safari ?	WebView Android Full support 54	Chrome Android Full support 54	Edge Mobile No support No	Firefox Android Full support 30	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`sizes`	Chrome Full support Yes Notes Full support Yes Notes Notes Before Chrome 50, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Edge No support No	Firefox No support No	IE ?	Opera Full support Yes Notes Full support Yes Notes Notes Before Opera 37, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Safari ?	WebView Android Full support Yes Notes Full support Yes Notes Notes Before Chrome 50, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Chrome Android Full support Yes Notes Full support Yes Notes Notes Before Chrome 50, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Edge Mobile No support No	Firefox Android No support No	Opera Android Full support Yes Notes Full support Yes Notes Notes Before Opera 37, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Safari iOS ?	Samsung Internet Android ?

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.

Document Tags and Contributors

Tags:

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

Last updated by: mdnwebdocs-bot, Mar 18, 2019, 4:55:01 PM