third_party/blink/renderer/core/layout/ng/ng_layout_result.h

// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef NGLayoutResult_h
#define NGLayoutResult_h

#include "base/memory/scoped_refptr.h"
#include "third_party/blink/renderer/core/core_export.h"
#include "third_party/blink/renderer/core/layout/ng/geometry/ng_bfc_offset.h"
#include "third_party/blink/renderer/core/layout/ng/geometry/ng_margin_strut.h"
#include "third_party/blink/renderer/core/layout/ng/list/ng_unpositioned_list_marker.h"
#include "third_party/blink/renderer/core/layout/ng/ng_floats_utils.h"
#include "third_party/blink/renderer/core/layout/ng/ng_out_of_flow_positioned_descendant.h"
#include "third_party/blink/renderer/core/layout/ng/ng_physical_fragment.h"
#include "third_party/blink/renderer/core/style/computed_style_constants.h"
#include "third_party/blink/renderer/platform/wtf/vector.h"

namespace blink {

class NGExclusionSpace;
struct NGPositionedFloat;

// The NGLayoutResult stores the resulting data from layout. This includes
// geometry information in form of a NGPhysicalFragment, which is kept around
// for painting, hit testing, etc., as well as additional data which is only
// necessary during layout and stored on this object.
// Layout code should access the NGPhysicalFragment through the wrappers in
// NGFragment et al.
class CORE_EXPORT NGLayoutResult : public RefCounted<NGLayoutResult> {
 public:
  enum NGLayoutResultStatus {
    kSuccess = 0,
    kBfcBlockOffsetResolved = 1,
    // When adding new values, make sure the bit size of |status_| is large
    // enough to store.
  };

  ~NGLayoutResult();

  scoped_refptr<NGPhysicalFragment> PhysicalFragment() const {
    return physical_fragment_;
  }

  scoped_refptr<NGPhysicalFragment>& MutablePhysicalFragment() {
    return physical_fragment_;
  }

  const Vector<NGOutOfFlowPositionedDescendant>&
  OutOfFlowPositionedDescendants() const {
    return oof_positioned_descendants_;
  }

  // A line-box can have a list of positioned floats. These should be added to
  // the line-box's parent fragment (as floats which occur within a line-box do
  // not appear a children).
  const Vector<NGPositionedFloat>& PositionedFloats() const {
    DCHECK(physical_fragment_->Type() == NGPhysicalFragment::kFragmentLineBox);
    return positioned_floats_;
  }

  const NGUnpositionedListMarker& UnpositionedListMarker() const {
    return unpositioned_list_marker_;
  }

  const NGExclusionSpace* ExclusionSpace() const {
    return exclusion_space_.get();
  }

  NGLayoutResultStatus Status() const {
    return static_cast<NGLayoutResultStatus>(status_);
  }

  LayoutUnit BfcLineOffset() const { return bfc_line_offset_; }
  const base::Optional<LayoutUnit>& BfcBlockOffset() const {
    return bfc_block_offset_;
  }

  const NGMarginStrut EndMarginStrut() const { return end_margin_strut_; }

  const LayoutUnit IntrinsicBlockSize() const {
    DCHECK(physical_fragment_->Type() == NGPhysicalFragment::kFragmentBox);
    return intrinsic_block_size_;
  }

  LayoutUnit MinimalSpaceShortage() const { return minimal_space_shortage_; }

  // The break-before value on the first child needs to be propagated to the
  // container, in search of a valid class A break point.
  EBreakBetween InitialBreakBefore() const { return initial_break_before_; }

  // The break-after value on the last child needs to be propagated to the
  // container, in search of a valid class A break point.
  EBreakBetween FinalBreakAfter() const { return final_break_after_; }

  // Return true if the fragment broke because a forced break before a child.
  bool HasForcedBreak() const { return has_forced_break_; }

  // Return true if this fragment got its block offset increased by the presence
  // of floats.
  bool IsPushedByFloats() const { return is_pushed_by_floats_; }

  // Return the types (none, left, right, both) of preceding adjoining
  // floats. These are floats that are added while the in-flow BFC block offset
  // is still unknown. The floats may or may not be unpositioned (pending). That
  // depends on which layout pass we're in. Adjoining floats should be treated
  // differently when calculating clearance on a block with adjoining
  // block-start margin (in such cases we will know up front that the block will
  // need clearance, since, if it doesn't, the float will be pulled along with
  // the block, and the block will fail to clear).
  NGFloatTypes AdjoiningFloatTypes() const { return adjoining_floats_; }

  scoped_refptr<NGLayoutResult> CloneWithoutOffset() const;

 private:
  friend class NGFragmentBuilder;
  friend class NGLineBoxFragmentBuilder;

  NGLayoutResult(scoped_refptr<NGPhysicalFragment> physical_fragment,
                 Vector<NGOutOfFlowPositionedDescendant>&
                     out_of_flow_positioned_descendants,
                 Vector<NGPositionedFloat>& positioned_floats,
                 const NGUnpositionedListMarker& unpositioned_list_marker,
                 std::unique_ptr<const NGExclusionSpace> exclusion_space,
                 LayoutUnit bfc_line_offset,
                 const base::Optional<LayoutUnit> bfc_block_offset,
                 const NGMarginStrut end_margin_strut,
                 const LayoutUnit intrinsic_block_size,
                 LayoutUnit minimal_space_shortage,
                 EBreakBetween initial_break_before,
                 EBreakBetween final_break_after,
                 bool has_forced_break,
                 bool is_pushed_by_floats,
                 NGFloatTypes adjoining_floats,
                 NGLayoutResultStatus status);

  scoped_refptr<NGPhysicalFragment> physical_fragment_;
  Vector<NGOutOfFlowPositionedDescendant> oof_positioned_descendants_;

  Vector<NGPositionedFloat> positioned_floats_;

  NGUnpositionedListMarker unpositioned_list_marker_;

  const std::unique_ptr<const NGExclusionSpace> exclusion_space_;
  const LayoutUnit bfc_line_offset_;
  const base::Optional<LayoutUnit> bfc_block_offset_;
  const NGMarginStrut end_margin_strut_;
  const LayoutUnit intrinsic_block_size_;
  const LayoutUnit minimal_space_shortage_;

  EBreakBetween initial_break_before_;
  EBreakBetween final_break_after_;

  unsigned has_forced_break_ : 1;

  unsigned is_pushed_by_floats_ : 1;
  unsigned adjoining_floats_ : 2;  // NGFloatTypes

  unsigned status_ : 1;
};

}  // namespace blink

#endif  // NGLayoutResult_h