summaryrefslogtreecommitdiffstats
path: root/layout/generic/TextOverflow.h
diff options
context:
space:
mode:
Diffstat (limited to 'layout/generic/TextOverflow.h')
-rw-r--r--layout/generic/TextOverflow.h259
1 files changed, 259 insertions, 0 deletions
diff --git a/layout/generic/TextOverflow.h b/layout/generic/TextOverflow.h
new file mode 100644
index 000000000..835b35be1
--- /dev/null
+++ b/layout/generic/TextOverflow.h
@@ -0,0 +1,259 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set shiftwidth=2 tabstop=8 autoindent cindent expandtab: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef TextOverflow_h_
+#define TextOverflow_h_
+
+#include "nsDisplayList.h"
+#include "nsTHashtable.h"
+#include "mozilla/Likely.h"
+#include "mozilla/WritingModes.h"
+#include <algorithm>
+
+class nsIScrollableFrame;
+class nsLineBox;
+
+namespace mozilla {
+namespace css {
+
+/**
+ * A class for rendering CSS3 text-overflow.
+ * Usage:
+ * 1. allocate an object using WillProcessLines
+ * 2. then call ProcessLine for each line you are building display lists for
+ */
+class TextOverflow {
+ public:
+ /**
+ * Allocate an object for text-overflow processing.
+ * @return nullptr if no processing is necessary. The caller owns the object.
+ */
+ static TextOverflow* WillProcessLines(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aBlockFrame);
+ /**
+ * Analyze the display lists for text overflow and what kind of item is at
+ * the content edges. Add display items for text-overflow markers as needed
+ * and remove or clip items that would overlap a marker.
+ */
+ void ProcessLine(const nsDisplayListSet& aLists, nsLineBox* aLine);
+
+ /**
+ * Get the resulting text-overflow markers (the list may be empty).
+ * @return a DisplayList containing any text-overflow markers.
+ */
+ nsDisplayList& GetMarkers() { return mMarkerList; }
+
+ /**
+ * @return true if aBlockFrmae has text-overflow:clip on both sides.
+ */
+ static bool HasClippedOverflow(nsIFrame* aBlockFrame);
+ /**
+ * @return true if aBlockFrame needs analysis for text overflow.
+ */
+ static bool CanHaveTextOverflow(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aBlockFrame);
+
+ typedef nsTHashtable<nsPtrHashKey<nsIFrame> > FrameHashtable;
+
+ protected:
+ TextOverflow(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aBlockFrame);
+
+ typedef mozilla::WritingMode WritingMode;
+ typedef mozilla::LogicalRect LogicalRect;
+
+ struct AlignmentEdges {
+ AlignmentEdges() : mAssigned(false) {}
+ void Accumulate(WritingMode aWM, const LogicalRect& aRect)
+ {
+ if (MOZ_LIKELY(mAssigned)) {
+ mIStart = std::min(mIStart, aRect.IStart(aWM));
+ mIEnd = std::max(mIEnd, aRect.IEnd(aWM));
+ } else {
+ mIStart = aRect.IStart(aWM);
+ mIEnd = aRect.IEnd(aWM);
+ mAssigned = true;
+ }
+ }
+ nscoord ISize() { return mIEnd - mIStart; }
+ nscoord mIStart;
+ nscoord mIEnd;
+ bool mAssigned;
+ };
+
+ struct InnerClipEdges {
+ InnerClipEdges() : mAssignedIStart(false), mAssignedIEnd(false) {}
+ void AccumulateIStart(WritingMode aWM, const LogicalRect& aRect)
+ {
+ if (MOZ_LIKELY(mAssignedIStart)) {
+ mIStart = std::max(mIStart, aRect.IStart(aWM));
+ } else {
+ mIStart = aRect.IStart(aWM);
+ mAssignedIStart = true;
+ }
+ }
+ void AccumulateIEnd(WritingMode aWM, const LogicalRect& aRect)
+ {
+ if (MOZ_LIKELY(mAssignedIEnd)) {
+ mIEnd = std::min(mIEnd, aRect.IEnd(aWM));
+ } else {
+ mIEnd = aRect.IEnd(aWM);
+ mAssignedIEnd = true;
+ }
+ }
+ nscoord mIStart;
+ nscoord mIEnd;
+ bool mAssignedIStart;
+ bool mAssignedIEnd;
+ };
+
+ LogicalRect
+ GetLogicalScrollableOverflowRectRelativeToBlock(nsIFrame* aFrame) const
+ {
+ return LogicalRect(mBlockWM,
+ aFrame->GetScrollableOverflowRect() +
+ aFrame->GetOffsetTo(mBlock),
+ mBlockSize);
+ }
+
+ /**
+ * Examines frames on the line to determine whether we should draw a left
+ * and/or right marker, and if so, which frames should be completely hidden
+ * and the bounds of what will be displayed between the markers.
+ * @param aLine the line we're processing
+ * @param aFramesToHide frames that should have their display items removed
+ * @param aAlignmentEdges the outermost edges of all text and atomic
+ * inline-level frames that are inside the area between the markers
+ */
+ void ExamineLineFrames(nsLineBox* aLine,
+ FrameHashtable* aFramesToHide,
+ AlignmentEdges* aAlignmentEdges);
+
+ /**
+ * LineHasOverflowingText calls this to analyze edges, both the block's
+ * content edges and the hypothetical marker edges aligned at the block edges.
+ * @param aFrame the descendant frame of mBlock that we're analyzing
+ * @param aContentArea the block's content area
+ * @param aInsideMarkersArea the rectangle between the markers
+ * @param aFramesToHide frames that should have their display items removed
+ * @param aAlignmentEdges the outermost edges of all text and atomic
+ * inline-level frames that are inside the area between the markers
+ * @param aFoundVisibleTextOrAtomic is set to true if a text or atomic
+ * inline-level frame is visible between the marker edges
+ * @param aClippedMarkerEdges the innermost edges of all text and atomic
+ * inline-level frames that are clipped by the current marker width
+ */
+ void ExamineFrameSubtree(nsIFrame* aFrame,
+ const LogicalRect& aContentArea,
+ const LogicalRect& aInsideMarkersArea,
+ FrameHashtable* aFramesToHide,
+ AlignmentEdges* aAlignmentEdges,
+ bool* aFoundVisibleTextOrAtomic,
+ InnerClipEdges* aClippedMarkerEdges);
+
+ /**
+ * ExamineFrameSubtree calls this to analyze a frame against the hypothetical
+ * marker edges (aInsideMarkersArea) for text frames and atomic inline-level
+ * elements. A text frame adds its extent inside aInsideMarkersArea where
+ * grapheme clusters are fully visible. An atomic adds its border box if
+ * it's fully inside aInsideMarkersArea, otherwise the frame is added to
+ * aFramesToHide.
+ * @param aFrame the descendant frame of mBlock that we're analyzing
+ * @param aFrameType aFrame's frame type
+ * @param aInsideMarkersArea the rectangle between the markers
+ * @param aFramesToHide frames that should have their display items removed
+ * @param aAlignmentEdges the outermost edges of all text and atomic
+ * inline-level frames that are inside the area between the markers
+ * inside aInsideMarkersArea
+ * @param aFoundVisibleTextOrAtomic is set to true if a text or atomic
+ * inline-level frame is visible between the marker edges
+ * @param aClippedMarkerEdges the innermost edges of all text and atomic
+ * inline-level frames that are clipped by the current marker width
+ */
+ void AnalyzeMarkerEdges(nsIFrame* aFrame,
+ const nsIAtom* aFrameType,
+ const LogicalRect& aInsideMarkersArea,
+ FrameHashtable* aFramesToHide,
+ AlignmentEdges* aAlignmentEdges,
+ bool* aFoundVisibleTextOrAtomic,
+ InnerClipEdges* aClippedMarkerEdges);
+
+ /**
+ * Clip or remove items given the final marker edges. ("clip" here just means
+ * assigning mVisIStartEdge/mVisIEndEdge for any nsCharClipDisplayItem that
+ * needs it; see nsDisplayList.h for a description of that item).
+ * @param aFramesToHide remove display items for these frames
+ * @param aInsideMarkersArea is the area inside the markers
+ */
+ void PruneDisplayListContents(nsDisplayList* aList,
+ const FrameHashtable& aFramesToHide,
+ const LogicalRect& aInsideMarkersArea);
+
+ /**
+ * ProcessLine calls this to create display items for the markers and insert
+ * them into mMarkerList.
+ * @param aLine the line we're processing
+ * @param aCreateIStart if true, create a marker on the inline start side
+ * @param aCreateIEnd if true, create a marker on the inline end side
+ * @param aInsideMarkersArea is the area inside the markers
+ */
+ void CreateMarkers(const nsLineBox* aLine,
+ bool aCreateIStart, bool aCreateIEnd,
+ const LogicalRect& aInsideMarkersArea);
+
+ LogicalRect mContentArea;
+ nsDisplayListBuilder* mBuilder;
+ nsIFrame* mBlock;
+ nsIScrollableFrame* mScrollableFrame;
+ nsDisplayList mMarkerList;
+ nsSize mBlockSize;
+ WritingMode mBlockWM;
+ bool mCanHaveInlineAxisScrollbar;
+ bool mAdjustForPixelSnapping;
+
+ class Marker {
+ public:
+ void Init(const nsStyleTextOverflowSide& aStyle) {
+ mInitialized = false;
+ mISize = 0;
+ mStyle = &aStyle;
+ }
+
+ /**
+ * Setup the marker string and calculate its size, if not done already.
+ */
+ void SetupString(nsIFrame* aFrame);
+
+ bool IsNeeded() const {
+ return mHasOverflow;
+ }
+ void Reset() {
+ mHasOverflow = false;
+ }
+
+ // The current width of the marker, the range is [0 .. mIntrinsicISize].
+ nscoord mISize;
+ // The intrinsic width of the marker.
+ nscoord mIntrinsicISize;
+ // The style for this side.
+ const nsStyleTextOverflowSide* mStyle;
+ // True if there is visible overflowing inline content on this side.
+ bool mHasOverflow;
+ // True if mMarkerString and mWidth have been setup from style.
+ bool mInitialized;
+ // True if the style is text-overflow:clip on this side and the marker
+ // won't cause the line to become empty.
+ bool mActive;
+ };
+
+ Marker mIStart; // the inline start marker
+ Marker mIEnd; // the inline end marker
+};
+
+} // namespace css
+} // namespace mozilla
+
+#endif /* !defined(TextOverflow_h_) */