我们的志愿者还没有将这篇文章翻译为 中文 (简体)。加入我们帮助完成翻译!
您也可以阅读此文章的English (US)版。
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 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.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 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.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. 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
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) | ? |
See also
- The HTML element implementing this interface:
<link>
.