diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
commit | 36d22d82aa202bb199967e9512281e9a53db42c9 (patch) | |
tree | 105e8c98ddea1c1e4784a60a5a6410fa416be2de /layout/style/MediaQueryList.h | |
parent | Initial commit. (diff) | |
download | firefox-esr-upstream.tar.xz firefox-esr-upstream.zip |
Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'layout/style/MediaQueryList.h')
-rw-r--r-- | layout/style/MediaQueryList.h | 103 |
1 files changed, 103 insertions, 0 deletions
diff --git a/layout/style/MediaQueryList.h b/layout/style/MediaQueryList.h new file mode 100644 index 0000000000..0fab987f91 --- /dev/null +++ b/layout/style/MediaQueryList.h @@ -0,0 +1,103 @@ +/* -*- 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 http://mozilla.org/MPL/2.0/. */ + +/* implements DOM interface for querying and observing media queries */ + +#ifndef mozilla_dom_MediaQueryList_h +#define mozilla_dom_MediaQueryList_h + +#include "nsISupports.h" +#include "nsCycleCollectionParticipant.h" +#include "nsCOMPtr.h" +#include "nsTArray.h" +#include "mozilla/LinkedList.h" +#include "mozilla/Attributes.h" +#include "nsWrapperCache.h" +#include "mozilla/DOMEventTargetHelper.h" +#include "mozilla/dom/MediaQueryListBinding.h" + +namespace mozilla::dom { + +class MediaList; + +class MediaQueryList final : public DOMEventTargetHelper, + public LinkedListElement<MediaQueryList> { + public: + // The caller who constructs is responsible for calling Evaluate + // before calling any other methods. + MediaQueryList(Document* aDocument, const nsACString& aMediaQueryList, + CallerType); + + private: + ~MediaQueryList(); + + public: + NS_DECL_ISUPPORTS_INHERITED + NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(MediaQueryList, DOMEventTargetHelper) + + nsISupports* GetParentObject() const; + + // Returns whether we need to notify of the change event using + // FireChangeEvent(). + [[nodiscard]] bool MediaFeatureValuesChanged(); + void FireChangeEvent(); + + JSObject* WrapObject(JSContext* aCx, + JS::Handle<JSObject*> aGivenProto) override; + + // WebIDL methods + void GetMedia(nsACString& aMedia) const; + bool Matches(); + void AddListener(EventListener* aListener, ErrorResult& aRv); + void RemoveListener(EventListener* aListener, ErrorResult& aRv); + + using DOMEventTargetHelper::EventListenerAdded; + void EventListenerAdded(nsAtom* aType) override; + + IMPL_EVENT_HANDLER(change) + + bool HasListeners() const; + + void Disconnect(); + + size_t SizeOfExcludingThis(MallocSizeOf aMallocSizeOf) const; + + private: + void LastRelease() final { + auto* listElement = static_cast<LinkedListElement<MediaQueryList>*>(this); + if (listElement->isInList()) { + listElement->remove(); + } + } + + void RecomputeMatches(); + + // We only need a pointer to the document to support lazy + // reevaluation following dynamic changes. However, this lazy + // reevaluation is perhaps somewhat important, since some usage + // patterns may involve the creation of large numbers of + // MediaQueryList objects which almost immediately become garbage + // (after a single call to the .matches getter). + // + // This pointer does make us a little more dependent on cycle + // collection. + // + // We have a non-null mDocument for our entire lifetime except + // after cycle collection unlinking. Having a non-null mDocument + // is equivalent to being in that document's mDOMMediaQueryLists + // linked list. + RefPtr<Document> mDocument; + const RefPtr<const MediaList> mMediaList; + bool mMatches = false; + bool mMatchesValid = false; + // Whether our MediaList depends on our viewport size. Our medialist is + // immutable, so we can just compute this once and carry on with our lives. + const bool mViewportDependent; +}; + +} // namespace mozilla::dom + +#endif /* !defined(mozilla_dom_MediaQueryList_h) */ |