| /* |
| * Copyright (C) 2006, 2007, 2008, 2009, 2010, 2013 Apple Inc. All rights reserved. |
| * Copyright (C) 2008 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/) |
| * |
| * This library is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU Library General Public |
| * License as published by the Free Software Foundation; either |
| * version 2 of the License, or (at your option) any later version. |
| * |
| * This library is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| * Library General Public License for more details. |
| * |
| * You should have received a copy of the GNU Library General Public License |
| * along with this library; see the file COPYING.LIB. If not, write to |
| * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
| * Boston, MA 02110-1301, USA. |
| */ |
| |
| #ifndef Page_h |
| #define Page_h |
| |
| #include "core/CoreExport.h" |
| #include "core/dom/ViewportDescription.h" |
| #include "core/frame/Deprecation.h" |
| #include "core/frame/HostsUsingFeatures.h" |
| #include "core/frame/LocalFrame.h" |
| #include "core/frame/SettingsDelegate.h" |
| #include "core/frame/UseCounter.h" |
| #include "core/page/Page.h" |
| #include "core/page/PageAnimator.h" |
| #include "core/page/PageVisibilityNotifier.h" |
| #include "core/page/PageVisibilityObserver.h" |
| #include "core/page/PageVisibilityState.h" |
| #include "platform/Supplementable.h" |
| #include "platform/geometry/LayoutRect.h" |
| #include "platform/geometry/Region.h" |
| #include "platform/heap/Handle.h" |
| #include "wtf/Forward.h" |
| #include "wtf/HashSet.h" |
| #include "wtf/Noncopyable.h" |
| #include "wtf/text/WTFString.h" |
| |
| namespace blink { |
| |
| class AutoscrollController; |
| class ChromeClient; |
| class ClientRectList; |
| class ContextMenuClient; |
| class ContextMenuController; |
| class Document; |
| class DragCaretController; |
| class DragController; |
| class EditorClient; |
| class FocusController; |
| class Frame; |
| class FrameHost; |
| class PluginData; |
| class PointerLockController; |
| class ScrollingCoordinator; |
| class Settings; |
| class SpellCheckerClient; |
| class ValidationMessageClient; |
| class WebLayerTreeView; |
| |
| typedef uint64_t LinkHash; |
| |
| float deviceScaleFactor(LocalFrame*); |
| |
| class CORE_EXPORT Page final : public GarbageCollectedFinalized<Page>, public Supplementable<Page>, public PageVisibilityNotifier, public SettingsDelegate { |
| USING_GARBAGE_COLLECTED_MIXIN(Page); |
| WTF_MAKE_NONCOPYABLE(Page); |
| friend class Settings; |
| public: |
| // It is up to the platform to ensure that non-null clients are provided where required. |
| struct CORE_EXPORT PageClients final { |
| STACK_ALLOCATED(); |
| WTF_MAKE_NONCOPYABLE(PageClients); |
| public: |
| PageClients(); |
| ~PageClients(); |
| |
| Member<ChromeClient> chromeClient; |
| ContextMenuClient* contextMenuClient; |
| EditorClient* editorClient; |
| SpellCheckerClient* spellCheckerClient; |
| }; |
| |
| static Page* create(PageClients& pageClients) |
| { |
| return new Page(pageClients); |
| } |
| |
| // An "ordinary" page is a fully-featured page owned by a web view. |
| static Page* createOrdinary(PageClients&); |
| |
| ~Page() override; |
| |
| void willBeClosed(); |
| |
| using PageSet = PersistentHeapHashSet<WeakMember<Page>>; |
| |
| // Return the current set of full-fledged, ordinary pages. |
| // Each created and owned by a WebView. |
| // |
| // This set does not include Pages created for other, internal purposes |
| // (SVGImages, inspector overlays, page popups etc.) |
| static PageSet& ordinaryPages(); |
| |
| static void platformColorsChanged(); |
| |
| FrameHost& frameHost() const { return *m_frameHost; } |
| |
| void setNeedsRecalcStyleInAllFrames(); |
| void updateAcceleratedCompositingSettings(); |
| |
| ViewportDescription viewportDescription() const; |
| |
| static void refreshPlugins(); |
| PluginData* pluginData() const; |
| |
| EditorClient& editorClient() const { return *m_editorClient; } |
| SpellCheckerClient& spellCheckerClient() const { return *m_spellCheckerClient; } |
| |
| void setMainFrame(Frame*); |
| Frame* mainFrame() const { return m_mainFrame; } |
| // Escape hatch for existing code that assumes that the root frame is |
| // always a LocalFrame. With OOPI, this is not always the case. Code that |
| // depends on this will generally have to be rewritten to propagate any |
| // necessary state through all renderer processes for that page and/or |
| // coordinate/rely on the browser process to help dispatch/coordinate work. |
| LocalFrame* deprecatedLocalMainFrame() const { return toLocalFrame(m_mainFrame); } |
| |
| void documentDetached(Document*); |
| |
| bool openedByDOM() const; |
| void setOpenedByDOM(); |
| |
| PageAnimator& animator() { return *m_animator; } |
| ChromeClient& chromeClient() const { return *m_chromeClient; } |
| AutoscrollController& autoscrollController() const { return *m_autoscrollController; } |
| DragCaretController& dragCaretController() const { return *m_dragCaretController; } |
| DragController& dragController() const { return *m_dragController; } |
| FocusController& focusController() const { return *m_focusController; } |
| ContextMenuController& contextMenuController() const { return *m_contextMenuController; } |
| PointerLockController& pointerLockController() const { return *m_pointerLockController; } |
| ValidationMessageClient& validationMessageClient() const { return *m_validationMessageClient; } |
| void setValidationMessageClient(ValidationMessageClient*); |
| |
| ScrollingCoordinator* scrollingCoordinator(); |
| |
| String mainThreadScrollingReasonsAsText(); |
| ClientRectList* nonFastScrollableRects(const LocalFrame*); |
| |
| Settings& settings() const { return *m_settings; } |
| |
| UseCounter& useCounter() { return m_useCounter; } |
| Deprecation& deprecation() { return m_deprecation; } |
| HostsUsingFeatures& hostsUsingFeatures() { return m_hostsUsingFeatures; } |
| |
| void setTabKeyCyclesThroughElements(bool b) { m_tabKeyCyclesThroughElements = b; } |
| bool tabKeyCyclesThroughElements() const { return m_tabKeyCyclesThroughElements; } |
| |
| // DefersLoading is used to delay loads during modal dialogs. |
| // Modal dialogs are supposed to freeze all background processes |
| // in the page, including prevent additional loads from staring/continuing. |
| void setDefersLoading(bool); |
| bool defersLoading() const { return m_defersLoading; } |
| |
| void setPageScaleFactor(float); |
| float pageScaleFactor() const; |
| |
| float deviceScaleFactor() const { return m_deviceScaleFactor; } |
| void setDeviceScaleFactor(float); |
| |
| static void allVisitedStateChanged(bool invalidateVisitedLinkHashes); |
| static void visitedStateChanged(LinkHash visitedHash); |
| |
| void setVisibilityState(PageVisibilityState, bool); |
| PageVisibilityState visibilityState() const; |
| bool isPageVisible() const; |
| |
| bool isCursorVisible() const; |
| void setIsCursorVisible(bool isVisible) { m_isCursorVisible = isVisible; } |
| |
| #if ENABLE(ASSERT) |
| void setIsPainting(bool painting) { m_isPainting = painting; } |
| bool isPainting() const { return m_isPainting; } |
| #endif |
| |
| void didCommitLoad(LocalFrame*); |
| |
| void acceptLanguagesChanged(); |
| |
| static void networkStateChanged(bool online); |
| |
| DECLARE_TRACE(); |
| |
| void layerTreeViewInitialized(WebLayerTreeView&); |
| void willCloseLayerTreeView(WebLayerTreeView&); |
| |
| void willBeDestroyed(); |
| |
| private: |
| explicit Page(PageClients&); |
| |
| void initGroup(); |
| |
| // SettingsDelegate overrides. |
| void settingsChanged(SettingsDelegate::ChangeType) override; |
| |
| Member<PageAnimator> m_animator; |
| const Member<AutoscrollController> m_autoscrollController; |
| Member<ChromeClient> m_chromeClient; |
| const Member<DragCaretController> m_dragCaretController; |
| const Member<DragController> m_dragController; |
| const Member<FocusController> m_focusController; |
| const Member<ContextMenuController> m_contextMenuController; |
| const Member<PointerLockController> m_pointerLockController; |
| Member<ScrollingCoordinator> m_scrollingCoordinator; |
| |
| // Typically, the main frame and Page should both be owned by the embedder, |
| // which must call Page::willBeDestroyed() prior to destroying Page. This |
| // call detaches the main frame and clears this pointer, thus ensuring that |
| // this field only references a live main frame. |
| // |
| // However, there are several locations (InspectorOverlay, SVGImage, and |
| // WebPagePopupImpl) which don't hold a reference to the main frame at all |
| // after creating it. These are still safe because they always create a |
| // Frame with a FrameView. FrameView and Frame hold references to each |
| // other, thus keeping each other alive. The call to willBeDestroyed() |
| // breaks this cycle, so the frame is still properly destroyed once no |
| // longer needed. |
| Member<Frame> m_mainFrame; |
| |
| mutable RefPtr<PluginData> m_pluginData; |
| |
| EditorClient* const m_editorClient; |
| SpellCheckerClient* const m_spellCheckerClient; |
| Member<ValidationMessageClient> m_validationMessageClient; |
| |
| UseCounter m_useCounter; |
| Deprecation m_deprecation; |
| HostsUsingFeatures m_hostsUsingFeatures; |
| |
| bool m_openedByDOM; |
| |
| bool m_tabKeyCyclesThroughElements; |
| bool m_defersLoading; |
| |
| float m_deviceScaleFactor; |
| |
| PageVisibilityState m_visibilityState; |
| |
| bool m_isCursorVisible; |
| |
| #if ENABLE(ASSERT) |
| bool m_isPainting; |
| #endif |
| |
| // A pointer to all the interfaces provided to in-process Frames for this Page. |
| // FIXME: Most of the members of Page should move onto FrameHost. |
| Member<FrameHost> m_frameHost; |
| }; |
| |
| extern template class CORE_EXTERN_TEMPLATE_EXPORT Supplement<Page>; |
| |
| } // namespace blink |
| |
| #endif // Page_h |