[LFC] When the formatting root is also a containing block for out-of-flow elements.
[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
42 // This class implements the layout logic for block formatting contexts.
43 // https://www.w3.org/TR/CSS22/visuren.html#block-formatting
44 class BlockFormattingContext : public FormattingContext {
45     WTF_MAKE_ISO_ALLOCATED(BlockFormattingContext);
46 public:
47     BlockFormattingContext(const Box& formattingContextRoot);
48
49     void layout(LayoutContext&, FormattingState&) const override;
50     std::unique_ptr<FormattingState> createFormattingState(Ref<FloatingState>&&) const override;
51     Ref<FloatingState> createOrFindFloatingState(LayoutContext&) const override;
52
53 private:
54     void layoutFormattingContextRoot(LayoutContext&, FormattingState&, const Box&, Display::Box&) const;
55
56     void computeWidthAndMargin(LayoutContext&, const Box&, Display::Box&) const;
57     void computeHeightAndMargin(LayoutContext&, const Box&, Display::Box&) const;
58
59     void computeStaticPosition(LayoutContext&, const Box&, Display::Box&) const override;
60     void computeInFlowPositionedPosition(LayoutContext&, const Box&, Display::Box&) const override;
61     void computeInFlowWidthAndMargin(LayoutContext&, const Box&, Display::Box&) const;
62     void computeInFlowHeightAndMargin(LayoutContext&, const Box&, Display::Box&) const;
63
64     // This class implements positioning and sizing for boxes participating in a block formatting context.
65     class Geometry {
66     public:
67         static FormattingContext::Geometry::HeightAndMargin inFlowHeightAndMargin(LayoutContext&, const Box&);
68         static FormattingContext::Geometry::WidthAndMargin inFlowWidthAndMargin(LayoutContext&, const Box&);
69
70         static FormattingContext::Geometry::Position staticPosition(LayoutContext&, const Box&);
71         static FormattingContext::Geometry::Position inFlowPositionedPosition(LayoutContext&, const Box&);
72
73     private:
74         static FormattingContext::Geometry::HeightAndMargin inFlowNonReplacedHeightAndMargin(LayoutContext&, const Box&);
75         static FormattingContext::Geometry::WidthAndMargin inFlowNonReplacedWidthAndMargin(LayoutContext&, const Box&, std::optional<LayoutUnit> precomputedWidth = std::nullopt);
76         static FormattingContext::Geometry::WidthAndMargin inFlowReplacedWidthAndMargin(LayoutContext&, const Box&);
77         static FormattingContext::Geometry::Position staticPositionForOutOfFlowPositioned(const LayoutContext&, const Box&);
78     };
79     
80     // This class implements margin collapsing for block formatting context.
81     class MarginCollapse {
82     public:
83         static LayoutUnit marginTop(const LayoutContext&, const Box&);
84         static LayoutUnit marginBottom(const LayoutContext&, const Box&);
85
86         static bool isMarginBottomCollapsedWithParent(const LayoutContext&, const Box&);
87         static bool isMarginTopCollapsedWithParentMarginBottom(const Box&);
88     
89     private:
90         static LayoutUnit collapsedMarginBottomFromLastChild(const LayoutContext&, const Box&);
91         static LayoutUnit nonCollapsedMarginBottom(const LayoutContext&, const Box&);
92
93         static LayoutUnit computedNonCollapsedMarginTop(const LayoutContext&, const Box&);
94         static LayoutUnit computedNonCollapsedMarginBottom(const LayoutContext&, const Box&);
95
96         static LayoutUnit collapsedMarginTopFromFirstChild(const LayoutContext&, const Box&);
97         static LayoutUnit nonCollapsedMarginTop(const LayoutContext&, const Box&);
98     };
99 };
100
101 }
102 }
103 #endif