ca6b403865c22ade096d24c44367f088436bb045
[WebKit-https.git] / Source / WebCore / page / FrameView.h
1 /*
2    Copyright (C) 1997 Martin Jones (mjones@kde.org)
3              (C) 1998 Waldo Bastian (bastian@kde.org)
4              (C) 1998, 1999 Torben Weis (weis@kde.org)
5              (C) 1999 Lars Knoll (knoll@kde.org)
6              (C) 1999 Antti Koivisto (koivisto@kde.org)
7    Copyright (C) 2004-2017 Apple Inc. All rights reserved.
8
9    This library is free software; you can redistribute it and/or
10    modify it under the terms of the GNU Library General Public
11    License as published by the Free Software Foundation; either
12    version 2 of the License, or (at your option) any later version.
13
14    This library is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17    Library General Public License for more details.
18
19    You should have received a copy of the GNU Library General Public License
20    along with this library; see the file COPYING.LIB.  If not, write to
21    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22    Boston, MA 02110-1301, USA.
23 */
24
25 #pragma once
26
27 #include "AdjustViewSizeOrNot.h"
28 #include "Color.h"
29 #include "ContainerNode.h"
30 #include "LayoutMilestones.h"
31 #include "LayoutRect.h"
32 #include "Pagination.h"
33 #include "PaintPhase.h"
34 #include "RenderPtr.h"
35 #include "ScrollView.h"
36 #include "TiledBacking.h"
37 #include <memory>
38 #include <wtf/Forward.h>
39 #include <wtf/Function.h>
40 #include <wtf/HashSet.h>
41 #include <wtf/ListHashSet.h>
42 #include <wtf/text/WTFString.h>
43
44 namespace WebCore {
45
46 class AXObjectCache;
47 class Element;
48 class FloatSize;
49 class Frame;
50 class HTMLFrameOwnerElement;
51 class URL;
52 class Node;
53 class Page;
54 class RenderBox;
55 class RenderElement;
56 class RenderEmbeddedObject;
57 class RenderLayer;
58 class RenderObject;
59 class RenderScrollbarPart;
60 class RenderStyle;
61 class RenderView;
62 class RenderWidget;
63
64 Pagination::Mode paginationModeForRenderStyle(const RenderStyle&);
65
66 typedef unsigned long long DOMTimeStamp;
67
68 class FrameView final : public ScrollView {
69 public:
70     friend class RenderView;
71     friend class Internals;
72
73     WEBCORE_EXPORT static Ref<FrameView> create(Frame&);
74     static Ref<FrameView> create(Frame&, const IntSize& initialSize);
75
76     virtual ~FrameView();
77
78     HostWindow* hostWindow() const final;
79     
80     WEBCORE_EXPORT void invalidateRect(const IntRect&) final;
81     void setFrameRect(const IntRect&) final;
82
83     bool scheduleAnimation() final;
84
85     Frame& frame() const { return m_frame; }
86
87     WEBCORE_EXPORT RenderView* renderView() const;
88
89     int mapFromLayoutToCSSUnits(LayoutUnit) const;
90     LayoutUnit mapFromCSSToLayoutUnits(int) const;
91
92     LayoutUnit marginWidth() const { return m_margins.width(); } // -1 means default
93     LayoutUnit marginHeight() const { return m_margins.height(); } // -1 means default
94     void setMarginWidth(LayoutUnit);
95     void setMarginHeight(LayoutUnit);
96
97     WEBCORE_EXPORT void setCanHaveScrollbars(bool) final;
98     WEBCORE_EXPORT void updateCanHaveScrollbars();
99
100     Ref<Scrollbar> createScrollbar(ScrollbarOrientation) final;
101
102     bool avoidScrollbarCreation() const final;
103
104     void setContentsSize(const IntSize&) final;
105     void updateContentsSize() final;
106
107     void layout(bool allowSubtree = true);
108     WEBCORE_EXPORT bool didFirstLayout() const;
109     void layoutTimerFired();
110     void scheduleRelayout();
111     void scheduleRelayoutOfSubtree(RenderElement&);
112     void unscheduleRelayout();
113     void queuePostLayoutCallback(WTF::Function<void ()>&&);
114     bool layoutPending() const;
115     bool isInLayout() const { return m_layoutPhase != OutsideLayout; }
116     bool isInRenderTreeLayout() const { return m_layoutPhase == InRenderTreeLayout; }
117     WEBCORE_EXPORT bool inPaintableState() { return m_layoutPhase != InRenderTreeLayout && m_layoutPhase != InViewSizeAdjust && m_layoutPhase != InPostLayout; }
118
119     RenderElement* layoutRoot() const { return m_layoutRoot; }
120     void clearLayoutRoot() { m_layoutRoot = nullptr; }
121     int layoutCount() const { return m_layoutCount; }
122
123     WEBCORE_EXPORT bool needsLayout() const;
124     WEBCORE_EXPORT void setNeedsLayout();
125     void setViewportConstrainedObjectsNeedLayout();
126
127     bool needsStyleRecalcOrLayout(bool includeSubframes = true) const;
128
129     bool needsFullRepaint() const { return m_needsFullRepaint; }
130
131     WEBCORE_EXPORT bool renderedCharactersExceed(unsigned threshold);
132
133 #if PLATFORM(IOS)
134     bool useCustomFixedPositionLayoutRect() const;
135     IntRect customFixedPositionLayoutRect() const { return m_customFixedPositionLayoutRect; }
136     WEBCORE_EXPORT void setCustomFixedPositionLayoutRect(const IntRect&);
137     bool updateFixedPositionLayoutRect();
138
139     IntSize customSizeForResizeEvent() const { return m_customSizeForResizeEvent; }
140     WEBCORE_EXPORT void setCustomSizeForResizeEvent(IntSize);
141
142     WEBCORE_EXPORT void setScrollVelocity(double horizontalVelocity, double verticalVelocity, double scaleChangeRate, MonotonicTime timestamp);
143 #else
144     bool useCustomFixedPositionLayoutRect() const { return false; }
145 #endif
146
147     WEBCORE_EXPORT void serviceScriptedAnimations();
148
149     void willRecalcStyle();
150     bool updateCompositingLayersAfterStyleChange();
151     void updateCompositingLayersAfterLayout();
152
153     void clearBackingStores();
154
155     // Called when changes to the GraphicsLayer hierarchy have to be synchronized with
156     // content rendered via the normal painting path.
157     void setNeedsOneShotDrawingSynchronization();
158
159     WEBCORE_EXPORT GraphicsLayer* graphicsLayerForPlatformWidget(PlatformWidget);
160     WEBCORE_EXPORT void scheduleLayerFlushAllowingThrottling();
161
162     WEBCORE_EXPORT TiledBacking* tiledBacking() const final;
163
164     // In the future when any ScrollableArea can have a node in th ScrollingTree, this should
165     // become a virtual function on ScrollableArea.
166     uint64_t scrollLayerID() const;
167     ScrollableArea* scrollableAreaForScrollLayerID(uint64_t) const;
168
169     bool hasCompositedContent() const;
170     WEBCORE_EXPORT void enterCompositingMode();
171     WEBCORE_EXPORT bool isEnclosedInCompositingLayer() const;
172
173     // Only used with accelerated compositing, but outside the #ifdef to make linkage easier.
174     // Returns true if the flush was completed.
175     WEBCORE_EXPORT bool flushCompositingStateIncludingSubframes();
176
177     // Returns true when a paint with the PaintBehaviorFlattenCompositingLayers flag set gives
178     // a faithful representation of the content.
179     WEBCORE_EXPORT bool isSoftwareRenderable() const;
180
181     void setIsInWindow(bool);
182
183     void resetScrollbars();
184     void resetScrollbarsAndClearContentsSize();
185     void prepareForDetach();
186     void detachCustomScrollbars();
187     WEBCORE_EXPORT void recalculateScrollbarOverlayStyle();
188
189     void clear();
190
191     WEBCORE_EXPORT bool isTransparent() const;
192     WEBCORE_EXPORT void setTransparent(bool isTransparent);
193     
194     // True if the FrameView is not transparent, and the base background color is opaque.
195     bool hasOpaqueBackground() const;
196
197     WEBCORE_EXPORT Color baseBackgroundColor() const;
198     WEBCORE_EXPORT void setBaseBackgroundColor(const Color&);
199     void updateBackgroundRecursively(const Color&, bool);
200
201     enum ExtendedBackgroundModeFlags {
202         ExtendedBackgroundModeNone          = 0,
203         ExtendedBackgroundModeVertical      = 1 << 0,
204         ExtendedBackgroundModeHorizontal    = 1 << 1,
205         ExtendedBackgroundModeAll           = ExtendedBackgroundModeVertical | ExtendedBackgroundModeHorizontal,
206     };
207     typedef unsigned ExtendedBackgroundMode;
208
209     void updateExtendBackgroundIfNecessary();
210     void updateTilesForExtendedBackgroundMode(ExtendedBackgroundMode);
211     ExtendedBackgroundMode calculateExtendedBackgroundMode() const;
212
213     bool hasExtendedBackgroundRectForPainting() const;
214     IntRect extendedBackgroundRectForPainting() const;
215
216     bool shouldUpdateWhileOffscreen() const;
217     WEBCORE_EXPORT void setShouldUpdateWhileOffscreen(bool);
218     bool shouldUpdate() const;
219
220     WEBCORE_EXPORT void adjustViewSize();
221     
222     WEBCORE_EXPORT void setViewportSizeForCSSViewportUnits(IntSize);
223     IntSize viewportSizeForCSSViewportUnits() const;
224     
225     IntRect windowClipRect() const final;
226     WEBCORE_EXPORT IntRect windowClipRectForFrameOwner(const HTMLFrameOwnerElement*, bool clipToLayerContents) const;
227
228     float visibleContentScaleFactor() const final;
229
230 #if USE(COORDINATED_GRAPHICS)
231     void setFixedVisibleContentRect(const IntRect&) final;
232 #endif
233     WEBCORE_EXPORT void setScrollPosition(const ScrollPosition&) final;
234     void updateLayerPositionsAfterScrolling() final;
235     void updateCompositingLayersAfterScrolling() final;
236     bool requestScrollPositionUpdate(const ScrollPosition&) final;
237     bool isRubberBandInProgress() const final;
238     WEBCORE_EXPORT ScrollPosition minimumScrollPosition() const final;
239     WEBCORE_EXPORT ScrollPosition maximumScrollPosition() const final;
240
241     // The scrollOrigin, scrollPosition, minimumScrollPosition and maximumScrollPosition are all affected by frame scale,
242     // but layoutViewport computations require unscaled scroll positions.
243     ScrollPosition unscaledMinimumScrollPosition() const;
244     ScrollPosition unscaledMaximumScrollPosition() const;
245
246     IntPoint unscaledScrollOrigin() const;
247
248     WEBCORE_EXPORT LayoutPoint minStableLayoutViewportOrigin() const;
249     WEBCORE_EXPORT LayoutPoint maxStableLayoutViewportOrigin() const;
250
251     enum class TriggerLayoutOrNot {
252         No,
253         Yes
254     };
255     // This origin can be overridden by setLayoutViewportOverrideRect.
256     void setBaseLayoutViewportOrigin(LayoutPoint, TriggerLayoutOrNot = TriggerLayoutOrNot::Yes);
257     // This size can be overridden by setLayoutViewportOverrideRect.
258     WEBCORE_EXPORT LayoutSize baseLayoutViewportSize() const;
259     
260     // If set, overrides the default "m_layoutViewportOrigin, size of initial containing block" rect.
261     // Used with delegated scrolling (i.e. iOS).
262     WEBCORE_EXPORT void setLayoutViewportOverrideRect(std::optional<LayoutRect>);
263
264     // These are in document coordinates, unaffected by zooming.
265     WEBCORE_EXPORT LayoutRect layoutViewportRect() const;
266     WEBCORE_EXPORT LayoutRect visualViewportRect() const;
267     
268     static LayoutRect visibleDocumentRect(const FloatRect& visibleContentRect, float headerHeight, float footerHeight, const FloatSize& totalContentsSize, float pageScaleFactor);
269
270     // This is different than visibleContentRect() in that it ignores negative (or overly positive)
271     // offsets from rubber-banding, and it takes zooming into account. 
272     LayoutRect viewportConstrainedVisibleContentRect() const;
273     
274     LayoutRect rectForFixedPositionLayout() const;
275
276     void viewportContentsChanged();
277     WEBCORE_EXPORT void resumeVisibleImageAnimationsIncludingSubframes();
278
279     String mediaType() const;
280     WEBCORE_EXPORT void setMediaType(const String&);
281     void adjustMediaTypeForPrinting(bool printing);
282
283     void setCannotBlitToWindow();
284     void setIsOverlapped(bool);
285     void setContentIsOpaque(bool);
286
287     void addSlowRepaintObject(RenderElement*);
288     void removeSlowRepaintObject(RenderElement*);
289     bool hasSlowRepaintObject(const RenderElement& renderer) const { return m_slowRepaintObjects && m_slowRepaintObjects->contains(&renderer); }
290     bool hasSlowRepaintObjects() const { return m_slowRepaintObjects && m_slowRepaintObjects->size(); }
291
292     // Includes fixed- and sticky-position objects.
293     typedef HashSet<RenderElement*> ViewportConstrainedObjectSet;
294     void addViewportConstrainedObject(RenderElement*);
295     void removeViewportConstrainedObject(RenderElement*);
296     const ViewportConstrainedObjectSet* viewportConstrainedObjects() const { return m_viewportConstrainedObjects.get(); }
297     bool hasViewportConstrainedObjects() const { return m_viewportConstrainedObjects && m_viewportConstrainedObjects->size() > 0; }
298     
299     float frameScaleFactor() const;
300
301     // Functions for querying the current scrolled position, negating the effects of overhang
302     // and adjusting for page scale.
303     LayoutPoint scrollPositionForFixedPosition() const;
304     
305     // Static function can be called from another thread.
306     static LayoutPoint scrollPositionForFixedPosition(const LayoutRect& visibleContentRect, const LayoutSize& totalContentsSize, const LayoutPoint& scrollPosition, const LayoutPoint& scrollOrigin, float frameScaleFactor, bool fixedElementsLayoutRelativeToFrame, ScrollBehaviorForFixedElements, int headerHeight, int footerHeight);
307
308     enum class LayoutViewportConstraint { ConstrainedToDocumentRect, Unconstrained };
309     WEBCORE_EXPORT static LayoutRect computeUpdatedLayoutViewportRect(const LayoutRect& layoutViewport, const LayoutRect& documentRect, const LayoutSize& unobscuredContentSize, const LayoutRect& unobscuredContentRect, const LayoutSize& baseLayoutViewportSize, const LayoutPoint& stableLayoutViewportOriginMin, const LayoutPoint& stableLayoutViewportOriginMax, LayoutViewportConstraint);
310     
311     WEBCORE_EXPORT static LayoutPoint computeLayoutViewportOrigin(const LayoutRect& visualViewport, const LayoutPoint& stableLayoutViewportOriginMin, const LayoutPoint& stableLayoutViewportOriginMax, const LayoutRect& layoutViewport, ScrollBehaviorForFixedElements);
312
313     // These layers are positioned differently when there is a topContentInset, a header, or a footer. These value need to be computed
314     // on both the main thread and the scrolling thread.
315     static float yPositionForInsetClipLayer(const FloatPoint& scrollPosition, float topContentInset);
316     WEBCORE_EXPORT static FloatPoint positionForRootContentLayer(const FloatPoint& scrollPosition, const FloatPoint& scrollOrigin, float topContentInset, float headerHeight);
317     WEBCORE_EXPORT FloatPoint positionForRootContentLayer() const;
318
319     static float yPositionForHeaderLayer(const FloatPoint& scrollPosition, float topContentInset);
320     static float yPositionForFooterLayer(const FloatPoint& scrollPosition, float topContentInset, float totalContentsHeight, float footerHeight);
321
322 #if PLATFORM(IOS)
323     WEBCORE_EXPORT LayoutRect viewportConstrainedObjectsRect() const;
324     // Static function can be called from another thread.
325     WEBCORE_EXPORT static LayoutRect rectForViewportConstrainedObjects(const LayoutRect& visibleContentRect, const LayoutSize& totalContentsSize, float frameScaleFactor, bool fixedElementsLayoutRelativeToFrame, ScrollBehaviorForFixedElements);
326 #endif
327     
328     bool fixedElementsLayoutRelativeToFrame() const;
329
330     WEBCORE_EXPORT void disableLayerFlushThrottlingTemporarilyForInteraction();
331     bool speculativeTilingEnabled() const { return m_speculativeTilingEnabled; }
332     void loadProgressingStatusChanged();
333
334 #if ENABLE(DASHBOARD_SUPPORT)
335     void updateAnnotatedRegions();
336 #endif
337     WEBCORE_EXPORT void updateControlTints();
338
339     void restoreScrollbar();
340
341     WEBCORE_EXPORT bool wasScrolledByUser() const;
342     WEBCORE_EXPORT void setWasScrolledByUser(bool);
343
344     bool safeToPropagateScrollToParent() const { return m_safeToPropagateScrollToParent; }
345     void setSafeToPropagateScrollToParent(bool isSafe) { m_safeToPropagateScrollToParent = isSafe; }
346
347     void addEmbeddedObjectToUpdate(RenderEmbeddedObject&);
348     void removeEmbeddedObjectToUpdate(RenderEmbeddedObject&);
349
350     WEBCORE_EXPORT void paintContents(GraphicsContext&, const IntRect& dirtyRect, SecurityOriginPaintPolicy = SecurityOriginPaintPolicy::AnyOrigin) final;
351
352     struct PaintingState {
353         PaintBehavior paintBehavior;
354         bool isTopLevelPainter;
355         bool isFlatteningPaintOfRootFrame;
356         PaintingState()
357             : paintBehavior()
358             , isTopLevelPainter(false)
359             , isFlatteningPaintOfRootFrame(false)
360         {
361         }
362     };
363
364     void willPaintContents(GraphicsContext&, const IntRect& dirtyRect, PaintingState&);
365     void didPaintContents(GraphicsContext&, const IntRect& dirtyRect, PaintingState&);
366
367 #if PLATFORM(IOS)
368     WEBCORE_EXPORT void didReplaceMultipartContent();
369 #endif
370
371     WEBCORE_EXPORT void setPaintBehavior(PaintBehavior);
372     WEBCORE_EXPORT PaintBehavior paintBehavior() const;
373     bool isPainting() const;
374     bool hasEverPainted() const { return m_lastPaintTime; }
375     void setLastPaintTime(double lastPaintTime) { m_lastPaintTime = lastPaintTime; }
376     WEBCORE_EXPORT void setNodeToDraw(Node*);
377
378     enum SelectionInSnapshot { IncludeSelection, ExcludeSelection };
379     enum CoordinateSpaceForSnapshot { DocumentCoordinates, ViewCoordinates };
380     WEBCORE_EXPORT void paintContentsForSnapshot(GraphicsContext&, const IntRect& imageRect, SelectionInSnapshot shouldPaintSelection, CoordinateSpaceForSnapshot);
381
382     void paintOverhangAreas(GraphicsContext&, const IntRect& horizontalOverhangArea, const IntRect& verticalOverhangArea, const IntRect& dirtyRect) final;
383     void paintScrollCorner(GraphicsContext&, const IntRect& cornerRect) final;
384     void paintScrollbar(GraphicsContext&, Scrollbar&, const IntRect&) final;
385
386     WEBCORE_EXPORT Color documentBackgroundColor() const;
387
388     bool isInChildFrameWithFrameFlattening() const;
389
390     void startDisallowingLayout() { ++m_layoutDisallowedCount; }
391     void endDisallowingLayout() { ASSERT(m_layoutDisallowedCount > 0); --m_layoutDisallowedCount; }
392     bool layoutDisallowed() const { return m_layoutDisallowedCount; }
393
394     static double currentPaintTimeStamp() { return sCurrentPaintTimeStamp; } // returns 0 if not painting
395     
396     WEBCORE_EXPORT void updateLayoutAndStyleIfNeededRecursive();
397
398     void incrementVisuallyNonEmptyCharacterCount(unsigned);
399     void incrementVisuallyNonEmptyPixelCount(const IntSize&);
400     void updateIsVisuallyNonEmpty();
401     bool isVisuallyNonEmpty() const { return m_isVisuallyNonEmpty; }
402     WEBCORE_EXPORT void enableAutoSizeMode(bool enable, const IntSize& minSize, const IntSize& maxSize);
403     WEBCORE_EXPORT void setAutoSizeFixedMinimumHeight(int);
404     IntSize autoSizingIntrinsicContentSize() const { return m_autoSizeContentSize; }
405
406     WEBCORE_EXPORT void forceLayout(bool allowSubtree = false);
407     WEBCORE_EXPORT void forceLayoutForPagination(const FloatSize& pageSize, const FloatSize& originalPageSize, float maximumShrinkFactor, AdjustViewSizeOrNot);
408
409     // FIXME: This method is retained because of embedded WebViews in AppKit.  When a WebView is embedded inside
410     // some enclosing view with auto-pagination, no call happens to resize the view.  The new pagination model
411     // needs the view to resize as a result of the breaks, but that means that the enclosing view has to potentially
412     // resize around that view.  Auto-pagination uses the bounds of the actual view that's being printed to determine
413     // the edges of the print operation, so the resize is necessary if the enclosing view's bounds depend on the
414     // web document's bounds.
415     // 
416     // This is already a problem if the view needs to be a different size because of printer fonts or because of print stylesheets.
417     // Mail/Dictionary work around this problem by using the _layoutForPrinting SPI
418     // to at least get print stylesheets and printer fonts into play, but since WebKit doesn't know about the page offset or
419     // page size, it can't actually paginate correctly during _layoutForPrinting.
420     //
421     // We can eventually move Mail to a newer SPI that would let them opt in to the layout-time pagination model,
422     // but that doesn't solve the general problem of how other AppKit views could opt in to the better model.
423     //
424     // NO OTHER PLATFORM BESIDES MAC SHOULD USE THIS METHOD.
425     WEBCORE_EXPORT void adjustPageHeightDeprecated(float* newBottom, float oldTop, float oldBottom, float bottomLimit);
426
427     bool scrollToFragment(const URL&);
428     bool scrollToAnchor(const String&);
429     void maintainScrollPositionAtAnchor(ContainerNode*);
430     WEBCORE_EXPORT void scrollElementToRect(const Element&, const IntRect&);
431
432     // Methods to convert points and rects between the coordinate space of the renderer, and this view.
433     WEBCORE_EXPORT IntRect convertFromRendererToContainingView(const RenderElement*, const IntRect&) const;
434     WEBCORE_EXPORT IntRect convertFromContainingViewToRenderer(const RenderElement*, const IntRect&) const;
435     WEBCORE_EXPORT IntPoint convertFromRendererToContainingView(const RenderElement*, const IntPoint&) const;
436     WEBCORE_EXPORT IntPoint convertFromContainingViewToRenderer(const RenderElement*, const IntPoint&) const;
437
438     // Override ScrollView methods to do point conversion via renderers, in order to take transforms into account.
439     IntRect convertToContainingView(const IntRect&) const final;
440     IntRect convertFromContainingView(const IntRect&) const final;
441     IntPoint convertToContainingView(const IntPoint&) const final;
442     IntPoint convertFromContainingView(const IntPoint&) const final;
443
444     bool isFrameViewScrollCorner(const RenderScrollbarPart& scrollCorner) const { return m_scrollCorner == &scrollCorner; }
445
446     // isScrollable() takes an optional Scrollability parameter that allows the caller to define what they mean by 'scrollable.'
447     // Most callers are interested in the default value, Scrollability::Scrollable, which means that there is actually content
448     // to scroll to, and a scrollbar that will allow you to access it. In some cases, callers want to know if the FrameView is allowed
449     // to rubber-band, which the main frame might be allowed to do even if there is no content to scroll to. In that case,
450     // callers use Scrollability::ScrollableOrRubberbandable.
451     enum class Scrollability { Scrollable, ScrollableOrRubberbandable };
452     WEBCORE_EXPORT bool isScrollable(Scrollability definitionOfScrollable = Scrollability::Scrollable);
453
454     bool isScrollableOrRubberbandable() final;
455     bool hasScrollableOrRubberbandableAncestor() final;
456
457     enum ScrollbarModesCalculationStrategy { RulesFromWebContentOnly, AnyRule };
458     void calculateScrollbarModesForLayout(ScrollbarMode& hMode, ScrollbarMode& vMode, ScrollbarModesCalculationStrategy = AnyRule);
459
460     IntPoint lastKnownMousePosition() const final;
461     bool isHandlingWheelEvent() const final;
462     bool shouldSetCursor() const;
463
464     // FIXME: Remove this method once plugin loading is decoupled from layout.
465     void flushAnyPendingPostLayoutTasks();
466
467     bool shouldSuspendScrollAnimations() const final;
468     void scrollbarStyleChanged(ScrollbarStyle, bool forceUpdate) override;
469
470     RenderBox* embeddedContentBox() const;
471     
472     WEBCORE_EXPORT void setTracksRepaints(bool);
473     bool isTrackingRepaints() const { return m_isTrackingRepaints; }
474     WEBCORE_EXPORT void resetTrackedRepaints();
475     const Vector<FloatRect>& trackedRepaintRects() const { return m_trackedRepaintRects; }
476     String trackedRepaintRectsAsText() const;
477
478     typedef HashSet<ScrollableArea*> ScrollableAreaSet;
479     // Returns whether the scrollable area has just been newly added.
480     WEBCORE_EXPORT bool addScrollableArea(ScrollableArea*);
481     // Returns whether the scrollable area has just been removed.
482     WEBCORE_EXPORT bool removeScrollableArea(ScrollableArea*);
483     bool containsScrollableArea(ScrollableArea*) const;
484     const ScrollableAreaSet* scrollableAreas() const { return m_scrollableAreas.get(); }
485
486     void removeChild(Widget&) final;
487
488     // This function exists for ports that need to handle wheel events manually.
489     // On Mac WebKit1 the underlying NSScrollView just does the scrolling, but on most other platforms
490     // we need this function in order to do the scroll ourselves.
491     bool wheelEvent(const PlatformWheelEvent&);
492
493     WEBCORE_EXPORT void setScrollingPerformanceLoggingEnabled(bool);
494
495     // Page and FrameView both store a Pagination value. Page::pagination() is set only by API,
496     // and FrameView::pagination() is set only by CSS. Page::pagination() will affect all
497     // FrameViews in the page cache, but FrameView::pagination() only affects the current
498     // FrameView. FrameView::pagination() will return m_pagination if it has been set. Otherwise,
499     // it will return Page::pagination() since currently there are no callers that need to
500     // distinguish between the two.
501     const Pagination& pagination() const;
502     void setPagination(const Pagination&);
503     
504     bool inProgrammaticScroll() const final { return m_inProgrammaticScroll; }
505     void setInProgrammaticScroll(bool programmaticScroll) { m_inProgrammaticScroll = programmaticScroll; }
506
507 #if ENABLE(CSS_DEVICE_ADAPTATION)
508     IntSize initialViewportSize() const { return m_initialViewportSize; }
509     void setInitialViewportSize(const IntSize& size) { m_initialViewportSize = size; }
510 #endif
511
512     bool isActive() const final;
513     bool forceUpdateScrollbarsOnMainThreadForPerformanceTesting() const final;
514
515 #if ENABLE(RUBBER_BANDING)
516     WEBCORE_EXPORT GraphicsLayer* setWantsLayerForTopOverHangArea(bool) const;
517     WEBCORE_EXPORT GraphicsLayer* setWantsLayerForBottomOverHangArea(bool) const;
518 #endif
519
520     // This function "smears" the "position:fixed" uninflatedBounds for scrolling, returning a rect that is the union of
521     // all possible locations of the given rect under page scrolling.
522     LayoutRect fixedScrollableAreaBoundsInflatedForScrolling(const LayoutRect& uninflatedBounds) const;
523
524     LayoutPoint scrollPositionRespectingCustomFixedPosition() const;
525
526     int headerHeight() const final { return m_headerHeight; }
527     WEBCORE_EXPORT void setHeaderHeight(int);
528     int footerHeight() const final { return m_footerHeight; }
529     WEBCORE_EXPORT void setFooterHeight(int);
530
531     WEBCORE_EXPORT float topContentInset(TopContentInsetType = TopContentInsetType::WebCoreContentInset) const final;
532     void topContentInsetDidChange(float newTopContentInset);
533
534     void topContentDirectionDidChange();
535
536     WEBCORE_EXPORT void willStartLiveResize() final;
537     WEBCORE_EXPORT void willEndLiveResize() final;
538
539     WEBCORE_EXPORT void availableContentSizeChanged(AvailableSizeChangeReason) final;
540
541     void updateTiledBackingAdaptiveSizing();
542     TiledBacking::Scrollability computeScrollability() const;
543
544     void addPaintPendingMilestones(LayoutMilestones);
545     void firePaintRelatedMilestonesIfNeeded();
546     void fireLayoutRelatedMilestonesIfNeeded();
547     LayoutMilestones milestonesPendingPaint() const { return m_milestonesPendingPaint; }
548
549     bool visualUpdatesAllowedByClient() const { return m_visualUpdatesAllowedByClient; }
550     WEBCORE_EXPORT void setVisualUpdatesAllowedByClient(bool);
551
552     WEBCORE_EXPORT void setScrollPinningBehavior(ScrollPinningBehavior);
553
554     ScrollBehaviorForFixedElements scrollBehaviorForFixedElements() const;
555
556     bool hasFlippedBlockRenderers() const { return m_hasFlippedBlockRenderers; }
557     void setHasFlippedBlockRenderers(bool b) { m_hasFlippedBlockRenderers = b; }
558
559     void updateWidgetPositions();
560     void didAddWidgetToRenderTree(Widget&);
561     void willRemoveWidgetFromRenderTree(Widget&);
562
563     const HashSet<Widget*>& widgetsInRenderTree() const { return m_widgetsInRenderTree; }
564
565     typedef Vector<Ref<FrameView>, 16> FrameViewList;
566     FrameViewList renderedChildFrameViews() const;
567
568     void addTrackedRepaintRect(const FloatRect&);
569
570     // exposedRect represents WebKit's understanding of what part
571     // of the view is actually exposed on screen (taking into account
572     // clipping by other UI elements), whereas visibleContentRect is
573     // internal to WebCore and doesn't respect those things.
574     WEBCORE_EXPORT void setViewExposedRect(std::optional<FloatRect>);
575     std::optional<FloatRect> viewExposedRect() const { return m_viewExposedRect; }
576
577 #if ENABLE(CSS_SCROLL_SNAP)
578     void updateSnapOffsets() final;
579     bool isScrollSnapInProgress() const final;
580     void updateScrollingCoordinatorScrollSnapProperties() const;
581 #endif
582
583     float adjustScrollStepForFixedContent(float step, ScrollbarOrientation, ScrollGranularity) final;
584
585     void didChangeScrollOffset();
586
587     void show() final;
588     void hide() final;
589
590     bool shouldPlaceBlockDirectionScrollbarOnLeft() const final;
591
592     void didRestoreFromPageCache();
593
594     void willDestroyRenderTree();
595     void didDestroyRenderTree();
596
597     void setSpeculativeTilingDelayDisabledForTesting(bool disabled) { m_speculativeTilingDelayDisabledForTesting = disabled; }
598
599 protected:
600     bool scrollContentsFastPath(const IntSize& scrollDelta, const IntRect& rectToScroll, const IntRect& clipRect) final;
601     void scrollContentsSlowPath(const IntRect& updateRect) final;
602     
603     void repaintSlowRepaintObjects();
604
605     bool isVerticalDocument() const final;
606     bool isFlippedDocument() const final;
607
608 private:
609     explicit FrameView(Frame&);
610
611     void reset();
612     void init();
613
614     enum LayoutPhase {
615         OutsideLayout,
616         InPreLayout,
617         InPreLayoutStyleUpdate,
618         InRenderTreeLayout,
619         InViewSizeAdjust,
620         InPostLayout,
621         InPostLayerPositionsUpdatedAfterLayout,
622     };
623     LayoutPhase layoutPhase() const { return m_layoutPhase; }
624
625     bool inPreLayoutStyleUpdate() const { return m_layoutPhase == InPreLayoutStyleUpdate; }
626
627     bool isFrameView() const final { return true; }
628
629     friend class RenderWidget;
630     bool useSlowRepaints(bool considerOverlap = true) const;
631     bool useSlowRepaintsIfNotOverlapped() const;
632     void updateCanBlitOnScrollRecursively();
633     bool shouldLayoutAfterContentsResized() const;
634
635     bool shouldUpdateCompositingLayersAfterScrolling() const;
636     bool flushCompositingStateForThisFrame(const Frame& rootFrameForFlush);
637
638     bool shouldDeferScrollUpdateAfterContentSizeChange() final;
639
640     void scrollOffsetChangedViaPlatformWidgetImpl(const ScrollOffset& oldOffset, const ScrollOffset& newOffset) final;
641
642     void applyOverflowToViewport(const RenderElement&, ScrollbarMode& hMode, ScrollbarMode& vMode);
643     void applyPaginationToViewport();
644
645     void updateOverflowStatus(bool horizontalOverflow, bool verticalOverflow);
646
647     WEBCORE_EXPORT void paintControlTints();
648
649     void forceLayoutParentViewIfNeeded();
650     void flushPostLayoutTasksQueue();
651     void performPostLayoutTasks();
652     void autoSizeIfEnabled();
653
654     void applyRecursivelyWithVisibleRect(const std::function<void (FrameView& frameView, const IntRect& visibleRect)>&);
655     void resumeVisibleImageAnimations(const IntRect& visibleRect);
656     void updateScriptedAnimationsAndTimersThrottlingState(const IntRect& visibleRect);
657
658     void updateLayerFlushThrottling();
659     WEBCORE_EXPORT void adjustTiledBackingCoverage();
660
661     void repaintContentRectangle(const IntRect&) final;
662     void addedOrRemovedScrollbar() final;
663
664     void delegatesScrollingDidChange() final;
665
666     // ScrollableArea interface
667     void invalidateScrollbarRect(Scrollbar&, const IntRect&) final;
668     void scrollTo(const ScrollPosition&) final;
669     void setVisibleScrollerThumbRect(const IntRect&) final;
670     ScrollableArea* enclosingScrollableArea() const final;
671     IntRect scrollableAreaBoundingBox(bool* = nullptr) const final;
672     bool scrollAnimatorEnabled() const final;
673     GraphicsLayer* layerForScrolling() const final;
674     GraphicsLayer* layerForHorizontalScrollbar() const final;
675     GraphicsLayer* layerForVerticalScrollbar() const final;
676     GraphicsLayer* layerForScrollCorner() const final;
677 #if ENABLE(RUBBER_BANDING)
678     GraphicsLayer* layerForOverhangAreas() const final;
679 #endif
680     void contentsResized() final;
681
682 #if PLATFORM(IOS)
683     void unobscuredContentSizeChanged() final;
684 #endif
685
686     bool usesCompositedScrolling() const final;
687     bool usesAsyncScrolling() const final;
688     bool usesMockScrollAnimator() const final;
689     void logMockScrollAnimatorMessage(const String&) const final;
690
691     // Override scrollbar notifications to update the AXObject cache.
692     void didAddScrollbar(Scrollbar*, ScrollbarOrientation) final;
693     void willRemoveScrollbar(Scrollbar*, ScrollbarOrientation) final;
694
695     IntSize sizeForResizeEvent() const;
696     void sendResizeEventIfNeeded();
697
698     void handleDeferredScrollbarsUpdateAfterDirectionChange();
699
700     void updateScrollableAreaSet();
701     void updateLayoutViewport();
702
703     void notifyPageThatContentAreaWillPaint() const final;
704
705     void enableSpeculativeTilingIfNeeded();
706     void speculativeTilingEnableTimerFired();
707
708     void updateEmbeddedObjectsTimerFired();
709     bool updateEmbeddedObjects();
710     void updateEmbeddedObject(RenderEmbeddedObject&);
711     void scrollToAnchor();
712     void scrollPositionChanged(const ScrollPosition& oldPosition, const ScrollPosition& newPosition);
713     void scrollableAreaSetChanged();
714     void sendScrollEvent();
715
716     bool hasCustomScrollbars() const;
717
718     void updateScrollCorner() final;
719
720     FrameView* parentFrameView() const;
721
722     void startLayoutAtMainFrameViewIfNeeded(bool allowSubtree);
723     bool frameFlatteningEnabled() const;
724     bool isFrameFlatteningValidForThisFrame() const;
725
726     bool qualifiesAsVisuallyNonEmpty() const;
727     bool isViewForDocumentInFrame() const;
728
729     AXObjectCache* axObjectCache() const;
730     void notifyWidgetsInAllFrames(WidgetNotification);
731     void removeFromAXObjectCache();
732     void notifyWidgets(WidgetNotification);
733
734     void convertSubtreeLayoutToFullLayout();
735
736     RenderElement* viewportRenderer() const;
737
738     HashSet<Widget*> m_widgetsInRenderTree;
739
740     static double sCurrentPaintTimeStamp; // used for detecting decoded resource thrash in the cache
741
742     LayoutSize m_size;
743     LayoutSize m_margins;
744
745     std::unique_ptr<ListHashSet<RenderEmbeddedObject*>> m_embeddedObjectsToUpdate;
746     const Ref<Frame> m_frame;
747
748     std::unique_ptr<HashSet<const RenderElement*>> m_slowRepaintObjects;
749
750     bool m_needsFullRepaint;
751     
752     bool m_canHaveScrollbars;
753     bool m_cannotBlitToWindow;
754     bool m_isOverlapped { false };
755     bool m_contentIsOpaque;
756
757     Timer m_layoutTimer;
758     bool m_delayedLayout;
759     RenderElement* m_layoutRoot { nullptr };
760
761     LayoutPhase m_layoutPhase;
762     bool m_layoutSchedulingEnabled;
763     bool m_inSynchronousPostLayout;
764     int m_layoutCount;
765     unsigned m_nestedLayoutCount;
766     Timer m_postLayoutTasksTimer;
767     Timer m_updateEmbeddedObjectsTimer;
768     bool m_firstLayoutCallbackPending;
769
770     bool m_firstLayout;
771     bool m_isTransparent;
772     Color m_baseBackgroundColor;
773     IntSize m_lastViewportSize;
774     float m_lastZoomFactor;
775
776     String m_mediaType;
777     String m_mediaTypeWhenNotPrinting;
778
779     bool m_overflowStatusDirty;
780     bool m_horizontalOverflow;
781     bool m_verticalOverflow;
782     enum class ViewportRendererType { None, Document, Body };
783     ViewportRendererType m_viewportRendererType { ViewportRendererType::None };
784
785     Pagination m_pagination;
786
787     bool m_wasScrolledByUser;
788     bool m_inProgrammaticScroll;
789     bool m_safeToPropagateScrollToParent;
790     Timer m_delayedScrollEventTimer;
791
792     double m_lastPaintTime;
793
794     bool m_isTrackingRepaints; // Used for testing.
795     Vector<FloatRect> m_trackedRepaintRects;
796
797     bool m_shouldUpdateWhileOffscreen;
798
799     std::optional<FloatRect> m_viewExposedRect;
800     
801     LayoutPoint m_layoutViewportOrigin;
802     std::optional<LayoutRect> m_layoutViewportOverrideRect;
803
804     unsigned m_deferSetNeedsLayoutCount;
805     bool m_setNeedsLayoutWasDeferred;
806     int m_layoutDisallowedCount { 0 };
807
808     RefPtr<Node> m_nodeToDraw;
809     PaintBehavior m_paintBehavior;
810     bool m_isPainting;
811
812     unsigned m_visuallyNonEmptyCharacterCount;
813     unsigned m_visuallyNonEmptyPixelCount;
814     bool m_isVisuallyNonEmpty;
815     bool m_firstVisuallyNonEmptyLayoutCallbackPending;
816
817     bool m_needsDeferredScrollbarsUpdate { false };
818
819     RefPtr<ContainerNode> m_maintainScrollPositionAnchor;
820
821     // Renderer to hold our custom scroll corner.
822     RenderPtr<RenderScrollbarPart> m_scrollCorner;
823
824     bool m_speculativeTilingEnabled;
825     Timer m_speculativeTilingEnableTimer;
826
827 #if PLATFORM(IOS)
828     bool m_useCustomFixedPositionLayoutRect;
829     IntRect m_customFixedPositionLayoutRect;
830
831     bool m_useCustomSizeForResizeEvent;
832     IntSize m_customSizeForResizeEvent;
833 #endif
834
835     IntSize m_overrideViewportSize;
836     bool m_hasOverrideViewportSize;
837
838     // If true, automatically resize the frame view around its content.
839     bool m_shouldAutoSize;
840     bool m_inAutoSize;
841     // True if autosize has been run since m_shouldAutoSize was set.
842     bool m_didRunAutosize;
843     // The lower bound on the size when autosizing.
844     IntSize m_minAutoSize;
845     // The upper bound on the size when autosizing.
846     IntSize m_maxAutoSize;
847     // The fixed height to resize the view to after autosizing is complete.
848     int m_autoSizeFixedMinimumHeight;
849     // The intrinsic content size decided by autosizing.
850     IntSize m_autoSizeContentSize;
851
852     std::unique_ptr<ScrollableAreaSet> m_scrollableAreas;
853     std::unique_ptr<ViewportConstrainedObjectSet> m_viewportConstrainedObjects;
854
855     int m_headerHeight;
856     int m_footerHeight;
857
858     LayoutMilestones m_milestonesPendingPaint;
859
860     static const unsigned visualCharacterThreshold = 200;
861     static const unsigned visualPixelThreshold = 32 * 32;
862
863 #if ENABLE(CSS_DEVICE_ADAPTATION)
864     // Size of viewport before any UA or author styles have overridden
865     // the viewport given by the window or viewing area of the UA.
866     IntSize m_initialViewportSize;
867 #endif
868
869     bool m_visualUpdatesAllowedByClient;
870     bool m_hasFlippedBlockRenderers;
871     bool m_speculativeTilingDelayDisabledForTesting { false };
872
873     ScrollPinningBehavior m_scrollPinningBehavior;
874
875     IntRect* m_cachedWindowClipRect { nullptr };
876     Vector<WTF::Function<void ()>> m_postLayoutCallbackQueue;
877 };
878
879 inline void FrameView::incrementVisuallyNonEmptyCharacterCount(unsigned count)
880 {
881     if (m_isVisuallyNonEmpty)
882         return;
883     m_visuallyNonEmptyCharacterCount += count;
884     if (m_visuallyNonEmptyCharacterCount <= visualCharacterThreshold)
885         return;
886     updateIsVisuallyNonEmpty();
887 }
888
889 inline void FrameView::incrementVisuallyNonEmptyPixelCount(const IntSize& size)
890 {
891     if (m_isVisuallyNonEmpty)
892         return;
893     m_visuallyNonEmptyPixelCount += size.width() * size.height();
894     if (m_visuallyNonEmptyPixelCount <= visualPixelThreshold)
895         return;
896     updateIsVisuallyNonEmpty();
897 }
898
899 } // namespace WebCore
900
901 SPECIALIZE_TYPE_TRAITS_WIDGET(FrameView, isFrameView())