HTMLLinkElement - Web API 接口参考 编辑

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="/wiki/zh-CN/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="/wiki/zh-CN/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="/wiki/zh-CN/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/wiki/zh-CN/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="/wiki/zh-CN/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 只读

Is a DOMTokenList that reflects the rel HTML attribute, as a list of tokens.

HTMLLinkElement.sizes 只读

Is a DOMSettableTokenList that reflects the sizes HTML attribute, as a list of tokens.

LinkStyle.sheet 只读

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 HTMLLinkElement	Living Standard	Adds the following properties: crossOrigin, referrerPolicy, and as.
HTML 5.1 HTMLLinkElement	Recommendation
HTML5 HTMLLinkElement	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 HTMLLinkElement	Obsolete	Added a second inheritence, the LinkStyle interface.
Document Object Model (DOM) Level 1 Specification HTMLLinkElement	Obsolete	Initial definition.

Browser compatibility

BCD tables only load in the browser

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.

See also

• The HTML element implementing this interface: <link>.