| Index: third_party/WebKit/Source/core/layout/FragmentationContext.h
|
| diff --git a/third_party/WebKit/Source/core/layout/FragmentationContext.h b/third_party/WebKit/Source/core/layout/FragmentationContext.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..dd8d8ff78c97fde181a3b86c23275496dac56843
|
| --- /dev/null
|
| +++ b/third_party/WebKit/Source/core/layout/FragmentationContext.h
|
| @@ -0,0 +1,53 @@
|
| +// Copyright 2015 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 FragmentationContext_h
|
| +#define FragmentationContext_h
|
| +
|
| +#include "core/CoreExport.h"
|
| +#include "platform/LayoutUnit.h"
|
| +#include "platform/geometry/LayoutSize.h"
|
| +
|
| +namespace blink {
|
| +
|
| +// A fragmentation context is either established by a multicol container, or by pages when
|
| +// printing. A fragmentation context consists of a series of fragmentainers. A fragmentainer is
|
| +// simply a column or page, depending on the type of fragmentation context. [1]
|
| +//
|
| +// A couple of methods here take a |blockOffset| parameter. This is the offset from the start of the
|
| +// fragmentation context, pretending that everything is laid out in one single strip (and not sliced
|
| +// into pages or columns). In multicol, this is referred to as the flow thread coordinate space.
|
| +//
|
| +// It should be noted that a multicol container may be nested inside another fragmentation context
|
| +// (another multicol container, or the pages when printing), although this class doesn't deal with
|
| +// that (it's internal to the multicol implementation).
|
| +//
|
| +// [1] http://www.w3.org/TR/css3-break/#fragmentation-model
|
| +class CORE_EXPORT FragmentationContext {
|
| +public:
|
| + virtual ~FragmentationContext() { }
|
| +
|
| + // The height of the fragmentainers may depend on the total height of the contents (column
|
| + // balancing), in which case false is returned if we haven't laid out yet. Otherwise, true is
|
| + // returned.
|
| + virtual bool isFragmentainerLogicalHeightKnown() = 0;
|
| +
|
| + // Return the height of the fragmentainer at the specified offset. The fragmentainer height
|
| + // isn't necessarily uniform all across the fragmentation context.
|
| + virtual LayoutUnit fragmentainerLogicalHeightAt(LayoutUnit blockOffset) = 0;
|
| +
|
| + // Return how much is left of the fragmentainer at the specified offset. Callers typically want
|
| + // this information to decide whether some piece of content fits in this fragmentainer, or if it
|
| + // has to push the content to the next fragmentainer.
|
| + virtual LayoutUnit remainingLogicalHeightAt(LayoutUnit blockOffset) = 0;
|
| +
|
| + // Return the flow thread of the fragmentation context, if it is a multicol fragmentation
|
| + // context. Since multicol containers may be nested inside other fragmentation contexts,
|
| + // sometimes we need to know if it's a multicol container that we're dealing with.
|
| + virtual class LayoutMultiColumnFlowThread* associatedFlowThread() { return nullptr; }
|
| +};
|
| +
|
| +} // namespace blink
|
| +
|
| +#endif // FragmentationContext_h
|
|
|