74a2eda6f322c22da95ccf208426c7c95462b9b3
[WebKit-https.git] / Source / WebCore / layout / blockformatting / BlockFormattingContext.h
1 /*
2  * Copyright (C) 2018 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
14  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
17  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
23  * THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #pragma once
27
28 #if ENABLE(LAYOUT_FORMATTING_CONTEXT)
29
30 #include "FormattingContext.h"
31 #include <wtf/IsoMalloc.h>
32
33 namespace WebCore {
34
35 class LayoutUnit;
36
37 namespace Layout {
38
39 class BlockFormattingState;
40 class Box;
41 class FloatingContext;
42
43 // This class implements the layout logic for block formatting contexts.
44 // https://www.w3.org/TR/CSS22/visuren.html#block-formatting
45 class BlockFormattingContext : public FormattingContext {
46     WTF_MAKE_ISO_ALLOCATED(BlockFormattingContext);
47 public:
48     BlockFormattingContext(const Box& formattingContextRoot);
49
50     void layout(LayoutContext&, FormattingState&) const override;
51
52 private:
53     void layoutFormattingContextRoot(LayoutContext&, FloatingContext&, FormattingState&, const Box&) const;
54
55     void computeWidthAndMargin(LayoutContext&, const Box&) const;
56     void computeHeightAndMargin(const LayoutContext&, const Box&) const;
57
58     void computeStaticPosition(const LayoutContext&, const Box&) const override;
59     void computeFloatingPosition(const LayoutContext&, const FloatingContext&, const Box&) const;
60     void computePositionToAvoidFloats(const LayoutContext&, const FloatingContext&, const Box&) const;
61     void computeVerticalPositionForFloatClear(const LayoutContext&, const FloatingContext&, const Box&) const;
62
63     void computeInFlowPositionedPosition(const LayoutContext&, const Box&) const override;
64     void computeEstimatedMarginTop(const LayoutContext&, const Box&) const;
65     void computeEstimatedMarginTopForAncestors(const LayoutContext&, const Box&) const;
66
67     InstrinsicWidthConstraints instrinsicWidthConstraints(LayoutContext&, const Box&) const override;
68
69     // This class implements positioning and sizing for boxes participating in a block formatting context.
70     class Geometry : public FormattingContext::Geometry {
71     public:
72         static HeightAndMargin inFlowHeightAndMargin(const LayoutContext&, const Box&, std::optional<LayoutUnit> precomputedHeight = { });
73         static WidthAndMargin inFlowWidthAndMargin(const LayoutContext&, const Box&, std::optional<LayoutUnit> precomputedWidth = { });
74
75         static Position staticPosition(const LayoutContext&, const Box&);
76         static Position inFlowPositionedPosition(const LayoutContext&, const Box&);
77
78         static bool instrinsicWidthConstraintsNeedChildrenWidth(const Box&);
79         static InstrinsicWidthConstraints instrinsicWidthConstraints(const LayoutContext&, const Box&);
80
81         static LayoutUnit estimatedMarginTop(const LayoutContext&, const Box&);
82
83     private:
84         // This class implements margin collapsing for block formatting context.
85         class MarginCollapse {
86         public:
87             static LayoutUnit marginTop(const LayoutContext&, const Box&);
88             static LayoutUnit marginBottom(const LayoutContext&, const Box&);
89
90             static bool isMarginBottomCollapsedWithParent(const LayoutContext&, const Box&);
91             static bool isMarginTopCollapsedWithParentMarginBottom(const Box&);
92
93         private:
94             static LayoutUnit collapsedMarginBottomFromLastChild(const LayoutContext&, const Box&);
95             static LayoutUnit nonCollapsedMarginBottom(const LayoutContext&, const Box&);
96
97             static LayoutUnit computedNonCollapsedMarginTop(const LayoutContext&, const Box&);
98             static LayoutUnit computedNonCollapsedMarginBottom(const LayoutContext&, const Box&);
99
100             static LayoutUnit collapsedMarginTopFromFirstChild(const LayoutContext&, const Box&);
101             static LayoutUnit nonCollapsedMarginTop(const LayoutContext&, const Box&);
102         };
103
104         static HeightAndMargin inFlowNonReplacedHeightAndMargin(const LayoutContext&, const Box&, std::optional<LayoutUnit> precomputedHeight = { });
105         static WidthAndMargin inFlowNonReplacedWidthAndMargin(const LayoutContext&, const Box&, std::optional<LayoutUnit> precomputedWidth = { });
106         static WidthAndMargin inFlowReplacedWidthAndMargin(const LayoutContext&, const Box&, std::optional<LayoutUnit> precomputedWidth = { });
107         static Position staticPositionForOutOfFlowPositioned(const LayoutContext&, const Box&);
108     };
109 };
110
111 }
112 }
113 #endif