Source code

Revision control

Copy as Markdown

Other Tools

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at */
#ifndef mozilla_dom_HTMLLinkElement_h
#define mozilla_dom_HTMLLinkElement_h
#include "mozilla/Attributes.h"
#include "mozilla/dom/HTMLDNSPrefetch.h"
#include "mozilla/dom/LinkStyle.h"
#include "mozilla/dom/Link.h"
#include "mozilla/WeakPtr.h"
#include "nsDOMTokenList.h"
#include "nsGenericHTMLElement.h"
namespace mozilla {
class EventChainPostVisitor;
class EventChainPreVisitor;
class PreloaderBase;
namespace dom {
class HTMLLinkElement final : public nsGenericHTMLElement,
public LinkStyle,
public SupportsDNSPrefetch {
explicit HTMLLinkElement(
already_AddRefed<mozilla::dom::NodeInfo>&& aNodeInfo);
// nsISupports
// CC
void LinkAdded();
// nsINode
nsresult Clone(dom::NodeInfo*, nsINode** aResult) const override;
JSObject* WrapNode(JSContext* aCx,
JS::Handle<JSObject*> aGivenProto) override;
// nsIContent
nsresult BindToTree(BindContext&, nsINode& aParent) override;
void UnbindFromTree(UnbindContext&) override;
void BeforeSetAttr(int32_t aNameSpaceID, nsAtom* aName,
const nsAttrValue* aValue, bool aNotify) override;
void AfterSetAttr(int32_t aNameSpaceID, nsAtom* aName,
const nsAttrValue* aValue, const nsAttrValue* aOldValue,
nsIPrincipal* aSubjectPrincipal, bool aNotify) override;
// Element
bool ParseAttribute(int32_t aNamespaceID, nsAtom* aAttribute,
const nsAString& aValue,
nsIPrincipal* aMaybeScriptedPrincipal,
nsAttrValue& aResult) override;
void CreateAndDispatchEvent(const nsAString& aEventName);
// WebIDL
bool Disabled() const;
void SetDisabled(bool aDisabled, ErrorResult& aRv);
nsIURI* GetURI() {
if (!mCachedURI) {
GetURIAttr(nsGkAtoms::href, nullptr, getter_AddRefs(mCachedURI));
return mCachedURI.get();
void GetHref(nsAString& aValue) {
GetURIAttr(nsGkAtoms::href, nullptr, aValue);
void SetHref(const nsAString& aHref, nsIPrincipal* aTriggeringPrincipal,
ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::href, aHref, aTriggeringPrincipal, aRv);
void SetHref(const nsAString& aHref, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::href, aHref, aRv);
void GetCrossOrigin(nsAString& aResult) {
// Null for both missing and invalid defaults is ok, since we
// always parse to an enum value, so we don't need an invalid
// default, and we _want_ the missing default to be null.
GetEnumAttr(nsGkAtoms::crossorigin, nullptr, aResult);
void SetCrossOrigin(const nsAString& aCrossOrigin, ErrorResult& aError) {
SetOrRemoveNullableStringAttr(nsGkAtoms::crossorigin, aCrossOrigin, aError);
// nsAString for WebBrowserPersistLocalDocument
void GetRel(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::rel, aValue); }
void SetRel(const nsAString& aRel, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::rel, aRel, aRv);
nsDOMTokenList* RelList();
void GetMedia(DOMString& aValue) { GetHTMLAttr(nsGkAtoms::media, aValue); }
void SetMedia(const nsAString& aMedia, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::media, aMedia, aRv);
void GetHreflang(DOMString& aValue) {
GetHTMLAttr(nsGkAtoms::hreflang, aValue);
void SetHreflang(const nsAString& aHreflang, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::hreflang, aHreflang, aRv);
void GetAs(nsAString& aResult);
void SetAs(const nsAString& aAs, ErrorResult& aRv) {
SetAttr(nsGkAtoms::as, aAs, aRv);
nsDOMTokenList* Sizes() {
if (!mSizes) {
mSizes = new nsDOMTokenList(this, nsGkAtoms::sizes);
return mSizes;
void GetType(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::type, aValue); }
void SetType(const nsAString& aType, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::type, aType, aRv);
void GetCharset(nsAString& aValue) override {
GetHTMLAttr(nsGkAtoms::charset, aValue);
void SetCharset(const nsAString& aCharset, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::charset, aCharset, aRv);
void GetRev(DOMString& aValue) { GetHTMLAttr(nsGkAtoms::rev, aValue); }
void SetRev(const nsAString& aRev, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::rev, aRev, aRv);
void GetTarget(DOMString& aValue) { GetHTMLAttr(nsGkAtoms::target, aValue); }
void SetTarget(const nsAString& aTarget, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::target, aTarget, aRv);
void GetIntegrity(nsAString& aIntegrity) const {
GetHTMLAttr(nsGkAtoms::integrity, aIntegrity);
void SetIntegrity(const nsAString& aIntegrity, ErrorResult& aRv) {
SetHTMLAttr(nsGkAtoms::integrity, aIntegrity, aRv);
void SetReferrerPolicy(const nsAString& aReferrer, ErrorResult& aError) {
SetHTMLAttr(nsGkAtoms::referrerpolicy, aReferrer, aError);
void GetReferrerPolicy(nsAString& aReferrer) {
GetEnumAttr(nsGkAtoms::referrerpolicy, "", aReferrer);
void GetImageSrcset(nsAString& aImageSrcset) {
GetHTMLAttr(nsGkAtoms::imagesrcset, aImageSrcset);
void SetImageSrcset(const nsAString& aImageSrcset, ErrorResult& aError) {
SetHTMLAttr(nsGkAtoms::imagesrcset, aImageSrcset, aError);
void GetImageSizes(nsAString& aImageSizes) {
GetHTMLAttr(nsGkAtoms::imagesizes, aImageSizes);
void SetImageSizes(const nsAString& aImageSizes, ErrorResult& aError) {
SetHTMLAttr(nsGkAtoms::imagesizes, aImageSizes, aError);
CORSMode GetCORSMode() const {
return AttrValueToCORSMode(GetParsedAttr(nsGkAtoms::crossorigin));
nsDOMTokenList* Blocking();
bool IsPotentiallyRenderBlocking() override;
void NodeInfoChanged(Document* aOldDoc) final {
mCachedURI = nullptr;
virtual ~HTMLLinkElement();
void GetContentPolicyMimeTypeMedia(nsAttrValue& aAsAttr,
nsContentPolicyType& aPolicyType,
nsString& aMimeType, nsAString& aMedia);
void TryDNSPrefetchOrPreconnectOrPrefetchOrPreloadOrPrerender();
void UpdatePreload(nsAtom* aName, const nsAttrValue* aValue,
const nsAttrValue* aOldValue);
void CancelPrefetchOrPreload();
void StartPreload(nsContentPolicyType policyType);
void CancelPreload();
// Returns whether the type attribute specifies the text/css mime type for
// link elements.
static bool IsCSSMimeTypeAttributeForLinkElement(
const mozilla::dom::Element&);
// LinkStyle
nsIContent& AsContent() final { return *this; }
const LinkStyle* AsLinkStyle() const final { return this; }
Maybe<SheetInfo> GetStyleSheetInfo() final;
RefPtr<nsDOMTokenList> mRelList;
RefPtr<nsDOMTokenList> mSizes;
RefPtr<nsDOMTokenList> mBlocking;
// A weak reference to our preload is held only to cancel the preload when
// this node updates or unbounds from the tree. We want to prevent cycles,
// the preload is held alive by other means.
WeakPtr<PreloaderBase> mPreload;
// The cached href attribute value.
nsCOMPtr<nsIURI> mCachedURI;
// The "explicitly enabled" flag. This flag is set whenever the `disabled`
// attribute is explicitly unset, and makes alternate stylesheets not be
// disabled by default anymore.
bool mExplicitlyEnabled = false;
} // namespace dom
} // namespace mozilla
#endif // mozilla_dom_HTMLLinkElement_h