We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Nos bénévoles n'ont pas encore traduit cet article en Français. Inscrivez-vous et aidez-nous à réaliser cette tâche !
Vous pouvez également lire cet article en 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.

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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes1 Yes Yes Yes
as50 ?56 Yes37 Yes
crossOrigin Yes No18 ? Yes ?
referrerPolicy58 No50 ?45 ?
rel Yes Yes Yes Yes Yes Yes
relList50 ?30 ? ? ?
sizes Yes No No ? Yes ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes4 Yes Yes ?
as5050 ?5637 ? ?
crossOrigin Yes Yes No18 Yes ? ?
referrerPolicy5858 No5045 ? ?
rel Yes Yes Yes Yes Yes Yes ?
relList5050 ?30 ? ? ?
sizes Yes Yes No No Yes ? ?

See also

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

Étiquettes et contributeurs liés au document

Dernière mise à jour par : fscholz,