From 6bf0a5cb5034a7e684dcc3500e841785237ce2dd Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 19:32:43 +0200 Subject: Adding upstream version 1:115.7.0. Signed-off-by: Daniel Baumann --- dom/xul/nsXULPrototypeDocument.h | 127 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 dom/xul/nsXULPrototypeDocument.h (limited to 'dom/xul/nsXULPrototypeDocument.h') diff --git a/dom/xul/nsXULPrototypeDocument.h b/dom/xul/nsXULPrototypeDocument.h new file mode 100644 index 0000000000..511f4b3e2b --- /dev/null +++ b/dom/xul/nsXULPrototypeDocument.h @@ -0,0 +1,127 @@ +/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* 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/. */ + +#ifndef nsXULPrototypeDocument_h__ +#define nsXULPrototypeDocument_h__ + +#include "js/TracingAPI.h" +#include "mozilla/Attributes.h" +#include "nsCOMArray.h" +#include "nsCOMPtr.h" +#include "nsTArray.h" +#include "nsISerializable.h" +#include "nsCycleCollectionParticipant.h" +#include + +class nsAtom; +class nsIPrincipal; +class nsIURI; +class nsNodeInfoManager; +class nsXULPrototypeElement; +class nsXULPrototypePI; + +namespace mozilla::dom { +class Element; +} + +/** + * A "prototype" document that stores shared document information + * for the XUL cache. + * Among other things, stores the tree of nsXULPrototype* + * objects, from which the real DOM tree is built later in + * PrototypeDocumentContentSink::ResumeWalk. + */ +class nsXULPrototypeDocument final : public nsISerializable { + public: + using Callback = std::function; + + // nsISupports interface + NS_DECL_CYCLE_COLLECTING_ISUPPORTS + + // nsISerializable interface + NS_DECL_NSISERIALIZABLE + + nsresult InitPrincipal(nsIURI* aURI, nsIPrincipal* aPrincipal); + nsIURI* GetURI(); + + /** + * Get/set the root nsXULPrototypeElement of the document. + */ + nsXULPrototypeElement* GetRootElement(); + void SetRootElement(nsXULPrototypeElement* aElement); + + /** + * Add a processing instruction to the prolog. Note that only + * PI nodes are currently stored in a XUL prototype document's + * prolog and that they're handled separately from the rest of + * prototype node tree. + * + * @param aPI an already adrefed PI proto to add. This method takes + * ownership of the passed PI. + */ + nsresult AddProcessingInstruction(nsXULPrototypePI* aPI); + /** + * @note GetProcessingInstructions retains the ownership (the PI + * protos only get deleted when the proto document is deleted) + */ + const nsTArray >& GetProcessingInstructions() const; + + nsIPrincipal* DocumentPrincipal(); + void SetDocumentPrincipal(nsIPrincipal* aPrincipal); + + /** + * If current prototype document has not yet finished loading, + * appends aDocument to the list of documents to notify (via + * PrototypeDocumentContentSink::OnPrototypeLoadDone()) and + * sets aLoaded to false. Otherwise sets aLoaded to true. + */ + nsresult AwaitLoadDone(Callback&& aCallback, bool* aResult); + + /** + * Notifies each document registered via AwaitLoadDone on this + * prototype document that the prototype has finished loading. + * The notification is performed by calling + * PrototypeDocumentContentSink::OnPrototypeLoadDone on the + * registered documents. + */ + nsresult NotifyLoadDone(); + + nsNodeInfoManager* GetNodeInfoManager(); + + void MarkInCCGeneration(uint32_t aCCGeneration); + + NS_DECL_CYCLE_COLLECTION_CLASS(nsXULPrototypeDocument) + + bool WasL10nCached() { return mWasL10nCached; }; + + void SetIsL10nCached(bool aIsCached); + void RebuildPrototypeFromElement(nsXULPrototypeElement* aPrototype, + mozilla::dom::Element* aElement, bool aDeep); + void RebuildL10nPrototype(mozilla::dom::Element* aElement, bool aDeep); + + protected: + nsCOMPtr mURI; + RefPtr mRoot; + nsTArray > mProcessingInstructions; + + bool mLoaded; + nsTArray mPrototypeWaiters; + + RefPtr mNodeInfoManager; + + uint32_t mCCGeneration; + + nsXULPrototypeDocument(); + virtual ~nsXULPrototypeDocument(); + nsresult Init(); + + friend NS_IMETHODIMP NS_NewXULPrototypeDocument( + nsXULPrototypeDocument** aResult); + + static uint32_t gRefCnt; + bool mWasL10nCached; +}; + +#endif // nsXULPrototypeDocument_h__ -- cgit v1.2.3