summaryrefslogtreecommitdiffstats
path: root/layout/generic/nsIFrame.cpp
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
commit26a029d407be480d791972afb5975cf62c9360a6 (patch)
treef435a8308119effd964b339f76abb83a57c29483 /layout/generic/nsIFrame.cpp
parentInitial commit. (diff)
downloadfirefox-26a029d407be480d791972afb5975cf62c9360a6.tar.xz
firefox-26a029d407be480d791972afb5975cf62c9360a6.zip
Adding upstream version 124.0.1.upstream/124.0.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'layout/generic/nsIFrame.cpp')
-rw-r--r--layout/generic/nsIFrame.cpp12724
1 files changed, 12724 insertions, 0 deletions
diff --git a/layout/generic/nsIFrame.cpp b/layout/generic/nsIFrame.cpp
new file mode 100644
index 0000000000..81109151ff
--- /dev/null
+++ b/layout/generic/nsIFrame.cpp
@@ -0,0 +1,12724 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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/. */
+
+/* base class of all rendering objects */
+
+#include "nsIFrame.h"
+
+#include <stdarg.h>
+#include <algorithm>
+
+#include "gfx2DGlue.h"
+#include "gfxUtils.h"
+#include "mozilla/Attributes.h"
+#include "mozilla/CaretAssociationHint.h"
+#include "mozilla/ComputedStyle.h"
+#include "mozilla/DebugOnly.h"
+#include "mozilla/DisplayPortUtils.h"
+#include "mozilla/EventForwards.h"
+#include "mozilla/dom/CSSAnimation.h"
+#include "mozilla/dom/CSSTransition.h"
+#include "mozilla/dom/ContentVisibilityAutoStateChangeEvent.h"
+#include "mozilla/dom/DocumentInlines.h"
+#include "mozilla/dom/AncestorIterator.h"
+#include "mozilla/dom/ElementInlines.h"
+#include "mozilla/dom/ImageTracker.h"
+#include "mozilla/dom/Selection.h"
+#include "mozilla/gfx/2D.h"
+#include "mozilla/gfx/PathHelpers.h"
+#include "mozilla/IntegerRange.h"
+#include "mozilla/intl/BidiEmbeddingLevel.h"
+#include "mozilla/Maybe.h"
+#include "mozilla/PresShell.h"
+#include "mozilla/PresShellInlines.h"
+#include "mozilla/ResultExtensions.h"
+#include "mozilla/SelectionMovementUtils.h"
+#include "mozilla/Sprintf.h"
+#include "mozilla/StaticAnalysisFunctions.h"
+#include "mozilla/StaticPrefs_layout.h"
+#include "mozilla/StaticPrefs_print.h"
+#include "mozilla/StaticPrefs_ui.h"
+#include "mozilla/SVGMaskFrame.h"
+#include "mozilla/SVGObserverUtils.h"
+#include "mozilla/SVGTextFrame.h"
+#include "mozilla/SVGIntegrationUtils.h"
+#include "mozilla/SVGUtils.h"
+#include "mozilla/TextControlElement.h"
+#include "mozilla/ToString.h"
+#include "mozilla/Try.h"
+#include "mozilla/ViewportUtils.h"
+
+#include "nsCOMPtr.h"
+#include "nsFieldSetFrame.h"
+#include "nsFlexContainerFrame.h"
+#include "nsFocusManager.h"
+#include "nsFrameList.h"
+#include "nsPlaceholderFrame.h"
+#include "nsIBaseWindow.h"
+#include "nsIContent.h"
+#include "nsIContentInlines.h"
+#include "nsContentUtils.h"
+#include "nsCSSFrameConstructor.h"
+#include "nsCSSProps.h"
+#include "nsCSSPseudoElements.h"
+#include "nsCSSRendering.h"
+#include "nsAtom.h"
+#include "nsString.h"
+#include "nsReadableUtils.h"
+#include "nsTableWrapperFrame.h"
+#include "nsView.h"
+#include "nsViewManager.h"
+#include "nsIScrollableFrame.h"
+#include "nsPresContext.h"
+#include "nsPresContextInlines.h"
+#include "nsStyleConsts.h"
+#include "mozilla/Logging.h"
+#include "nsLayoutUtils.h"
+#include "LayoutLogging.h"
+#include "mozilla/RestyleManager.h"
+#include "nsImageFrame.h"
+#include "nsInlineFrame.h"
+#include "nsFrameSelection.h"
+#include "nsGkAtoms.h"
+#include "nsGridContainerFrame.h"
+#include "nsGfxScrollFrame.h"
+#include "nsCSSAnonBoxes.h"
+#include "nsCanvasFrame.h"
+
+#include "nsFieldSetFrame.h"
+#include "nsFrameTraversal.h"
+#include "nsRange.h"
+#include "nsITextControlFrame.h"
+#include "nsNameSpaceManager.h"
+#include "nsIPercentBSizeObserver.h"
+#include "nsStyleStructInlines.h"
+
+#include "nsBidiPresUtils.h"
+#include "RubyUtils.h"
+#include "TextOverflow.h"
+#include "nsAnimationManager.h"
+
+// For triple-click pref
+#include "imgIRequest.h"
+#include "nsError.h"
+#include "nsContainerFrame.h"
+#include "nsBlockFrame.h"
+#include "nsDisplayList.h"
+#include "nsChangeHint.h"
+#include "nsSubDocumentFrame.h"
+#include "RetainedDisplayListBuilder.h"
+
+#include "gfxContext.h"
+#include "nsAbsoluteContainingBlock.h"
+#include "ScrollSnap.h"
+#include "StickyScrollContainer.h"
+#include "nsFontInflationData.h"
+#include "nsRegion.h"
+#include "nsIFrameInlines.h"
+#include "nsStyleChangeList.h"
+#include "nsWindowSizes.h"
+
+#ifdef ACCESSIBILITY
+# include "nsAccessibilityService.h"
+#endif
+
+#include "mozilla/AsyncEventDispatcher.h"
+#include "mozilla/CSSClipPathInstance.h"
+#include "mozilla/EffectCompositor.h"
+#include "mozilla/EffectSet.h"
+#include "mozilla/EventListenerManager.h"
+#include "mozilla/EventStateManager.h"
+#include "mozilla/Preferences.h"
+#include "mozilla/LookAndFeel.h"
+#include "mozilla/MouseEvents.h"
+#include "mozilla/ServoStyleSet.h"
+#include "mozilla/ServoStyleSetInlines.h"
+#include "mozilla/css/ImageLoader.h"
+#include "mozilla/dom/HTMLBodyElement.h"
+#include "mozilla/dom/SVGPathData.h"
+#include "mozilla/dom/TouchEvent.h"
+#include "mozilla/gfx/Tools.h"
+#include "mozilla/layers/WebRenderUserData.h"
+#include "mozilla/layout/ScrollAnchorContainer.h"
+#include "nsPrintfCString.h"
+#include "ActiveLayerTracker.h"
+
+#include "nsITheme.h"
+
+using namespace mozilla;
+using namespace mozilla::css;
+using namespace mozilla::dom;
+using namespace mozilla::gfx;
+using namespace mozilla::layers;
+using namespace mozilla::layout;
+typedef nsAbsoluteContainingBlock::AbsPosReflowFlags AbsPosReflowFlags;
+using nsStyleTransformMatrix::TransformReferenceBox;
+
+nsIFrame* nsILineIterator::LineInfo::GetLastFrameOnLine() const {
+ if (!mNumFramesOnLine) {
+ return nullptr; // empty line, not illegal
+ }
+ MOZ_ASSERT(mFirstFrameOnLine);
+ nsIFrame* maybeLastFrame = mFirstFrameOnLine;
+ for ([[maybe_unused]] int32_t i : IntegerRange(mNumFramesOnLine - 1)) {
+ maybeLastFrame = maybeLastFrame->GetNextSibling();
+ if (NS_WARN_IF(!maybeLastFrame)) {
+ return nullptr;
+ }
+ }
+ return maybeLastFrame;
+}
+
+#ifdef HAVE_64BIT_BUILD
+static_assert(sizeof(nsIFrame) == 120, "nsIFrame should remain small");
+#else
+static_assert(sizeof(void*) == 4, "Odd build config?");
+// FIXME(emilio): Investigate why win32 and android-arm32 have bigger sizes (80)
+// than Linux32 (76).
+static_assert(sizeof(nsIFrame) <= 80, "nsIFrame should remain small");
+#endif
+
+const mozilla::LayoutFrameType nsIFrame::sLayoutFrameTypes[kFrameClassCount] = {
+#define FRAME_ID(class_, type_, ...) mozilla::LayoutFrameType::type_,
+#define ABSTRACT_FRAME_ID(...)
+#include "mozilla/FrameIdList.h"
+#undef FRAME_ID
+#undef ABSTRACT_FRAME_ID
+};
+
+const nsIFrame::ClassFlags nsIFrame::sLayoutFrameClassFlags[kFrameClassCount] =
+ {
+#define FRAME_ID(class_, type_, flags_, ...) flags_,
+#define ABSTRACT_FRAME_ID(...)
+#include "mozilla/FrameIdList.h"
+#undef FRAME_ID
+#undef ABSTRACT_FRAME_ID
+};
+
+std::ostream& operator<<(std::ostream& aStream, const nsDirection& aDirection) {
+ return aStream << (aDirection == eDirNext ? "eDirNext" : "eDirPrevious");
+}
+
+struct nsContentAndOffset {
+ nsIContent* mContent = nullptr;
+ int32_t mOffset = 0;
+};
+
+#include "nsILineIterator.h"
+#include "prenv.h"
+
+// Utility function to set a nsRect-valued property table entry on aFrame,
+// reusing the existing storage if the property happens to be already set.
+template <typename T>
+static void SetOrUpdateRectValuedProperty(
+ nsIFrame* aFrame, FrameProperties::Descriptor<T> aProperty,
+ const nsRect& aNewValue) {
+ bool found;
+ nsRect* rectStorage = aFrame->GetProperty(aProperty, &found);
+ if (!found) {
+ rectStorage = new nsRect(aNewValue);
+ aFrame->AddProperty(aProperty, rectStorage);
+ } else {
+ *rectStorage = aNewValue;
+ }
+}
+
+FrameDestroyContext::~FrameDestroyContext() {
+ for (auto& content : mozilla::Reversed(mAnonymousContent)) {
+ mPresShell->NativeAnonymousContentRemoved(content);
+ content->UnbindFromTree();
+ }
+}
+
+// Formerly the nsIFrameDebug interface
+
+std::ostream& operator<<(std::ostream& aStream, const nsReflowStatus& aStatus) {
+ char complete = 'Y';
+ if (aStatus.IsIncomplete()) {
+ complete = 'N';
+ } else if (aStatus.IsOverflowIncomplete()) {
+ complete = 'O';
+ }
+
+ char brk = 'N';
+ if (aStatus.IsInlineBreakBefore()) {
+ brk = 'B';
+ } else if (aStatus.IsInlineBreakAfter()) {
+ brk = 'A';
+ }
+
+ aStream << "["
+ << "Complete=" << complete << ","
+ << "NIF=" << (aStatus.NextInFlowNeedsReflow() ? 'Y' : 'N') << ","
+ << "Break=" << brk << ","
+ << "FirstLetter=" << (aStatus.FirstLetterComplete() ? 'Y' : 'N')
+ << "]";
+ return aStream;
+}
+
+#ifdef DEBUG
+
+/**
+ * Note: the log module is created during library initialization which
+ * means that you cannot perform logging before then.
+ */
+mozilla::LazyLogModule nsIFrame::sFrameLogModule("frame");
+
+#endif
+
+NS_DECLARE_FRAME_PROPERTY_DELETABLE(AbsoluteContainingBlockProperty,
+ nsAbsoluteContainingBlock)
+
+bool nsIFrame::HasAbsolutelyPositionedChildren() const {
+ return IsAbsoluteContainer() &&
+ GetAbsoluteContainingBlock()->HasAbsoluteFrames();
+}
+
+nsAbsoluteContainingBlock* nsIFrame::GetAbsoluteContainingBlock() const {
+ NS_ASSERTION(IsAbsoluteContainer(),
+ "The frame is not marked as an abspos container correctly");
+ nsAbsoluteContainingBlock* absCB =
+ GetProperty(AbsoluteContainingBlockProperty());
+ NS_ASSERTION(absCB,
+ "The frame is marked as an abspos container but doesn't have "
+ "the property");
+ return absCB;
+}
+
+void nsIFrame::MarkAsAbsoluteContainingBlock() {
+ MOZ_ASSERT(HasAnyStateBits(NS_FRAME_CAN_HAVE_ABSPOS_CHILDREN));
+ NS_ASSERTION(!GetProperty(AbsoluteContainingBlockProperty()),
+ "Already has an abs-pos containing block property?");
+ NS_ASSERTION(!HasAnyStateBits(NS_FRAME_HAS_ABSPOS_CHILDREN),
+ "Already has NS_FRAME_HAS_ABSPOS_CHILDREN state bit?");
+ AddStateBits(NS_FRAME_HAS_ABSPOS_CHILDREN);
+ SetProperty(AbsoluteContainingBlockProperty(),
+ new nsAbsoluteContainingBlock(GetAbsoluteListID()));
+}
+
+void nsIFrame::MarkAsNotAbsoluteContainingBlock() {
+ NS_ASSERTION(!HasAbsolutelyPositionedChildren(), "Think of the children!");
+ NS_ASSERTION(GetProperty(AbsoluteContainingBlockProperty()),
+ "Should have an abs-pos containing block property");
+ NS_ASSERTION(HasAnyStateBits(NS_FRAME_HAS_ABSPOS_CHILDREN),
+ "Should have NS_FRAME_HAS_ABSPOS_CHILDREN state bit");
+ MOZ_ASSERT(HasAnyStateBits(NS_FRAME_CAN_HAVE_ABSPOS_CHILDREN));
+ RemoveStateBits(NS_FRAME_HAS_ABSPOS_CHILDREN);
+ RemoveProperty(AbsoluteContainingBlockProperty());
+}
+
+bool nsIFrame::CheckAndClearPaintedState() {
+ bool result = HasAnyStateBits(NS_FRAME_PAINTED_THEBES);
+ RemoveStateBits(NS_FRAME_PAINTED_THEBES);
+
+ for (const auto& childList : ChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ if (child->CheckAndClearPaintedState()) {
+ result = true;
+ }
+ }
+ }
+ return result;
+}
+
+bool nsIFrame::CheckAndClearDisplayListState() {
+ bool result = BuiltDisplayList();
+ SetBuiltDisplayList(false);
+
+ for (const auto& childList : ChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ if (child->CheckAndClearDisplayListState()) {
+ result = true;
+ }
+ }
+ }
+ return result;
+}
+
+bool nsIFrame::IsVisibleConsideringAncestors(uint32_t aFlags) const {
+ if (!StyleVisibility()->IsVisible()) {
+ return false;
+ }
+
+ if (PresShell()->IsUnderHiddenEmbedderElement()) {
+ return false;
+ }
+
+ const nsIFrame* frame = this;
+ while (frame) {
+ nsView* view = frame->GetView();
+ if (view && view->GetVisibility() == ViewVisibility::Hide) {
+ return false;
+ }
+
+ if (frame->StyleUIReset()->mMozSubtreeHiddenOnlyVisually) {
+ return false;
+ }
+
+ // This method is used to determine if a frame is focusable, because it's
+ // called by nsIFrame::IsFocusable. `content-visibility: auto` should not
+ // force this frame to be unfocusable, so we only take into account
+ // `content-visibility: hidden` here.
+ if (this != frame &&
+ frame->HidesContent(IncludeContentVisibility::Hidden)) {
+ return false;
+ }
+
+ if (nsIFrame* parent = frame->GetParent()) {
+ frame = parent;
+ } else {
+ parent = nsLayoutUtils::GetCrossDocParentFrameInProcess(frame);
+ if (!parent) break;
+
+ if ((aFlags & nsIFrame::VISIBILITY_CROSS_CHROME_CONTENT_BOUNDARY) == 0 &&
+ parent->PresContext()->IsChrome() &&
+ !frame->PresContext()->IsChrome()) {
+ break;
+ }
+
+ frame = parent;
+ }
+ }
+
+ return true;
+}
+
+void nsIFrame::FindCloserFrameForSelection(
+ const nsPoint& aPoint, FrameWithDistance* aCurrentBestFrame) {
+ if (nsLayoutUtils::PointIsCloserToRect(aPoint, mRect,
+ aCurrentBestFrame->mXDistance,
+ aCurrentBestFrame->mYDistance)) {
+ aCurrentBestFrame->mFrame = this;
+ }
+}
+
+void nsIFrame::ElementStateChanged(mozilla::dom::ElementState aStates) {}
+
+void WeakFrame::Clear(mozilla::PresShell* aPresShell) {
+ if (aPresShell) {
+ aPresShell->RemoveWeakFrame(this);
+ }
+ mFrame = nullptr;
+}
+
+AutoWeakFrame::AutoWeakFrame(const WeakFrame& aOther)
+ : mPrev(nullptr), mFrame(nullptr) {
+ Init(aOther.GetFrame());
+}
+
+void AutoWeakFrame::Clear(mozilla::PresShell* aPresShell) {
+ if (aPresShell) {
+ aPresShell->RemoveAutoWeakFrame(this);
+ }
+ mFrame = nullptr;
+ mPrev = nullptr;
+}
+
+AutoWeakFrame::~AutoWeakFrame() {
+ Clear(mFrame ? mFrame->PresContext()->GetPresShell() : nullptr);
+}
+
+void AutoWeakFrame::Init(nsIFrame* aFrame) {
+ Clear(mFrame ? mFrame->PresContext()->GetPresShell() : nullptr);
+ mFrame = aFrame;
+ if (mFrame) {
+ mozilla::PresShell* presShell = mFrame->PresContext()->GetPresShell();
+ NS_WARNING_ASSERTION(presShell, "Null PresShell in AutoWeakFrame!");
+ if (presShell) {
+ presShell->AddAutoWeakFrame(this);
+ } else {
+ mFrame = nullptr;
+ }
+ }
+}
+
+void WeakFrame::Init(nsIFrame* aFrame) {
+ Clear(mFrame ? mFrame->PresContext()->GetPresShell() : nullptr);
+ mFrame = aFrame;
+ if (mFrame) {
+ mozilla::PresShell* presShell = mFrame->PresContext()->GetPresShell();
+ MOZ_ASSERT(presShell, "Null PresShell in WeakFrame!");
+ if (presShell) {
+ presShell->AddWeakFrame(this);
+ } else {
+ mFrame = nullptr;
+ }
+ }
+}
+
+nsIFrame* NS_NewEmptyFrame(PresShell* aPresShell, ComputedStyle* aStyle) {
+ return new (aPresShell) nsIFrame(aStyle, aPresShell->GetPresContext());
+}
+
+nsIFrame::~nsIFrame() {
+ MOZ_COUNT_DTOR(nsIFrame);
+
+ MOZ_ASSERT(GetVisibility() != Visibility::ApproximatelyVisible,
+ "Visible nsFrame is being destroyed");
+}
+
+NS_IMPL_FRAMEARENA_HELPERS(nsIFrame)
+
+// Dummy operator delete. Will never be called, but must be defined
+// to satisfy some C++ ABIs.
+void nsIFrame::operator delete(void*, size_t) {
+ MOZ_CRASH("nsIFrame::operator delete should never be called");
+}
+
+NS_QUERYFRAME_HEAD(nsIFrame)
+ NS_QUERYFRAME_ENTRY(nsIFrame)
+NS_QUERYFRAME_TAIL_INHERITANCE_ROOT
+
+/////////////////////////////////////////////////////////////////////////////
+// nsIFrame
+
+static bool IsFontSizeInflationContainer(nsIFrame* aFrame,
+ const nsStyleDisplay* aStyleDisplay) {
+ /*
+ * Font size inflation is built around the idea that we're inflating
+ * the fonts for a pan-and-zoom UI so that when the user scales up a
+ * block or other container to fill the width of the device, the fonts
+ * will be readable. To do this, we need to pick what counts as a
+ * container.
+ *
+ * From a code perspective, the only hard requirement is that frames
+ * that are line participants (nsIFrame::IsLineParticipant) are never
+ * containers, since line layout assumes that the inflation is consistent
+ * within a line.
+ *
+ * This is not an imposition, since we obviously want a bunch of text
+ * (possibly with inline elements) flowing within a block to count the
+ * block (or higher) as its container.
+ *
+ * We also want form controls, including the text in the anonymous
+ * content inside of them, to match each other and the text next to
+ * them, so they and their anonymous content should also not be a
+ * container.
+ *
+ * However, because we can't reliably compute sizes across XUL during
+ * reflow, any XUL frame with a XUL parent is always a container.
+ *
+ * There are contexts where it would be nice if some blocks didn't
+ * count as a container, so that, for example, an indented quotation
+ * didn't end up with a smaller font size. However, it's hard to
+ * distinguish these situations where we really do want the indented
+ * thing to count as a container, so we don't try, and blocks are
+ * always containers.
+ */
+
+ // The root frame should always be an inflation container.
+ if (!aFrame->GetParent()) {
+ return true;
+ }
+
+ nsIContent* content = aFrame->GetContent();
+ if (content && content->IsInNativeAnonymousSubtree()) {
+ // Native anonymous content shouldn't be a font inflation root,
+ // except for the canvas custom content container.
+ nsCanvasFrame* canvas = aFrame->PresShell()->GetCanvasFrame();
+ return canvas && canvas->GetCustomContentContainer() == content;
+ }
+
+ LayoutFrameType frameType = aFrame->Type();
+ bool isInline =
+ aFrame->GetDisplay().IsInlineFlow() || RubyUtils::IsRubyBox(frameType) ||
+ (aStyleDisplay->IsFloatingStyle() &&
+ frameType == LayoutFrameType::Letter) ||
+ // Given multiple frames for the same node, only the
+ // outer one should be considered a container.
+ // (Important, e.g., for nsSelectsAreaFrame.)
+ (aFrame->GetParent()->GetContent() == content) ||
+ (content &&
+ // Form controls shouldn't become inflation containers.
+ (content->IsAnyOfHTMLElements(nsGkAtoms::option, nsGkAtoms::optgroup,
+ nsGkAtoms::select, nsGkAtoms::input,
+ nsGkAtoms::button, nsGkAtoms::textarea)));
+ NS_ASSERTION(!aFrame->IsLineParticipant() || isInline ||
+ // br frames and mathml frames report being line
+ // participants even when their position or display is
+ // set
+ aFrame->IsBrFrame() || aFrame->IsMathMLFrame(),
+ "line participants must not be containers");
+ return !isInline;
+}
+
+static void MaybeScheduleReflowSVGNonDisplayText(nsIFrame* aFrame) {
+ if (!aFrame->IsInSVGTextSubtree()) {
+ return;
+ }
+
+ // We need to ensure that any non-display SVGTextFrames get reflowed when a
+ // child text frame gets new style. Thus we need to schedule a reflow in
+ // |DidSetComputedStyle|. We also need to call it from |DestroyFrom|,
+ // because otherwise we won't get notified when style changes to
+ // "display:none".
+ SVGTextFrame* svgTextFrame = static_cast<SVGTextFrame*>(
+ nsLayoutUtils::GetClosestFrameOfType(aFrame, LayoutFrameType::SVGText));
+ nsIFrame* anonBlock = svgTextFrame->PrincipalChildList().FirstChild();
+
+ // Note that we must check NS_FRAME_FIRST_REFLOW on our SVGTextFrame's
+ // anonymous block frame rather than our aFrame, since NS_FRAME_FIRST_REFLOW
+ // may be set on us if we're a new frame that has been inserted after the
+ // document's first reflow. (In which case this DidSetComputedStyle call may
+ // be happening under frame construction under a Reflow() call.)
+ if (!anonBlock || anonBlock->HasAnyStateBits(NS_FRAME_FIRST_REFLOW)) {
+ return;
+ }
+
+ if (!svgTextFrame->HasAnyStateBits(NS_FRAME_IS_NONDISPLAY) ||
+ svgTextFrame->HasAnyStateBits(NS_STATE_SVG_TEXT_IN_REFLOW)) {
+ return;
+ }
+
+ svgTextFrame->ScheduleReflowSVGNonDisplayText(
+ IntrinsicDirty::FrameAncestorsAndDescendants);
+}
+
+bool nsIFrame::IsPrimaryFrameOfRootOrBodyElement() const {
+ if (!IsPrimaryFrame()) {
+ return false;
+ }
+ nsIContent* content = GetContent();
+ Document* document = content->OwnerDoc();
+ return content == document->GetRootElement() ||
+ content == document->GetBodyElement();
+}
+
+bool nsIFrame::IsRenderedLegend() const {
+ if (auto* parent = GetParent(); parent && parent->IsFieldSetFrame()) {
+ return static_cast<nsFieldSetFrame*>(parent)->GetLegend() == this;
+ }
+ return false;
+}
+
+void nsIFrame::Init(nsIContent* aContent, nsContainerFrame* aParent,
+ nsIFrame* aPrevInFlow) {
+ MOZ_ASSERT(nsQueryFrame::FrameIID(mClass) == GetFrameId());
+ MOZ_ASSERT(!mContent, "Double-initing a frame?");
+
+ mContent = aContent;
+ mParent = aParent;
+ MOZ_DIAGNOSTIC_ASSERT(!mParent || PresShell() == mParent->PresShell());
+
+ if (aPrevInFlow) {
+ mWritingMode = aPrevInFlow->GetWritingMode();
+
+ // Copy some state bits from prev-in-flow (the bits that should apply
+ // throughout a continuation chain). The bits are sorted according to their
+ // order in nsFrameStateBits.h.
+
+ // clang-format off
+ AddStateBits(aPrevInFlow->GetStateBits() &
+ (NS_FRAME_GENERATED_CONTENT |
+ NS_FRAME_OUT_OF_FLOW |
+ NS_FRAME_CAN_HAVE_ABSPOS_CHILDREN |
+ NS_FRAME_INDEPENDENT_SELECTION |
+ NS_FRAME_PART_OF_IBSPLIT |
+ NS_FRAME_MAY_BE_TRANSFORMED |
+ NS_FRAME_HAS_MULTI_COLUMN_ANCESTOR));
+ // clang-format on
+
+ // Copy other bits in nsIFrame from prev-in-flow.
+ mHasColumnSpanSiblings = aPrevInFlow->HasColumnSpanSiblings();
+ } else {
+ PresContext()->ConstructedFrame();
+ }
+
+ if (GetParent()) {
+ if (MOZ_UNLIKELY(mContent == PresContext()->Document()->GetRootElement() &&
+ mContent == GetParent()->GetContent())) {
+ // Our content is the root element and we have the same content as our
+ // parent. That is, we are the internal anonymous frame of the root
+ // element. Copy the used mWritingMode from our parent because
+ // mDocElementContainingBlock gets its mWritingMode from <body>.
+ mWritingMode = GetParent()->GetWritingMode();
+ }
+
+ // Copy some state bits from our parent (the bits that should apply
+ // recursively throughout a subtree). The bits are sorted according to their
+ // order in nsFrameStateBits.h.
+
+ // clang-format off
+ AddStateBits(GetParent()->GetStateBits() &
+ (NS_FRAME_GENERATED_CONTENT |
+ NS_FRAME_INDEPENDENT_SELECTION |
+ NS_FRAME_IS_SVG_TEXT |
+ NS_FRAME_IN_POPUP |
+ NS_FRAME_IS_NONDISPLAY));
+ // clang-format on
+
+ if (HasAnyStateBits(NS_FRAME_IN_POPUP) && TrackingVisibility()) {
+ // Assume all frames in popups are visible.
+ IncApproximateVisibleCount();
+ }
+ }
+ if (aPrevInFlow) {
+ mMayHaveOpacityAnimation = aPrevInFlow->MayHaveOpacityAnimation();
+ mMayHaveTransformAnimation = aPrevInFlow->MayHaveTransformAnimation();
+ } else if (mContent) {
+ // It's fine to fetch the EffectSet for the style frame here because in the
+ // following code we take care of the case where animations may target
+ // a different frame.
+ EffectSet* effectSet = EffectSet::GetForStyleFrame(this);
+ if (effectSet) {
+ mMayHaveOpacityAnimation = effectSet->MayHaveOpacityAnimation();
+
+ if (effectSet->MayHaveTransformAnimation()) {
+ // If we are the inner table frame for display:table content, then
+ // transform animations should go on our parent frame (the table wrapper
+ // frame).
+ //
+ // We do this when initializing the child frame (table inner frame),
+ // because when initializng the table wrapper frame, we don't yet have
+ // access to its children so we can't tell if we have transform
+ // animations or not.
+ if (SupportsCSSTransforms()) {
+ mMayHaveTransformAnimation = true;
+ AddStateBits(NS_FRAME_MAY_BE_TRANSFORMED);
+ } else if (aParent && nsLayoutUtils::GetStyleFrame(aParent) == this) {
+ MOZ_ASSERT(
+ aParent->SupportsCSSTransforms(),
+ "Style frames that don't support transforms should have parents"
+ " that do");
+ aParent->mMayHaveTransformAnimation = true;
+ aParent->AddStateBits(NS_FRAME_MAY_BE_TRANSFORMED);
+ }
+ }
+ }
+ }
+
+ const nsStyleDisplay* disp = StyleDisplay();
+ if (disp->HasTransform(this)) {
+ // If 'transform' dynamically changes, RestyleManager takes care of
+ // updating this bit.
+ AddStateBits(NS_FRAME_MAY_BE_TRANSFORMED);
+ }
+
+ if (nsLayoutUtils::FontSizeInflationEnabled(PresContext()) ||
+ !GetParent()
+#ifdef DEBUG
+ // We have assertions that check inflation invariants even when
+ // font size inflation is not enabled.
+ || true
+#endif
+ ) {
+ if (IsFontSizeInflationContainer(this, disp)) {
+ AddStateBits(NS_FRAME_FONT_INFLATION_CONTAINER);
+ if (!GetParent() ||
+ // I'd use NS_FRAME_OUT_OF_FLOW, but it's not set yet.
+ disp->IsFloating(this) || disp->IsAbsolutelyPositioned(this) ||
+ GetParent()->IsFlexContainerFrame() ||
+ GetParent()->IsGridContainerFrame()) {
+ AddStateBits(NS_FRAME_FONT_INFLATION_FLOW_ROOT);
+ }
+ }
+ NS_ASSERTION(
+ GetParent() || HasAnyStateBits(NS_FRAME_FONT_INFLATION_CONTAINER),
+ "root frame should always be a container");
+ }
+
+ if (TrackingVisibility() && PresShell()->AssumeAllFramesVisible()) {
+ IncApproximateVisibleCount();
+ }
+
+ DidSetComputedStyle(nullptr);
+
+ // For a newly created frame, we need to update this frame's visibility state.
+ // Usually we update the state when the frame is restyled and has a
+ // VisibilityChange change hint but we don't generate any change hints for
+ // newly created frames.
+ // Note: We don't need to do this for placeholders since placeholders have
+ // different styles so that the styles don't have visibility:hidden even if
+ // the parent has visibility:hidden style. We also don't need to update the
+ // state when creating continuations because its visibility is the same as its
+ // prev-in-flow, and the animation code cares only primary frames.
+ if (!IsPlaceholderFrame() && !aPrevInFlow) {
+ UpdateVisibleDescendantsState();
+ }
+
+ if (!aPrevInFlow && HasAnyStateBits(NS_FRAME_IS_NONDISPLAY)) {
+ // We aren't going to get a reflow, so nothing else will call
+ // InvalidateRenderingObservers, we have to do it here.
+ SVGObserverUtils::InvalidateRenderingObservers(this);
+ }
+}
+
+void nsIFrame::InitPrimaryFrame() {
+ MOZ_ASSERT(IsPrimaryFrame());
+ HandlePrimaryFrameStyleChange(nullptr);
+}
+
+void nsIFrame::HandlePrimaryFrameStyleChange(ComputedStyle* aOldStyle) {
+ const nsStyleDisplay* disp = StyleDisplay();
+ const nsStyleDisplay* oldDisp =
+ aOldStyle ? aOldStyle->StyleDisplay() : nullptr;
+
+ const bool wasQueryContainer = oldDisp && oldDisp->IsQueryContainer();
+ const bool isQueryContainer = disp->IsQueryContainer();
+ if (wasQueryContainer != isQueryContainer) {
+ auto* pc = PresContext();
+ if (isQueryContainer) {
+ pc->RegisterContainerQueryFrame(this);
+ } else {
+ pc->UnregisterContainerQueryFrame(this);
+ }
+ }
+
+ const auto cv = disp->ContentVisibility(*this);
+ if (!oldDisp || oldDisp->ContentVisibility(*this) != cv) {
+ if (cv == StyleContentVisibility::Auto) {
+ PresShell()->RegisterContentVisibilityAutoFrame(this);
+ } else {
+ if (auto* element = Element::FromNodeOrNull(GetContent())) {
+ element->ClearContentRelevancy();
+ }
+ PresShell()->UnregisterContentVisibilityAutoFrame(this);
+ }
+ PresContext()->SetNeedsToUpdateHiddenByContentVisibilityForAnimations();
+ }
+
+ HandleLastRememberedSize();
+}
+
+void nsIFrame::Destroy(DestroyContext& aContext) {
+ NS_ASSERTION(!nsContentUtils::IsSafeToRunScript(),
+ "destroy called on frame while scripts not blocked");
+ NS_ASSERTION(!GetNextSibling() && !GetPrevSibling(),
+ "Frames should be removed before destruction.");
+ MOZ_ASSERT(!HasAbsolutelyPositionedChildren());
+ MOZ_ASSERT(!HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT),
+ "NS_FRAME_PART_OF_IBSPLIT set on non-nsContainerFrame?");
+
+ MaybeScheduleReflowSVGNonDisplayText(this);
+
+ SVGObserverUtils::InvalidateDirectRenderingObservers(this);
+
+ const auto* disp = StyleDisplay();
+ if (disp->mPosition == StylePositionProperty::Sticky) {
+ if (auto* ssc =
+ StickyScrollContainer::GetStickyScrollContainerForFrame(this)) {
+ ssc->RemoveFrame(this);
+ }
+ }
+
+ if (HasAnyStateBits(NS_FRAME_OUT_OF_FLOW)) {
+ if (nsPlaceholderFrame* placeholder = GetPlaceholderFrame()) {
+ placeholder->SetOutOfFlowFrame(nullptr);
+ }
+ }
+
+ nsPresContext* pc = PresContext();
+ mozilla::PresShell* ps = pc->GetPresShell();
+ if (IsPrimaryFrame()) {
+ if (disp->IsQueryContainer()) {
+ pc->UnregisterContainerQueryFrame(this);
+ }
+ if (disp->ContentVisibility(*this) == StyleContentVisibility::Auto) {
+ ps->UnregisterContentVisibilityAutoFrame(this);
+ }
+ // This needs to happen before we clear our Properties() table.
+ ActiveLayerTracker::TransferActivityToContent(this, mContent);
+ }
+
+ ScrollAnchorContainer* anchor = nullptr;
+ if (IsScrollAnchor(&anchor)) {
+ anchor->InvalidateAnchor();
+ }
+
+ if (HasCSSAnimations() || HasCSSTransitions() ||
+ // It's fine to look up the style frame here since if we're destroying the
+ // frames for display:table content we should be destroying both wrapper
+ // and inner frame.
+ EffectSet::GetForStyleFrame(this)) {
+ // If no new frame for this element is created by the end of the
+ // restyling process, stop animations and transitions for this frame
+ RestyleManager::AnimationsWithDestroyedFrame* adf =
+ pc->RestyleManager()->GetAnimationsWithDestroyedFrame();
+ // AnimationsWithDestroyedFrame only lives during the restyling process.
+ if (adf) {
+ adf->Put(mContent, mComputedStyle);
+ }
+ }
+
+ // Disable visibility tracking. Note that we have to do this before we clear
+ // frame properties and lose track of whether we were previously visible.
+ // XXX(seth): It'd be ideal to assert that we're already marked nonvisible
+ // here, but it's unfortunately tricky to guarantee in the face of things like
+ // frame reconstruction induced by style changes.
+ DisableVisibilityTracking();
+
+ // Ensure that we're not in the approximately visible list anymore.
+ ps->RemoveFrameFromApproximatelyVisibleList(this);
+
+ ps->NotifyDestroyingFrame(this);
+
+ if (HasAnyStateBits(NS_FRAME_EXTERNAL_REFERENCE)) {
+ ps->ClearFrameRefs(this);
+ }
+
+ nsView* view = GetView();
+ if (view) {
+ view->SetFrame(nullptr);
+ view->Destroy();
+ }
+
+ // Make sure that our deleted frame can't be returned from GetPrimaryFrame()
+ if (IsPrimaryFrame()) {
+ mContent->SetPrimaryFrame(nullptr);
+
+ // Pass the root of a generated content subtree (e.g. ::after/::before) to
+ // aPostDestroyData to unbind it after frame destruction is done.
+ if (HasAnyStateBits(NS_FRAME_GENERATED_CONTENT) &&
+ mContent->IsRootOfNativeAnonymousSubtree()) {
+ aContext.AddAnonymousContent(mContent.forget());
+ }
+ }
+
+ // Remove all properties attached to the frame, to ensure any property
+ // destructors that need the frame pointer are handled properly.
+ RemoveAllProperties();
+
+ // Must retrieve the object ID before calling destructors, so the
+ // vtable is still valid.
+ //
+ // Note to future tweakers: having the method that returns the
+ // object size call the destructor will not avoid an indirect call;
+ // the compiler cannot devirtualize the call to the destructor even
+ // if it's from a method defined in the same class.
+
+ nsQueryFrame::FrameIID id = GetFrameId();
+ this->~nsIFrame();
+
+#ifdef DEBUG
+ {
+ nsIFrame* rootFrame = ps->GetRootFrame();
+ MOZ_ASSERT(rootFrame);
+ if (this != rootFrame) {
+ auto* builder = nsLayoutUtils::GetRetainedDisplayListBuilder(rootFrame);
+ auto* data = builder ? builder->Data() : nullptr;
+
+ const bool inData =
+ data && (data->IsModified(this) || data->HasProps(this));
+
+ if (inData) {
+ DL_LOG(LogLevel::Warning, "Frame %p found in retained data", this);
+ }
+
+ MOZ_ASSERT(!inData, "Deleted frame in retained data!");
+ }
+ }
+#endif
+
+ // Now that we're totally cleaned out, we need to add ourselves to
+ // the presshell's recycler.
+ ps->FreeFrame(id, this);
+}
+
+std::pair<int32_t, int32_t> nsIFrame::GetOffsets() const {
+ return std::make_pair(0, 0);
+}
+
+static void CompareLayers(
+ const nsStyleImageLayers* aFirstLayers,
+ const nsStyleImageLayers* aSecondLayers,
+ const std::function<void(imgRequestProxy* aReq)>& aCallback) {
+ NS_FOR_VISIBLE_IMAGE_LAYERS_BACK_TO_FRONT(i, (*aFirstLayers)) {
+ const auto& image = aFirstLayers->mLayers[i].mImage;
+ if (!image.IsImageRequestType() || !image.IsResolved()) {
+ continue;
+ }
+
+ // aCallback is called when the style image in aFirstLayers is thought to
+ // be different with the corresponded one in aSecondLayers
+ if (!aSecondLayers || i >= aSecondLayers->mImageCount ||
+ (!aSecondLayers->mLayers[i].mImage.IsResolved() ||
+ image.GetImageRequest() !=
+ aSecondLayers->mLayers[i].mImage.GetImageRequest())) {
+ if (imgRequestProxy* req = image.GetImageRequest()) {
+ aCallback(req);
+ }
+ }
+ }
+}
+
+static void AddAndRemoveImageAssociations(
+ ImageLoader& aImageLoader, nsIFrame* aFrame,
+ const nsStyleImageLayers* aOldLayers,
+ const nsStyleImageLayers* aNewLayers) {
+ // If the old context had a background-image image, or mask-image image,
+ // and new context does not have the same image, clear the image load
+ // notifier (which keeps the image loading, if it still is) for the frame.
+ // We want to do this conservatively because some frames paint their
+ // backgrounds from some other frame's style data, and we don't want
+ // to clear those notifiers unless we have to. (They'll be reset
+ // when we paint, although we could miss a notification in that
+ // interval.)
+ if (aOldLayers && aFrame->HasImageRequest()) {
+ CompareLayers(aOldLayers, aNewLayers, [&](imgRequestProxy* aReq) {
+ aImageLoader.DisassociateRequestFromFrame(aReq, aFrame);
+ });
+ }
+
+ CompareLayers(aNewLayers, aOldLayers, [&](imgRequestProxy* aReq) {
+ aImageLoader.AssociateRequestToFrame(aReq, aFrame);
+ });
+}
+
+void nsIFrame::AddDisplayItem(nsDisplayItem* aItem) {
+ MOZ_DIAGNOSTIC_ASSERT(!mDisplayItems.Contains(aItem));
+ mDisplayItems.AppendElement(aItem);
+#ifdef ACCESSIBILITY
+ if (nsAccessibilityService* accService = GetAccService()) {
+ accService->NotifyOfPossibleBoundsChange(PresShell(), mContent);
+ }
+#endif
+}
+
+bool nsIFrame::RemoveDisplayItem(nsDisplayItem* aItem) {
+ return mDisplayItems.RemoveElement(aItem);
+}
+
+bool nsIFrame::HasDisplayItems() { return !mDisplayItems.IsEmpty(); }
+
+bool nsIFrame::HasDisplayItem(nsDisplayItem* aItem) {
+ return mDisplayItems.Contains(aItem);
+}
+
+bool nsIFrame::HasDisplayItem(uint32_t aKey) {
+ for (nsDisplayItem* i : mDisplayItems) {
+ if (i->GetPerFrameKey() == aKey) {
+ return true;
+ }
+ }
+ return false;
+}
+
+template <typename Condition>
+static void DiscardDisplayItems(nsIFrame* aFrame, Condition aCondition) {
+ for (nsDisplayItem* i : aFrame->DisplayItems()) {
+ // Only discard items that are invalidated by this frame, as we're only
+ // guaranteed to rebuild those items. Table background items are created by
+ // the relevant table part, but have the cell frame as the primary frame,
+ // and we don't want to remove them if this is the cell.
+ if (aCondition(i) && i->FrameForInvalidation() == aFrame) {
+ i->SetCantBeReused();
+ }
+ }
+}
+
+static void DiscardOldItems(nsIFrame* aFrame) {
+ DiscardDisplayItems(aFrame,
+ [](nsDisplayItem* aItem) { return aItem->IsOldItem(); });
+}
+
+void nsIFrame::RemoveDisplayItemDataForDeletion() {
+ // Destroying a WebRenderUserDataTable can cause destruction of other objects
+ // which can remove frame properties in their destructor. If we delete a frame
+ // property it runs the destructor of the stored object in the middle of
+ // updating the frame property table, so if the destruction of that object
+ // causes another update to the frame property table it would leave the frame
+ // property table in an inconsistent state. So we remove it from the table and
+ // then destroy it. (bug 1530657)
+ WebRenderUserDataTable* userDataTable =
+ TakeProperty(WebRenderUserDataProperty::Key());
+ if (userDataTable) {
+ for (const auto& data : userDataTable->Values()) {
+ data->RemoveFromTable();
+ }
+ delete userDataTable;
+ }
+
+ if (!nsLayoutUtils::AreRetainedDisplayListsEnabled()) {
+ // Retained display lists are disabled, no need to update
+ // RetainedDisplayListData.
+ return;
+ }
+
+ auto* builder = nsLayoutUtils::GetRetainedDisplayListBuilder(this);
+ if (!builder) {
+ MOZ_ASSERT(DisplayItems().IsEmpty());
+ MOZ_ASSERT(!IsFrameModified());
+ return;
+ }
+
+ for (nsDisplayItem* i : DisplayItems()) {
+ if (i->GetDependentFrame() == this && !i->HasDeletedFrame()) {
+ i->Frame()->MarkNeedsDisplayItemRebuild();
+ }
+ i->RemoveFrame(this);
+ }
+
+ DisplayItems().Clear();
+
+ nsAutoString name;
+#ifdef DEBUG_FRAME_DUMP
+ if (DL_LOG_TEST(LogLevel::Debug)) {
+ GetFrameName(name);
+ }
+#endif
+ DL_LOGV("Removing display item data for frame %p (%s)", this,
+ NS_ConvertUTF16toUTF8(name).get());
+
+ auto* data = builder->Data();
+ if (MayHaveWillChangeBudget()) {
+ // Keep the frame in list, so it can be removed from the will-change budget.
+ data->Flags(this) = RetainedDisplayListData::FrameFlag::HadWillChange;
+ } else {
+ data->Remove(this);
+ }
+}
+
+void nsIFrame::MarkNeedsDisplayItemRebuild() {
+ if (!nsLayoutUtils::AreRetainedDisplayListsEnabled() || IsFrameModified() ||
+ HasAnyStateBits(NS_FRAME_IN_POPUP)) {
+ // Skip frames that are already marked modified.
+ return;
+ }
+
+ if (Type() == LayoutFrameType::Placeholder) {
+ nsIFrame* oof = static_cast<nsPlaceholderFrame*>(this)->GetOutOfFlowFrame();
+ if (oof) {
+ oof->MarkNeedsDisplayItemRebuild();
+ }
+ // Do not mark placeholder frames modified.
+ return;
+ }
+
+#ifdef ACCESSIBILITY
+ if (nsAccessibilityService* accService = GetAccService()) {
+ accService->NotifyOfPossibleBoundsChange(PresShell(), mContent);
+ }
+#endif
+
+ nsIFrame* rootFrame = PresShell()->GetRootFrame();
+
+ if (rootFrame->IsFrameModified()) {
+ // The whole frame tree is modified.
+ return;
+ }
+
+ auto* builder = nsLayoutUtils::GetRetainedDisplayListBuilder(this);
+ if (!builder) {
+ MOZ_ASSERT(DisplayItems().IsEmpty());
+ return;
+ }
+
+ RetainedDisplayListData* data = builder->Data();
+ MOZ_ASSERT(data);
+
+ if (data->AtModifiedFrameLimit()) {
+ // This marks the whole frame tree modified.
+ // See |RetainedDisplayListBuilder::ShouldBuildPartial()|.
+ data->AddModifiedFrame(rootFrame);
+ return;
+ }
+
+ nsAutoString name;
+#ifdef DEBUG_FRAME_DUMP
+ if (DL_LOG_TEST(LogLevel::Debug)) {
+ GetFrameName(name);
+ }
+#endif
+
+ DL_LOGV("RDL - Rebuilding display items for frame %p (%s)", this,
+ NS_ConvertUTF16toUTF8(name).get());
+
+ data->AddModifiedFrame(this);
+
+ MOZ_ASSERT(
+ PresContext()->LayoutPhaseCount(nsLayoutPhase::DisplayListBuilding) == 0);
+
+ // Hopefully this is cheap, but we could use a frame state bit to note
+ // the presence of dependencies to speed it up.
+ for (nsDisplayItem* i : DisplayItems()) {
+ if (i->HasDeletedFrame() || i->Frame() == this) {
+ // Ignore the items with deleted frames, and the items with |this| as
+ // the primary frame.
+ continue;
+ }
+
+ if (i->GetDependentFrame() == this) {
+ // For items with |this| as a dependent frame, mark the primary frame
+ // for rebuild.
+ i->Frame()->MarkNeedsDisplayItemRebuild();
+ }
+ }
+}
+
+// Subclass hook for style post processing
+/* virtual */
+void nsIFrame::DidSetComputedStyle(ComputedStyle* aOldComputedStyle) {
+#ifdef ACCESSIBILITY
+ // Don't notify for reconstructed frames here, since the frame is still being
+ // constructed at this point and so LocalAccessible::GetFrame() will return
+ // null. Style changes for reconstructed frames are handled in
+ // DocAccessible::PruneOrInsertSubtree.
+ if (aOldComputedStyle) {
+ if (nsAccessibilityService* accService = GetAccService()) {
+ accService->NotifyOfComputedStyleChange(PresShell(), mContent);
+ }
+ }
+#endif
+
+ MaybeScheduleReflowSVGNonDisplayText(this);
+
+ Document* doc = PresContext()->Document();
+ ImageLoader* loader = doc->StyleImageLoader();
+ // Continuing text frame doesn't initialize its continuation pointer before
+ // reaching here for the first time, so we have to exclude text frames. This
+ // doesn't affect correctness because text can't match selectors.
+ //
+ // FIXME(emilio): We should consider fixing that.
+ //
+ // TODO(emilio): Can we avoid doing some / all of the image stuff when
+ // isNonTextFirstContinuation is false? We should consider doing this just for
+ // primary frames and pseudos, but the first-line reparenting code makes it
+ // all bad, should get around to bug 1465474 eventually :(
+ const bool isNonText = !IsTextFrame();
+ if (isNonText) {
+ mComputedStyle->StartImageLoads(*doc, aOldComputedStyle);
+ }
+
+ const nsStyleImageLayers* oldLayers =
+ aOldComputedStyle ? &aOldComputedStyle->StyleBackground()->mImage
+ : nullptr;
+ const nsStyleImageLayers* newLayers = &StyleBackground()->mImage;
+ AddAndRemoveImageAssociations(*loader, this, oldLayers, newLayers);
+
+ oldLayers =
+ aOldComputedStyle ? &aOldComputedStyle->StyleSVGReset()->mMask : nullptr;
+ newLayers = &StyleSVGReset()->mMask;
+ AddAndRemoveImageAssociations(*loader, this, oldLayers, newLayers);
+
+ const nsStyleDisplay* disp = StyleDisplay();
+ bool handleStickyChange = false;
+ if (aOldComputedStyle) {
+ // Detect style changes that should trigger a scroll anchor adjustment
+ // suppression.
+ // https://drafts.csswg.org/css-scroll-anchoring/#suppression-triggers
+ bool needAnchorSuppression = false;
+
+ const nsStyleMargin* oldMargin = aOldComputedStyle->StyleMargin();
+ if (oldMargin->mMargin != StyleMargin()->mMargin) {
+ needAnchorSuppression = true;
+ }
+
+ const nsStylePadding* oldPadding = aOldComputedStyle->StylePadding();
+ if (oldPadding->mPadding != StylePadding()->mPadding) {
+ SetHasPaddingChange(true);
+ needAnchorSuppression = true;
+ }
+
+ const nsStyleDisplay* oldDisp = aOldComputedStyle->StyleDisplay();
+ if (oldDisp->mOverflowAnchor != disp->mOverflowAnchor) {
+ if (auto* container = ScrollAnchorContainer::FindFor(this)) {
+ container->InvalidateAnchor();
+ }
+ if (nsIScrollableFrame* scrollableFrame = do_QueryFrame(this)) {
+ scrollableFrame->Anchor()->InvalidateAnchor();
+ }
+ }
+
+ if (mInScrollAnchorChain) {
+ const nsStylePosition* pos = StylePosition();
+ const nsStylePosition* oldPos = aOldComputedStyle->StylePosition();
+ if (!needAnchorSuppression &&
+ (oldPos->mOffset != pos->mOffset || oldPos->mWidth != pos->mWidth ||
+ oldPos->mMinWidth != pos->mMinWidth ||
+ oldPos->mMaxWidth != pos->mMaxWidth ||
+ oldPos->mHeight != pos->mHeight ||
+ oldPos->mMinHeight != pos->mMinHeight ||
+ oldPos->mMaxHeight != pos->mMaxHeight ||
+ oldDisp->mPosition != disp->mPosition ||
+ oldDisp->mTransform != disp->mTransform)) {
+ needAnchorSuppression = true;
+ }
+
+ if (needAnchorSuppression &&
+ StaticPrefs::layout_css_scroll_anchoring_suppressions_enabled()) {
+ ScrollAnchorContainer::FindFor(this)->SuppressAdjustments();
+ }
+ }
+
+ if (disp->mPosition != oldDisp->mPosition) {
+ if (!disp->IsRelativelyOrStickyPositionedStyle() &&
+ oldDisp->IsRelativelyOrStickyPositionedStyle()) {
+ RemoveProperty(NormalPositionProperty());
+ }
+
+ handleStickyChange = disp->mPosition == StylePositionProperty::Sticky ||
+ oldDisp->mPosition == StylePositionProperty::Sticky;
+ }
+ if (disp->mScrollSnapAlign != oldDisp->mScrollSnapAlign) {
+ ScrollSnapUtils::PostPendingResnapFor(this);
+ }
+ if (aOldComputedStyle->IsRootElementStyle() &&
+ disp->mScrollSnapType != oldDisp->mScrollSnapType) {
+ if (nsIScrollableFrame* scrollableFrame =
+ PresShell()->GetRootScrollFrameAsScrollable()) {
+ scrollableFrame->PostPendingResnap();
+ }
+ }
+ if (StyleUIReset()->mMozSubtreeHiddenOnlyVisually &&
+ !aOldComputedStyle->StyleUIReset()->mMozSubtreeHiddenOnlyVisually) {
+ PresShell::ClearMouseCapture(this);
+ }
+ } else { // !aOldComputedStyle
+ handleStickyChange = disp->mPosition == StylePositionProperty::Sticky;
+ }
+
+ if (handleStickyChange && !HasAnyStateBits(NS_FRAME_IS_NONDISPLAY) &&
+ !GetPrevInFlow()) {
+ // Note that we only add first continuations, but we really only
+ // want to add first continuation-or-ib-split-siblings. But since we don't
+ // yet know if we're a later part of a block-in-inline split, we'll just
+ // add later members of a block-in-inline split here, and then
+ // StickyScrollContainer will remove them later.
+ if (auto* ssc =
+ StickyScrollContainer::GetStickyScrollContainerForFrame(this)) {
+ if (disp->mPosition == StylePositionProperty::Sticky) {
+ ssc->AddFrame(this);
+ } else {
+ ssc->RemoveFrame(this);
+ }
+ }
+ }
+
+ imgIRequest* oldBorderImage =
+ aOldComputedStyle
+ ? aOldComputedStyle->StyleBorder()->GetBorderImageRequest()
+ : nullptr;
+ imgIRequest* newBorderImage = StyleBorder()->GetBorderImageRequest();
+ // FIXME (Bug 759996): The following is no longer true.
+ // For border-images, we can't be as conservative (we need to set the
+ // new loaders if there has been any change) since the CalcDifference
+ // call depended on the result of GetComputedBorder() and that result
+ // depends on whether the image has loaded, start the image load now
+ // so that we'll get notified when it completes loading and can do a
+ // restyle. Otherwise, the image might finish loading from the
+ // network before we start listening to its notifications, and then
+ // we'll never know that it's finished loading. Likewise, we want to
+ // do this for freshly-created frames to prevent a similar race if the
+ // image loads between reflow (which can depend on whether the image
+ // is loaded) and paint. We also don't really care about any callers who try
+ // to paint borders with a different style, because they won't have the
+ // correct size for the border either.
+ if (oldBorderImage != newBorderImage) {
+ // stop and restart the image loading/notification
+ if (oldBorderImage && HasImageRequest()) {
+ loader->DisassociateRequestFromFrame(oldBorderImage, this);
+ }
+ if (newBorderImage) {
+ loader->AssociateRequestToFrame(newBorderImage, this);
+ }
+ }
+
+ auto GetShapeImageRequest = [](const ComputedStyle* aStyle) -> imgIRequest* {
+ if (!aStyle) {
+ return nullptr;
+ }
+ auto& shape = aStyle->StyleDisplay()->mShapeOutside;
+ if (!shape.IsImage()) {
+ return nullptr;
+ }
+ return shape.AsImage().GetImageRequest();
+ };
+
+ imgIRequest* oldShapeImage = GetShapeImageRequest(aOldComputedStyle);
+ imgIRequest* newShapeImage = GetShapeImageRequest(Style());
+ if (oldShapeImage != newShapeImage) {
+ if (oldShapeImage && HasImageRequest()) {
+ loader->DisassociateRequestFromFrame(oldShapeImage, this);
+ }
+ if (newShapeImage) {
+ loader->AssociateRequestToFrame(
+ newShapeImage, this,
+ ImageLoader::Flags::
+ RequiresReflowOnFirstFrameCompleteAndLoadEventBlocking);
+ }
+ }
+
+ // SVGObserverUtils::GetEffectProperties() asserts that we only invoke it with
+ // the first continuation so we need to check that in advance.
+ const bool isNonTextFirstContinuation = isNonText && !GetPrevContinuation();
+ if (isNonTextFirstContinuation) {
+ // Kick off loading of external SVG resources referenced from properties if
+ // any. This currently includes filter, clip-path, and mask.
+ SVGObserverUtils::InitiateResourceDocLoads(this);
+ }
+
+ // If the page contains markup that overrides text direction, and
+ // does not contain any characters that would activate the Unicode
+ // bidi algorithm, we need to call |SetBidiEnabled| on the pres
+ // context before reflow starts. See bug 115921.
+ if (StyleVisibility()->mDirection == StyleDirection::Rtl) {
+ PresContext()->SetBidiEnabled();
+ }
+
+ // The following part is for caching offset-path:path(). We cache the
+ // flatten gfx path, so we don't have to rebuild and re-flattern it at
+ // each cycle if we have animations on offset-* with a fixed offset-path.
+ const StyleOffsetPath* oldPath =
+ aOldComputedStyle ? &aOldComputedStyle->StyleDisplay()->mOffsetPath
+ : nullptr;
+ const StyleOffsetPath& newPath = StyleDisplay()->mOffsetPath;
+ if (!oldPath || *oldPath != newPath) {
+ // FIXME: Bug 1837042. Cache all basic shapes.
+ if (newPath.IsPath()) {
+ RefPtr<gfx::PathBuilder> builder = MotionPathUtils::GetPathBuilder();
+ RefPtr<gfx::Path> path =
+ MotionPathUtils::BuildSVGPath(newPath.AsSVGPathData(), builder);
+ if (path) {
+ // The newPath could be path('') (i.e. empty path), so its gfx path
+ // could be nullptr, and so we only set property for a non-empty path.
+ SetProperty(nsIFrame::OffsetPathCache(), path.forget().take());
+ } else {
+ // May have an old cached path, so we have to delete it.
+ RemoveProperty(nsIFrame::OffsetPathCache());
+ }
+ } else if (oldPath) {
+ RemoveProperty(nsIFrame::OffsetPathCache());
+ }
+ }
+
+ if (IsPrimaryFrame()) {
+ MOZ_ASSERT(aOldComputedStyle);
+ HandlePrimaryFrameStyleChange(aOldComputedStyle);
+ }
+
+ RemoveStateBits(NS_FRAME_SIMPLE_EVENT_REGIONS | NS_FRAME_SIMPLE_DISPLAYLIST);
+
+ mMayHaveRoundedCorners = true;
+}
+
+void nsIFrame::HandleLastRememberedSize() {
+ MOZ_ASSERT(IsPrimaryFrame());
+ // Storing a last remembered size requires contain-intrinsic-size, and using
+ // a previously stored last remembered size requires content-visibility.
+ if (!StaticPrefs::layout_css_contain_intrinsic_size_enabled() ||
+ !StaticPrefs::layout_css_content_visibility_enabled()) {
+ return;
+ }
+ auto* element = Element::FromNodeOrNull(mContent);
+ if (!element) {
+ return;
+ }
+ const WritingMode wm = GetWritingMode();
+ const nsStylePosition* stylePos = StylePosition();
+ bool canRememberBSize = stylePos->ContainIntrinsicBSize(wm).HasAuto();
+ bool canRememberISize = stylePos->ContainIntrinsicISize(wm).HasAuto();
+ if (!canRememberBSize) {
+ element->RemoveLastRememberedBSize();
+ }
+ if (!canRememberISize) {
+ element->RemoveLastRememberedISize();
+ }
+ if ((canRememberBSize || canRememberISize) && !HidesContent()) {
+ bool isNonReplacedInline = IsLineParticipant() && !IsReplaced();
+ if (!isNonReplacedInline) {
+ PresContext()->Document()->ObserveForLastRememberedSize(*element);
+ return;
+ }
+ }
+ PresContext()->Document()->UnobserveForLastRememberedSize(*element);
+}
+
+#ifdef MOZ_DIAGNOSTIC_ASSERT_ENABLED
+void nsIFrame::AssertNewStyleIsSane(ComputedStyle& aNewStyle) {
+ MOZ_DIAGNOSTIC_ASSERT(
+ aNewStyle.GetPseudoType() == mComputedStyle->GetPseudoType() ||
+ // ::first-line continuations are weird, this should probably be fixed via
+ // bug 1465474.
+ (mComputedStyle->GetPseudoType() == PseudoStyleType::firstLine &&
+ aNewStyle.GetPseudoType() == PseudoStyleType::mozLineFrame) ||
+ // ::first-letter continuations are broken, in particular floating ones,
+ // see bug 1490281. The construction code tries to fix this up after the
+ // fact, then restyling undoes it...
+ (mComputedStyle->GetPseudoType() == PseudoStyleType::mozText &&
+ aNewStyle.GetPseudoType() == PseudoStyleType::firstLetterContinuation) ||
+ (mComputedStyle->GetPseudoType() ==
+ PseudoStyleType::firstLetterContinuation &&
+ aNewStyle.GetPseudoType() == PseudoStyleType::mozText));
+}
+#endif
+
+void nsIFrame::ReparentFrameViewTo(nsViewManager* aViewManager,
+ nsView* aNewParentView) {
+ if (HasView()) {
+ if (IsMenuPopupFrame()) {
+ // This view must be parented by the root view, don't reparent it.
+ return;
+ }
+ nsView* view = GetView();
+ aViewManager->RemoveChild(view);
+
+ // The view will remember the Z-order and other attributes that have been
+ // set on it.
+ nsView* insertBefore =
+ nsLayoutUtils::FindSiblingViewFor(aNewParentView, this);
+ aViewManager->InsertChild(aNewParentView, view, insertBefore,
+ insertBefore != nullptr);
+ } else if (HasAnyStateBits(NS_FRAME_HAS_CHILD_WITH_VIEW)) {
+ for (const auto& childList : ChildLists()) {
+ // Iterate the child frames, and check each child frame to see if it has
+ // a view
+ for (nsIFrame* child : childList.mList) {
+ child->ReparentFrameViewTo(aViewManager, aNewParentView);
+ }
+ }
+ }
+}
+
+void nsIFrame::SyncFrameViewProperties(nsView* aView) {
+ if (!aView) {
+ aView = GetView();
+ if (!aView) {
+ return;
+ }
+ }
+
+ nsViewManager* vm = aView->GetViewManager();
+
+ // Make sure visibility is correct. This only affects nsSubDocumentFrame.
+ if (!SupportsVisibilityHidden()) {
+ // See if the view should be hidden or visible
+ ComputedStyle* sc = Style();
+ vm->SetViewVisibility(aView, sc->StyleVisibility()->IsVisible()
+ ? ViewVisibility::Show
+ : ViewVisibility::Hide);
+ }
+
+ const auto zIndex = ZIndex();
+ const bool autoZIndex = !zIndex;
+ vm->SetViewZIndex(aView, autoZIndex, zIndex.valueOr(0));
+}
+
+void nsIFrame::CreateView() {
+ MOZ_ASSERT(!HasView());
+
+ nsView* parentView = GetParent()->GetClosestView();
+ MOZ_ASSERT(parentView, "no parent with view");
+
+ nsViewManager* viewManager = parentView->GetViewManager();
+ MOZ_ASSERT(viewManager, "null view manager");
+
+ nsView* view = viewManager->CreateView(GetRect(), parentView);
+ SyncFrameViewProperties(view);
+
+ nsView* insertBefore = nsLayoutUtils::FindSiblingViewFor(parentView, this);
+ // we insert this view 'above' the insertBefore view, unless insertBefore is
+ // null, in which case we want to call with aAbove == false to insert at the
+ // beginning in document order
+ viewManager->InsertChild(parentView, view, insertBefore,
+ insertBefore != nullptr);
+
+ // REVIEW: Don't create a widget for fixed-pos elements anymore.
+ // ComputeRepaintRegionForCopy will calculate the right area to repaint
+ // when we scroll.
+ // Reparent views on any child frames (or their descendants) to this
+ // view. We can just call ReparentFrameViewTo on this frame because
+ // we know this frame has no view, so it will crawl the children. Also,
+ // we know that any descendants with views must have 'parentView' as their
+ // parent view.
+ ReparentFrameViewTo(viewManager, view);
+
+ // Remember our view
+ SetView(view);
+
+ NS_FRAME_LOG(NS_FRAME_TRACE_CALLS,
+ ("nsIFrame::CreateView: frame=%p view=%p", this, view));
+}
+
+/* virtual */
+nsMargin nsIFrame::GetUsedMargin() const {
+ nsMargin margin;
+ if (((mState & NS_FRAME_FIRST_REFLOW) && !(mState & NS_FRAME_IN_REFLOW)) ||
+ IsInSVGTextSubtree()) {
+ return margin;
+ }
+
+ if (nsMargin* m = GetProperty(UsedMarginProperty())) {
+ margin = *m;
+ } else if (!StyleMargin()->GetMargin(margin)) {
+ // If we get here, our caller probably shouldn't be calling us...
+ NS_ERROR(
+ "Returning bogus 0-sized margin, because this margin "
+ "depends on layout & isn't cached!");
+ }
+ return margin;
+}
+
+/* virtual */
+nsMargin nsIFrame::GetUsedBorder() const {
+ if (((mState & NS_FRAME_FIRST_REFLOW) && !(mState & NS_FRAME_IN_REFLOW)) ||
+ IsInSVGTextSubtree()) {
+ return {};
+ }
+
+ const nsStyleDisplay* disp = StyleDisplay();
+ if (IsThemed(disp)) {
+ // Theme methods don't use const-ness.
+ auto* mutable_this = const_cast<nsIFrame*>(this);
+ nsPresContext* pc = PresContext();
+ LayoutDeviceIntMargin widgetBorder = pc->Theme()->GetWidgetBorder(
+ pc->DeviceContext(), mutable_this, disp->EffectiveAppearance());
+ return LayoutDevicePixel::ToAppUnits(widgetBorder,
+ pc->AppUnitsPerDevPixel());
+ }
+
+ return StyleBorder()->GetComputedBorder();
+}
+
+/* virtual */
+nsMargin nsIFrame::GetUsedPadding() const {
+ nsMargin padding;
+ if (((mState & NS_FRAME_FIRST_REFLOW) && !(mState & NS_FRAME_IN_REFLOW)) ||
+ IsInSVGTextSubtree()) {
+ return padding;
+ }
+
+ const nsStyleDisplay* disp = StyleDisplay();
+ if (IsThemed(disp)) {
+ // Theme methods don't use const-ness.
+ nsIFrame* mutable_this = const_cast<nsIFrame*>(this);
+ nsPresContext* pc = PresContext();
+ LayoutDeviceIntMargin widgetPadding;
+ if (pc->Theme()->GetWidgetPadding(pc->DeviceContext(), mutable_this,
+ disp->EffectiveAppearance(),
+ &widgetPadding)) {
+ return LayoutDevicePixel::ToAppUnits(widgetPadding,
+ pc->AppUnitsPerDevPixel());
+ }
+ }
+
+ if (nsMargin* p = GetProperty(UsedPaddingProperty())) {
+ padding = *p;
+ } else if (!StylePadding()->GetPadding(padding)) {
+ // If we get here, our caller probably shouldn't be calling us...
+ NS_ERROR(
+ "Returning bogus 0-sized padding, because this padding "
+ "depends on layout & isn't cached!");
+ }
+ return padding;
+}
+
+nsIFrame::Sides nsIFrame::GetSkipSides() const {
+ if (MOZ_UNLIKELY(StyleBorder()->mBoxDecorationBreak ==
+ StyleBoxDecorationBreak::Clone) &&
+ !HasAnyStateBits(NS_FRAME_IS_OVERFLOW_CONTAINER)) {
+ return Sides();
+ }
+
+ // Convert the logical skip sides to physical sides using the frame's
+ // writing mode
+ WritingMode writingMode = GetWritingMode();
+ LogicalSides logicalSkip = GetLogicalSkipSides();
+ Sides skip;
+
+ if (logicalSkip.BStart()) {
+ if (writingMode.IsVertical()) {
+ skip |= writingMode.IsVerticalLR() ? SideBits::eLeft : SideBits::eRight;
+ } else {
+ skip |= SideBits::eTop;
+ }
+ }
+
+ if (logicalSkip.BEnd()) {
+ if (writingMode.IsVertical()) {
+ skip |= writingMode.IsVerticalLR() ? SideBits::eRight : SideBits::eLeft;
+ } else {
+ skip |= SideBits::eBottom;
+ }
+ }
+
+ if (logicalSkip.IStart()) {
+ if (writingMode.IsVertical()) {
+ skip |= SideBits::eTop;
+ } else {
+ skip |= writingMode.IsBidiLTR() ? SideBits::eLeft : SideBits::eRight;
+ }
+ }
+
+ if (logicalSkip.IEnd()) {
+ if (writingMode.IsVertical()) {
+ skip |= SideBits::eBottom;
+ } else {
+ skip |= writingMode.IsBidiLTR() ? SideBits::eRight : SideBits::eLeft;
+ }
+ }
+ return skip;
+}
+
+nsRect nsIFrame::GetPaddingRectRelativeToSelf() const {
+ nsMargin border = GetUsedBorder().ApplySkipSides(GetSkipSides());
+ nsRect r(0, 0, mRect.width, mRect.height);
+ r.Deflate(border);
+ return r;
+}
+
+nsRect nsIFrame::GetPaddingRect() const {
+ return GetPaddingRectRelativeToSelf() + GetPosition();
+}
+
+WritingMode nsIFrame::WritingModeForLine(WritingMode aSelfWM,
+ nsIFrame* aSubFrame) const {
+ MOZ_ASSERT(aSelfWM == GetWritingMode());
+ WritingMode writingMode = aSelfWM;
+
+ if (StyleTextReset()->mUnicodeBidi == StyleUnicodeBidi::Plaintext) {
+ mozilla::intl::BidiEmbeddingLevel frameLevel =
+ nsBidiPresUtils::GetFrameBaseLevel(aSubFrame);
+ writingMode.SetDirectionFromBidiLevel(frameLevel);
+ }
+
+ return writingMode;
+}
+
+nsRect nsIFrame::GetMarginRect() const {
+ return GetMarginRectRelativeToSelf() + GetPosition();
+}
+
+nsRect nsIFrame::GetMarginRectRelativeToSelf() const {
+ nsMargin m = GetUsedMargin().ApplySkipSides(GetSkipSides());
+ nsRect r(0, 0, mRect.width, mRect.height);
+ r.Inflate(m);
+ return r;
+}
+
+bool nsIFrame::IsTransformed() const {
+ if (!HasAnyStateBits(NS_FRAME_MAY_BE_TRANSFORMED)) {
+ MOZ_ASSERT(!IsCSSTransformed());
+ MOZ_ASSERT(!IsSVGTransformed());
+ return false;
+ }
+ return IsCSSTransformed() || IsSVGTransformed();
+}
+
+bool nsIFrame::IsCSSTransformed() const {
+ return HasAnyStateBits(NS_FRAME_MAY_BE_TRANSFORMED) &&
+ (StyleDisplay()->HasTransform(this) || HasAnimationOfTransform());
+}
+
+bool nsIFrame::HasAnimationOfTransform() const {
+ return IsPrimaryFrame() &&
+ nsLayoutUtils::HasAnimationOfTransformAndMotionPath(this) &&
+ SupportsCSSTransforms();
+}
+
+bool nsIFrame::ChildrenHavePerspective(
+ const nsStyleDisplay* aStyleDisplay) const {
+ MOZ_ASSERT(aStyleDisplay == StyleDisplay());
+ return aStyleDisplay->HasPerspective(this);
+}
+
+bool nsIFrame::HasAnimationOfOpacity(EffectSet* aEffectSet) const {
+ return ((nsLayoutUtils::IsPrimaryStyleFrame(this) ||
+ nsLayoutUtils::FirstContinuationOrIBSplitSibling(this)
+ ->IsPrimaryFrame()) &&
+ nsLayoutUtils::HasAnimationOfPropertySet(
+ this, nsCSSPropertyIDSet::OpacityProperties(), aEffectSet));
+}
+
+bool nsIFrame::HasOpacityInternal(float aThreshold,
+ const nsStyleDisplay* aStyleDisplay,
+ const nsStyleEffects* aStyleEffects,
+ EffectSet* aEffectSet) const {
+ MOZ_ASSERT(0.0 <= aThreshold && aThreshold <= 1.0, "Invalid argument");
+ if (aStyleEffects->mOpacity < aThreshold ||
+ aStyleDisplay->mWillChange.bits & StyleWillChangeBits::OPACITY) {
+ return true;
+ }
+
+ if (!mMayHaveOpacityAnimation) {
+ return false;
+ }
+
+ return HasAnimationOfOpacity(aEffectSet);
+}
+
+bool nsIFrame::IsSVGTransformed(gfx::Matrix* aOwnTransforms,
+ gfx::Matrix* aFromParentTransforms) const {
+ return false;
+}
+
+bool nsIFrame::Extend3DContext(const nsStyleDisplay* aStyleDisplay,
+ const nsStyleEffects* aStyleEffects,
+ mozilla::EffectSet* aEffectSetForOpacity) const {
+ if (!HasAnyStateBits(NS_FRAME_MAY_BE_TRANSFORMED)) {
+ return false;
+ }
+ const nsStyleDisplay* disp = StyleDisplayWithOptionalParam(aStyleDisplay);
+ if (disp->mTransformStyle != StyleTransformStyle::Preserve3d ||
+ !SupportsCSSTransforms()) {
+ return false;
+ }
+
+ // If we're all scroll frame, then all descendants will be clipped, so we
+ // can't preserve 3d.
+ if (IsScrollFrame()) {
+ return false;
+ }
+
+ const nsStyleEffects* effects = StyleEffectsWithOptionalParam(aStyleEffects);
+ if (HasOpacity(disp, effects, aEffectSetForOpacity)) {
+ return false;
+ }
+
+ return ShouldApplyOverflowClipping(disp) == PhysicalAxes::None &&
+ !GetClipPropClipRect(disp, effects, GetSize()) &&
+ !SVGIntegrationUtils::UsingEffectsForFrame(this) &&
+ !effects->HasMixBlendMode() &&
+ disp->mIsolation != StyleIsolation::Isolate;
+}
+
+bool nsIFrame::Combines3DTransformWithAncestors() const {
+ // Check these first as they are faster then both calls below and are we are
+ // likely to hit the early return (backface hidden is uncommon and
+ // GetReferenceFrame is a hot caller of this which only calls this if
+ // IsCSSTransformed is false).
+ if (!IsCSSTransformed() && !BackfaceIsHidden()) {
+ return false;
+ }
+ nsIFrame* parent = GetClosestFlattenedTreeAncestorPrimaryFrame();
+ return parent && parent->Extend3DContext();
+}
+
+bool nsIFrame::In3DContextAndBackfaceIsHidden() const {
+ // While both tests fail most of the time, test BackfaceIsHidden()
+ // first since it's likely to fail faster.
+ return BackfaceIsHidden() && Combines3DTransformWithAncestors();
+}
+
+bool nsIFrame::HasPerspective() const {
+ if (!IsCSSTransformed()) {
+ return false;
+ }
+ nsIFrame* parent = GetClosestFlattenedTreeAncestorPrimaryFrame();
+ if (!parent) {
+ return false;
+ }
+ return parent->ChildrenHavePerspective();
+}
+
+nsRect nsIFrame::GetContentRectRelativeToSelf() const {
+ nsMargin bp = GetUsedBorderAndPadding().ApplySkipSides(GetSkipSides());
+ nsRect r(0, 0, mRect.width, mRect.height);
+ r.Deflate(bp);
+ return r;
+}
+
+nsRect nsIFrame::GetContentRect() const {
+ return GetContentRectRelativeToSelf() + GetPosition();
+}
+
+bool nsIFrame::ComputeBorderRadii(const BorderRadius& aBorderRadius,
+ const nsSize& aFrameSize,
+ const nsSize& aBorderArea, Sides aSkipSides,
+ nscoord aRadii[8]) {
+ // Percentages are relative to whichever side they're on.
+ for (const auto i : mozilla::AllPhysicalHalfCorners()) {
+ const LengthPercentage& c = aBorderRadius.Get(i);
+ nscoord axis = HalfCornerIsX(i) ? aFrameSize.width : aFrameSize.height;
+ aRadii[i] = std::max(0, c.Resolve(axis));
+ }
+
+ if (aSkipSides.Top()) {
+ aRadii[eCornerTopLeftX] = 0;
+ aRadii[eCornerTopLeftY] = 0;
+ aRadii[eCornerTopRightX] = 0;
+ aRadii[eCornerTopRightY] = 0;
+ }
+
+ if (aSkipSides.Right()) {
+ aRadii[eCornerTopRightX] = 0;
+ aRadii[eCornerTopRightY] = 0;
+ aRadii[eCornerBottomRightX] = 0;
+ aRadii[eCornerBottomRightY] = 0;
+ }
+
+ if (aSkipSides.Bottom()) {
+ aRadii[eCornerBottomRightX] = 0;
+ aRadii[eCornerBottomRightY] = 0;
+ aRadii[eCornerBottomLeftX] = 0;
+ aRadii[eCornerBottomLeftY] = 0;
+ }
+
+ if (aSkipSides.Left()) {
+ aRadii[eCornerBottomLeftX] = 0;
+ aRadii[eCornerBottomLeftY] = 0;
+ aRadii[eCornerTopLeftX] = 0;
+ aRadii[eCornerTopLeftY] = 0;
+ }
+
+ // css3-background specifies this algorithm for reducing
+ // corner radii when they are too big.
+ bool haveRadius = false;
+ double ratio = 1.0f;
+ for (const auto side : mozilla::AllPhysicalSides()) {
+ uint32_t hc1 = SideToHalfCorner(side, false, true);
+ uint32_t hc2 = SideToHalfCorner(side, true, true);
+ nscoord length =
+ SideIsVertical(side) ? aBorderArea.height : aBorderArea.width;
+ nscoord sum = aRadii[hc1] + aRadii[hc2];
+ if (sum) {
+ haveRadius = true;
+ // avoid floating point division in the normal case
+ if (length < sum) {
+ ratio = std::min(ratio, double(length) / sum);
+ }
+ }
+ }
+ if (ratio < 1.0) {
+ for (const auto corner : mozilla::AllPhysicalHalfCorners()) {
+ aRadii[corner] *= ratio;
+ }
+ }
+
+ return haveRadius;
+}
+
+void nsIFrame::AdjustBorderRadii(nscoord aRadii[8], const nsMargin& aOffsets) {
+ auto AdjustOffset = [](const uint32_t aRadius, const nscoord aOffset) {
+ // Implement the cubic formula to adjust offset when aOffset > 0 and
+ // aRadius / aOffset < 1.
+ // https://drafts.csswg.org/css-shapes/#valdef-shape-box-margin-box
+ if (aOffset > 0) {
+ const double ratio = aRadius / double(aOffset);
+ if (ratio < 1.0) {
+ return nscoord(aOffset * (1.0 + std::pow(ratio - 1, 3)));
+ }
+ }
+ return aOffset;
+ };
+
+ for (const auto side : mozilla::AllPhysicalSides()) {
+ const nscoord offset = aOffsets.Side(side);
+ const uint32_t hc1 = SideToHalfCorner(side, false, false);
+ const uint32_t hc2 = SideToHalfCorner(side, true, false);
+ if (aRadii[hc1] > 0) {
+ const nscoord offset1 = AdjustOffset(aRadii[hc1], offset);
+ aRadii[hc1] = std::max(0, aRadii[hc1] + offset1);
+ }
+ if (aRadii[hc2] > 0) {
+ const nscoord offset2 = AdjustOffset(aRadii[hc2], offset);
+ aRadii[hc2] = std::max(0, aRadii[hc2] + offset2);
+ }
+ }
+}
+
+static inline bool RadiiAreDefinitelyZero(const BorderRadius& aBorderRadius) {
+ for (const auto corner : mozilla::AllPhysicalHalfCorners()) {
+ if (!aBorderRadius.Get(corner).IsDefinitelyZero()) {
+ return false;
+ }
+ }
+ return true;
+}
+
+/* virtual */
+bool nsIFrame::GetBorderRadii(const nsSize& aFrameSize,
+ const nsSize& aBorderArea, Sides aSkipSides,
+ nscoord aRadii[8]) const {
+ if (!mMayHaveRoundedCorners) {
+ memset(aRadii, 0, sizeof(nscoord) * 8);
+ return false;
+ }
+
+ if (IsThemed()) {
+ // When we're themed, the native theme code draws the border and
+ // background, and therefore it doesn't make sense to tell other
+ // code that's interested in border-radius that we have any radii.
+ //
+ // In an ideal world, we might have a way for the them to tell us an
+ // border radius, but since we don't, we're better off assuming
+ // zero.
+ for (const auto corner : mozilla::AllPhysicalHalfCorners()) {
+ aRadii[corner] = 0;
+ }
+ return false;
+ }
+
+ const auto& radii = StyleBorder()->mBorderRadius;
+ const bool hasRadii =
+ ComputeBorderRadii(radii, aFrameSize, aBorderArea, aSkipSides, aRadii);
+ if (!hasRadii) {
+ // TODO(emilio): Maybe we can just remove this bit and do the
+ // IsDefinitelyZero check unconditionally. That should still avoid most of
+ // the work, though maybe not the cache miss of going through the style and
+ // the border struct.
+ const_cast<nsIFrame*>(this)->mMayHaveRoundedCorners =
+ !RadiiAreDefinitelyZero(radii);
+ }
+ return hasRadii;
+}
+
+bool nsIFrame::GetBorderRadii(nscoord aRadii[8]) const {
+ nsSize sz = GetSize();
+ return GetBorderRadii(sz, sz, GetSkipSides(), aRadii);
+}
+
+bool nsIFrame::GetMarginBoxBorderRadii(nscoord aRadii[8]) const {
+ return GetBoxBorderRadii(aRadii, GetUsedMargin());
+}
+
+bool nsIFrame::GetPaddingBoxBorderRadii(nscoord aRadii[8]) const {
+ return GetBoxBorderRadii(aRadii, -GetUsedBorder());
+}
+
+bool nsIFrame::GetContentBoxBorderRadii(nscoord aRadii[8]) const {
+ return GetBoxBorderRadii(aRadii, -GetUsedBorderAndPadding());
+}
+
+bool nsIFrame::GetBoxBorderRadii(nscoord aRadii[8],
+ const nsMargin& aOffsets) const {
+ if (!GetBorderRadii(aRadii)) {
+ return false;
+ }
+ AdjustBorderRadii(aRadii, aOffsets);
+ for (const auto corner : mozilla::AllPhysicalHalfCorners()) {
+ if (aRadii[corner]) {
+ return true;
+ }
+ }
+ return false;
+}
+
+bool nsIFrame::GetShapeBoxBorderRadii(nscoord aRadii[8]) const {
+ using Tag = StyleShapeOutside::Tag;
+ auto& shapeOutside = StyleDisplay()->mShapeOutside;
+ auto box = StyleShapeBox::MarginBox;
+ switch (shapeOutside.tag) {
+ case Tag::Image:
+ case Tag::None:
+ return false;
+ case Tag::Box:
+ box = shapeOutside.AsBox();
+ break;
+ case Tag::Shape:
+ box = shapeOutside.AsShape()._1;
+ break;
+ }
+
+ switch (box) {
+ case StyleShapeBox::ContentBox:
+ return GetContentBoxBorderRadii(aRadii);
+ case StyleShapeBox::PaddingBox:
+ return GetPaddingBoxBorderRadii(aRadii);
+ case StyleShapeBox::BorderBox:
+ return GetBorderRadii(aRadii);
+ case StyleShapeBox::MarginBox:
+ return GetMarginBoxBorderRadii(aRadii);
+ default:
+ MOZ_ASSERT_UNREACHABLE("Unexpected box value");
+ return false;
+ }
+}
+
+ComputedStyle* nsIFrame::GetAdditionalComputedStyle(int32_t aIndex) const {
+ MOZ_ASSERT(aIndex >= 0, "invalid index number");
+ return nullptr;
+}
+
+void nsIFrame::SetAdditionalComputedStyle(int32_t aIndex,
+ ComputedStyle* aComputedStyle) {
+ MOZ_ASSERT(aIndex >= 0, "invalid index number");
+}
+
+nscoord nsIFrame::SynthesizeFallbackBaseline(
+ WritingMode aWM, BaselineSharingGroup aBaselineGroup) const {
+ const auto margin = GetLogicalUsedMargin(aWM);
+ NS_ASSERTION(!IsSubtreeDirty(), "frame must not be dirty");
+ if (aWM.IsCentralBaseline()) {
+ return (BSize(aWM) + GetLogicalUsedMargin(aWM).BEnd(aWM)) / 2;
+ }
+ // Baseline for inverted line content is the top (block-start) margin edge,
+ // as the frame is in effect "flipped" for alignment purposes.
+ if (aWM.IsLineInverted()) {
+ const auto marginStart = margin.BStart(aWM);
+ return aBaselineGroup == BaselineSharingGroup::First
+ ? -marginStart
+ : BSize(aWM) + marginStart;
+ }
+ // Otherwise, the bottom margin edge, per CSS2.1's definition of the
+ // 'baseline' value of 'vertical-align'.
+ const auto marginEnd = margin.BEnd(aWM);
+ return aBaselineGroup == BaselineSharingGroup::First ? BSize(aWM) + marginEnd
+ : -marginEnd;
+}
+
+nscoord nsIFrame::GetLogicalBaseline(WritingMode aWM) const {
+ return GetLogicalBaseline(aWM, GetDefaultBaselineSharingGroup(),
+ BaselineExportContext::LineLayout);
+}
+
+nscoord nsIFrame::GetLogicalBaseline(
+ WritingMode aWM, BaselineSharingGroup aBaselineGroup,
+ BaselineExportContext aExportContext) const {
+ const auto result =
+ GetNaturalBaselineBOffset(aWM, aBaselineGroup, aExportContext)
+ .valueOrFrom([this, aWM, aBaselineGroup]() {
+ return SynthesizeFallbackBaseline(aWM, aBaselineGroup);
+ });
+ if (aBaselineGroup == BaselineSharingGroup::Last) {
+ return BSize(aWM) - result;
+ }
+ return result;
+}
+
+const nsFrameList& nsIFrame::GetChildList(ChildListID aListID) const {
+ if (IsAbsoluteContainer() && aListID == GetAbsoluteListID()) {
+ return GetAbsoluteContainingBlock()->GetChildList();
+ } else {
+ return nsFrameList::EmptyList();
+ }
+}
+
+void nsIFrame::GetChildLists(nsTArray<ChildList>* aLists) const {
+ if (IsAbsoluteContainer()) {
+ const nsFrameList& absoluteList =
+ GetAbsoluteContainingBlock()->GetChildList();
+ absoluteList.AppendIfNonempty(aLists, GetAbsoluteListID());
+ }
+}
+
+AutoTArray<nsIFrame::ChildList, 4> nsIFrame::CrossDocChildLists() {
+ AutoTArray<ChildList, 4> childLists;
+ nsSubDocumentFrame* subdocumentFrame = do_QueryFrame(this);
+ if (subdocumentFrame) {
+ // Descend into the subdocument
+ nsIFrame* root = subdocumentFrame->GetSubdocumentRootFrame();
+ if (root) {
+ childLists.EmplaceBack(
+ nsFrameList(root, nsLayoutUtils::GetLastSibling(root)),
+ FrameChildListID::Principal);
+ }
+ }
+
+ GetChildLists(&childLists);
+ return childLists;
+}
+
+nsIFrame::CaretBlockAxisMetrics nsIFrame::GetCaretBlockAxisMetrics(
+ mozilla::WritingMode aWM, const nsFontMetrics& aFM) const {
+ // Note(dshin): Ultimately, this does something highly similar (But still
+ // different) to `nsLayoutUtils::GetFirstLinePosition`.
+ const auto baseline = GetCaretBaseline();
+ nscoord ascent = 0, descent = 0;
+ ascent = aFM.MaxAscent();
+ descent = aFM.MaxDescent();
+ const nscoord height = ascent + descent;
+ if (aWM.IsVertical() && aWM.IsLineInverted()) {
+ return CaretBlockAxisMetrics{.mOffset = baseline - descent,
+ .mExtent = height};
+ }
+ return CaretBlockAxisMetrics{.mOffset = baseline - ascent, .mExtent = height};
+}
+
+const nsAtom* nsIFrame::ComputePageValue() const {
+ const nsAtom* value = nsGkAtoms::_empty;
+ const nsIFrame* frame = this;
+ // Find what CSS page name value this frame's subtree has, if any.
+ // Starting with this frame, check if a page name other than auto is present,
+ // and record it if so. Then, if the current frame is a container frame, find
+ // the first non-placeholder child and repeat.
+ // This will find the most deeply nested first in-flow child of this frame's
+ // subtree, and return its page name (with auto resolved if applicable, and
+ // subtrees with no page-names returning the empty atom rather than null).
+ do {
+ if (const nsAtom* maybePageName = frame->GetStylePageName()) {
+ value = maybePageName;
+ }
+ // Get the next frame to read from.
+ const nsIFrame* firstNonPlaceholderFrame = nullptr;
+ // If this is a container frame, inspect its in-flow children.
+ if (const nsContainerFrame* containerFrame = do_QueryFrame(frame)) {
+ for (const nsIFrame* childFrame : containerFrame->PrincipalChildList()) {
+ if (!childFrame->IsPlaceholderFrame()) {
+ firstNonPlaceholderFrame = childFrame;
+ break;
+ }
+ }
+ }
+ frame = firstNonPlaceholderFrame;
+ } while (frame);
+ return value;
+}
+
+Visibility nsIFrame::GetVisibility() const {
+ if (!HasAnyStateBits(NS_FRAME_VISIBILITY_IS_TRACKED)) {
+ return Visibility::Untracked;
+ }
+
+ bool isSet = false;
+ uint32_t visibleCount = GetProperty(VisibilityStateProperty(), &isSet);
+
+ MOZ_ASSERT(isSet,
+ "Should have a VisibilityStateProperty value "
+ "if NS_FRAME_VISIBILITY_IS_TRACKED is set");
+
+ return visibleCount > 0 ? Visibility::ApproximatelyVisible
+ : Visibility::ApproximatelyNonVisible;
+}
+
+void nsIFrame::UpdateVisibilitySynchronously() {
+ mozilla::PresShell* presShell = PresShell();
+ if (!presShell) {
+ return;
+ }
+
+ if (presShell->AssumeAllFramesVisible()) {
+ presShell->EnsureFrameInApproximatelyVisibleList(this);
+ return;
+ }
+
+ bool visible = StyleVisibility()->IsVisible();
+ nsIFrame* f = GetParent();
+ nsRect rect = GetRectRelativeToSelf();
+ nsIFrame* rectFrame = this;
+ while (f && visible) {
+ nsIScrollableFrame* sf = do_QueryFrame(f);
+ if (sf) {
+ nsRect transformedRect =
+ nsLayoutUtils::TransformFrameRectToAncestor(rectFrame, rect, f);
+ if (!sf->IsRectNearlyVisible(transformedRect)) {
+ visible = false;
+ break;
+ }
+
+ // In this code we're trying to synchronously update *approximate*
+ // visibility. (In the future we may update precise visibility here as
+ // well, which is why the method name does not contain 'approximate'.) The
+ // IsRectNearlyVisible() check above tells us that the rect we're checking
+ // is approximately visible within the scrollframe, but we still need to
+ // ensure that, even if it was scrolled into view, it'd be visible when we
+ // consider the rest of the document. To do that, we move transformedRect
+ // to be contained in the scrollport as best we can (it might not fit) to
+ // pretend that it was scrolled into view.
+ rect = transformedRect.MoveInsideAndClamp(sf->GetScrollPortRect());
+ rectFrame = f;
+ }
+ nsIFrame* parent = f->GetParent();
+ if (!parent) {
+ parent = nsLayoutUtils::GetCrossDocParentFrameInProcess(f);
+ if (parent && parent->PresContext()->IsChrome()) {
+ break;
+ }
+ }
+ f = parent;
+ }
+
+ if (visible) {
+ presShell->EnsureFrameInApproximatelyVisibleList(this);
+ } else {
+ presShell->RemoveFrameFromApproximatelyVisibleList(this);
+ }
+}
+
+void nsIFrame::EnableVisibilityTracking() {
+ if (HasAnyStateBits(NS_FRAME_VISIBILITY_IS_TRACKED)) {
+ return; // Nothing to do.
+ }
+
+ MOZ_ASSERT(!HasProperty(VisibilityStateProperty()),
+ "Shouldn't have a VisibilityStateProperty value "
+ "if NS_FRAME_VISIBILITY_IS_TRACKED is not set");
+
+ // Add the state bit so we know to track visibility for this frame, and
+ // initialize the frame property.
+ AddStateBits(NS_FRAME_VISIBILITY_IS_TRACKED);
+ SetProperty(VisibilityStateProperty(), 0);
+
+ mozilla::PresShell* presShell = PresShell();
+ if (!presShell) {
+ return;
+ }
+
+ // Schedule a visibility update. This method will virtually always be called
+ // when layout has changed anyway, so it's very unlikely that any additional
+ // visibility updates will be triggered by this, but this way we guarantee
+ // that if this frame is currently visible we'll eventually find out.
+ presShell->ScheduleApproximateFrameVisibilityUpdateSoon();
+}
+
+void nsIFrame::DisableVisibilityTracking() {
+ if (!HasAnyStateBits(NS_FRAME_VISIBILITY_IS_TRACKED)) {
+ return; // Nothing to do.
+ }
+
+ bool isSet = false;
+ uint32_t visibleCount = TakeProperty(VisibilityStateProperty(), &isSet);
+
+ MOZ_ASSERT(isSet,
+ "Should have a VisibilityStateProperty value "
+ "if NS_FRAME_VISIBILITY_IS_TRACKED is set");
+
+ RemoveStateBits(NS_FRAME_VISIBILITY_IS_TRACKED);
+
+ if (visibleCount == 0) {
+ return; // We were nonvisible.
+ }
+
+ // We were visible, so send an OnVisibilityChange() notification.
+ OnVisibilityChange(Visibility::ApproximatelyNonVisible);
+}
+
+void nsIFrame::DecApproximateVisibleCount(
+ const Maybe<OnNonvisible>& aNonvisibleAction
+ /* = Nothing() */) {
+ MOZ_ASSERT(HasAnyStateBits(NS_FRAME_VISIBILITY_IS_TRACKED));
+
+ bool isSet = false;
+ uint32_t visibleCount = GetProperty(VisibilityStateProperty(), &isSet);
+
+ MOZ_ASSERT(isSet,
+ "Should have a VisibilityStateProperty value "
+ "if NS_FRAME_VISIBILITY_IS_TRACKED is set");
+ MOZ_ASSERT(visibleCount > 0,
+ "Frame is already nonvisible and we're "
+ "decrementing its visible count?");
+
+ visibleCount--;
+ SetProperty(VisibilityStateProperty(), visibleCount);
+ if (visibleCount > 0) {
+ return;
+ }
+
+ // We just became nonvisible, so send an OnVisibilityChange() notification.
+ OnVisibilityChange(Visibility::ApproximatelyNonVisible, aNonvisibleAction);
+}
+
+void nsIFrame::IncApproximateVisibleCount() {
+ MOZ_ASSERT(HasAnyStateBits(NS_FRAME_VISIBILITY_IS_TRACKED));
+
+ bool isSet = false;
+ uint32_t visibleCount = GetProperty(VisibilityStateProperty(), &isSet);
+
+ MOZ_ASSERT(isSet,
+ "Should have a VisibilityStateProperty value "
+ "if NS_FRAME_VISIBILITY_IS_TRACKED is set");
+
+ visibleCount++;
+ SetProperty(VisibilityStateProperty(), visibleCount);
+ if (visibleCount > 1) {
+ return;
+ }
+
+ // We just became visible, so send an OnVisibilityChange() notification.
+ OnVisibilityChange(Visibility::ApproximatelyVisible);
+}
+
+void nsIFrame::OnVisibilityChange(Visibility aNewVisibility,
+ const Maybe<OnNonvisible>& aNonvisibleAction
+ /* = Nothing() */) {
+ // XXX(seth): In bug 1218990 we'll implement visibility tracking for CSS
+ // images here.
+}
+
+static nsIFrame* GetActiveSelectionFrame(nsPresContext* aPresContext,
+ nsIFrame* aFrame) {
+ nsIContent* capturingContent = PresShell::GetCapturingContent();
+ if (capturingContent) {
+ nsIFrame* activeFrame = aPresContext->GetPrimaryFrameFor(capturingContent);
+ return activeFrame ? activeFrame : aFrame;
+ }
+
+ return aFrame;
+}
+
+int16_t nsIFrame::DetermineDisplaySelection() {
+ int16_t selType = nsISelectionController::SELECTION_OFF;
+
+ nsCOMPtr<nsISelectionController> selCon;
+ nsresult result =
+ GetSelectionController(PresContext(), getter_AddRefs(selCon));
+ if (NS_SUCCEEDED(result) && selCon) {
+ result = selCon->GetDisplaySelection(&selType);
+ if (NS_SUCCEEDED(result) &&
+ (selType != nsISelectionController::SELECTION_OFF)) {
+ // Check whether style allows selection.
+ if (!IsSelectable(nullptr)) {
+ selType = nsISelectionController::SELECTION_OFF;
+ }
+ }
+ }
+ return selType;
+}
+
+static Element* FindElementAncestorForMozSelection(nsIContent* aContent) {
+ NS_ENSURE_TRUE(aContent, nullptr);
+ while (aContent && aContent->IsInNativeAnonymousSubtree()) {
+ aContent = aContent->GetClosestNativeAnonymousSubtreeRootParentOrHost();
+ }
+ NS_ASSERTION(aContent, "aContent isn't in non-anonymous tree?");
+ return aContent ? aContent->GetAsElementOrParentElement() : nullptr;
+}
+
+already_AddRefed<ComputedStyle> nsIFrame::ComputeSelectionStyle(
+ int16_t aSelectionStatus) const {
+ // Just bail out if not a selection-status that ::selection applies to.
+ if (aSelectionStatus != nsISelectionController::SELECTION_ON &&
+ aSelectionStatus != nsISelectionController::SELECTION_DISABLED) {
+ return nullptr;
+ }
+ Element* element = FindElementAncestorForMozSelection(GetContent());
+ if (!element) {
+ return nullptr;
+ }
+ RefPtr<ComputedStyle> pseudoStyle =
+ PresContext()->StyleSet()->ProbePseudoElementStyle(
+ *element, PseudoStyleType::selection, nullptr, Style());
+ if (!pseudoStyle) {
+ return nullptr;
+ }
+ // When in high-contrast mode, the style system ends up ignoring the color
+ // declarations, which means that the ::selection style becomes the inherited
+ // color, and default background. That's no good.
+ // When force-color-adjust is set to none allow using the color styles,
+ // as they will not be replaced.
+ if (PresContext()->ForcingColors() &&
+ pseudoStyle->StyleText()->mForcedColorAdjust !=
+ StyleForcedColorAdjust::None) {
+ return nullptr;
+ }
+ return do_AddRef(pseudoStyle);
+}
+
+already_AddRefed<ComputedStyle> nsIFrame::ComputeHighlightSelectionStyle(
+ nsAtom* aHighlightName) {
+ Element* element = FindElementAncestorForMozSelection(GetContent());
+ if (!element) {
+ return nullptr;
+ }
+ return PresContext()->StyleSet()->ProbePseudoElementStyle(
+ *element, PseudoStyleType::highlight, aHighlightName, Style());
+}
+
+template <typename SizeOrMaxSize>
+static inline bool IsIntrinsicKeyword(const SizeOrMaxSize& aSize) {
+ // All keywords other than auto/none/-moz-available depend on intrinsic sizes.
+ return aSize.IsMaxContent() || aSize.IsMinContent() || aSize.IsFitContent() ||
+ aSize.IsFitContentFunction();
+}
+
+bool nsIFrame::CanBeDynamicReflowRoot() const {
+ const auto& display = *StyleDisplay();
+ if (IsLineParticipant() || display.mDisplay.IsRuby() ||
+ display.IsInnerTableStyle() ||
+ display.DisplayInside() == StyleDisplayInside::Table) {
+ // We have a display type where 'width' and 'height' don't actually set the
+ // width or height (i.e., the size depends on content).
+ MOZ_ASSERT(!HasAnyStateBits(NS_FRAME_DYNAMIC_REFLOW_ROOT),
+ "should not have dynamic reflow root bit");
+ return false;
+ }
+
+ // In general, frames that have contain:layout+size can be reflow roots.
+ // (One exception: table-wrapper frames don't work well as reflow roots,
+ // because their inner-table ReflowInput init path tries to reuse & deref
+ // the wrapper's containing block's reflow input, which may be null if we
+ // initiate reflow from the table-wrapper itself.)
+ //
+ // Changes to `contain` force frame reconstructions, so we used to use
+ // NS_FRAME_REFLOW_ROOT, this bit could be set for the whole lifetime of
+ // this frame. But after the support of `content-visibility: auto` which
+ // is with contain layout + size when it's not relevant to user, and only
+ // with contain layout when it is relevant. The frame does not reconstruct
+ // when the relevancy changes. So we use NS_FRAME_DYNAMIC_REFLOW_ROOT instead.
+ //
+ // We place it above the pref check on purpose, to make sure it works for
+ // containment even with the pref disabled.
+ if (display.IsContainLayout() && GetContainSizeAxes().IsBoth()) {
+ return true;
+ }
+
+ if (!StaticPrefs::layout_dynamic_reflow_roots_enabled()) {
+ return false;
+ }
+
+ // We can't serve as a dynamic reflow root if our used 'width' and 'height'
+ // might be influenced by content.
+ //
+ // FIXME: For display:block, we should probably optimize inline-size: auto.
+ // FIXME: Other flex and grid cases?
+ const auto& pos = *StylePosition();
+ const auto& width = pos.mWidth;
+ const auto& height = pos.mHeight;
+ if (!width.IsLengthPercentage() || width.HasPercent() ||
+ !height.IsLengthPercentage() || height.HasPercent() ||
+ IsIntrinsicKeyword(pos.mMinWidth) || IsIntrinsicKeyword(pos.mMaxWidth) ||
+ IsIntrinsicKeyword(pos.mMinHeight) ||
+ IsIntrinsicKeyword(pos.mMaxHeight) ||
+ ((pos.mMinWidth.IsAuto() || pos.mMinHeight.IsAuto()) &&
+ IsFlexOrGridItem())) {
+ return false;
+ }
+
+ // If our flex-basis is 'auto', it'll defer to 'width' (or 'height') which
+ // we've already checked. Otherwise, it preempts them, so we need to
+ // perform the same "could-this-value-be-influenced-by-content" checks that
+ // we performed for 'width' and 'height' above.
+ if (IsFlexItem()) {
+ const auto& flexBasis = pos.mFlexBasis;
+ if (!flexBasis.IsAuto()) {
+ if (!flexBasis.IsSize() || !flexBasis.AsSize().IsLengthPercentage() ||
+ flexBasis.AsSize().HasPercent()) {
+ return false;
+ }
+ }
+ }
+
+ if (!IsFixedPosContainingBlock()) {
+ // We can't treat this frame as a reflow root, since dynamic changes
+ // to absolutely-positioned frames inside of it require that we
+ // reflow the placeholder before we reflow the absolutely positioned
+ // frame.
+ // FIXME: Alternatively, we could sort the reflow roots in
+ // PresShell::ProcessReflowCommands by depth in the tree, from
+ // deepest to least deep. However, for performance (FIXME) we
+ // should really be sorting them in the opposite order!
+ return false;
+ }
+
+ // If we participate in a container's block reflow context, or margins
+ // can collapse through us, we can't be a dynamic reflow root.
+ if (IsBlockFrameOrSubclass() && !HasAnyStateBits(NS_BLOCK_BFC_STATE_BITS)) {
+ return false;
+ }
+
+ // Subgrids are never reflow roots, but 'contain:layout/paint' prevents
+ // creating a subgrid in the first place.
+ if (pos.mGridTemplateColumns.IsSubgrid() ||
+ pos.mGridTemplateRows.IsSubgrid()) {
+ // NOTE: we could check that 'display' of our parent's primary frame is
+ // '[inline-]grid' here but that's probably not worth it in practice.
+ if (!display.IsContainLayout() && !display.IsContainPaint()) {
+ return false;
+ }
+ }
+
+ // If we are split, we can't be a dynamic reflow root. Our reflow status may
+ // change after reflow, and our parent is responsible to create or delete our
+ // next-in-flow.
+ if (GetPrevContinuation() || GetNextContinuation()) {
+ return false;
+ }
+
+ return true;
+}
+
+/********************************************************
+ * Refreshes each content's frame
+ *********************************************************/
+
+void nsIFrame::DisplayOutlineUnconditional(nsDisplayListBuilder* aBuilder,
+ const nsDisplayListSet& aLists) {
+ // Per https://drafts.csswg.org/css-tables-3/#global-style-overrides:
+ // "All css properties of table-column and table-column-group boxes are
+ // ignored, except when explicitly specified by this specification."
+ // CSS outlines fall into this category, so we skip them on these boxes.
+ MOZ_ASSERT(!IsTableColGroupFrame() && !IsTableColFrame());
+ const auto& outline = *StyleOutline();
+
+ if (!outline.ShouldPaintOutline()) {
+ return;
+ }
+
+ // Outlines are painted by the table wrapper frame.
+ if (IsTableFrame()) {
+ return;
+ }
+
+ if (HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT) &&
+ ScrollableOverflowRect().IsEmpty()) {
+ // Skip parts of IB-splits with an empty overflow rect, see bug 434301.
+ // We may still want to fix some of the overflow area calculations over in
+ // that bug.
+ return;
+ }
+
+ // We don't display outline-style: auto on themed frames that have their own
+ // focus indicators.
+ if (outline.mOutlineStyle.IsAuto()) {
+ auto* disp = StyleDisplay();
+ if (IsThemed(disp) && PresContext()->Theme()->ThemeDrawsFocusForWidget(
+ this, disp->EffectiveAppearance())) {
+ return;
+ }
+ }
+
+ aLists.Outlines()->AppendNewToTop<nsDisplayOutline>(aBuilder, this);
+}
+
+void nsIFrame::DisplayOutline(nsDisplayListBuilder* aBuilder,
+ const nsDisplayListSet& aLists) {
+ if (!IsVisibleForPainting()) return;
+
+ DisplayOutlineUnconditional(aBuilder, aLists);
+}
+
+void nsIFrame::DisplayInsetBoxShadowUnconditional(
+ nsDisplayListBuilder* aBuilder, nsDisplayList* aList) {
+ // XXXbz should box-shadow for rows/rowgroups/columns/colgroups get painted
+ // just because we're visible? Or should it depend on the cell visibility
+ // when we're not the whole table?
+ const auto* effects = StyleEffects();
+ if (effects->HasBoxShadowWithInset(true)) {
+ aList->AppendNewToTop<nsDisplayBoxShadowInner>(aBuilder, this);
+ }
+}
+
+void nsIFrame::DisplayInsetBoxShadow(nsDisplayListBuilder* aBuilder,
+ nsDisplayList* aList) {
+ if (!IsVisibleForPainting()) return;
+
+ DisplayInsetBoxShadowUnconditional(aBuilder, aList);
+}
+
+void nsIFrame::DisplayOutsetBoxShadowUnconditional(
+ nsDisplayListBuilder* aBuilder, nsDisplayList* aList) {
+ // XXXbz should box-shadow for rows/rowgroups/columns/colgroups get painted
+ // just because we're visible? Or should it depend on the cell visibility
+ // when we're not the whole table?
+ const auto* effects = StyleEffects();
+ if (effects->HasBoxShadowWithInset(false)) {
+ aList->AppendNewToTop<nsDisplayBoxShadowOuter>(aBuilder, this);
+ }
+}
+
+void nsIFrame::DisplayOutsetBoxShadow(nsDisplayListBuilder* aBuilder,
+ nsDisplayList* aList) {
+ if (!IsVisibleForPainting()) return;
+
+ DisplayOutsetBoxShadowUnconditional(aBuilder, aList);
+}
+
+void nsIFrame::DisplayCaret(nsDisplayListBuilder* aBuilder,
+ nsDisplayList* aList) {
+ if (!IsVisibleForPainting()) return;
+
+ aList->AppendNewToTop<nsDisplayCaret>(aBuilder, this);
+}
+
+nscolor nsIFrame::GetCaretColorAt(int32_t aOffset) {
+ return nsLayoutUtils::GetColor(this, &nsStyleUI::mCaretColor);
+}
+
+auto nsIFrame::ComputeShouldPaintBackground() const -> ShouldPaintBackground {
+ nsPresContext* pc = PresContext();
+ ShouldPaintBackground settings{pc->GetBackgroundColorDraw(),
+ pc->GetBackgroundImageDraw()};
+ if (settings.mColor && settings.mImage) {
+ return settings;
+ }
+
+ if (StyleVisibility()->mPrintColorAdjust == StylePrintColorAdjust::Exact) {
+ return {true, true};
+ }
+
+ return settings;
+}
+
+bool nsIFrame::DisplayBackgroundUnconditional(nsDisplayListBuilder* aBuilder,
+ const nsDisplayListSet& aLists) {
+ if (aBuilder->IsForEventDelivery() && !aBuilder->HitTestIsForVisibility()) {
+ // For hit-testing, we generally just need a light-weight data structure
+ // like nsDisplayEventReceiver. But if the hit-testing is for visibility,
+ // then we need to know the opaque region in order to determine whether to
+ // stop or not.
+ aLists.BorderBackground()->AppendNewToTop<nsDisplayEventReceiver>(aBuilder,
+ this);
+ return false;
+ }
+
+ const AppendedBackgroundType result =
+ nsDisplayBackgroundImage::AppendBackgroundItemsToTop(
+ aBuilder, this,
+ GetRectRelativeToSelf() + aBuilder->ToReferenceFrame(this),
+ aLists.BorderBackground());
+
+ if (result == AppendedBackgroundType::None) {
+ aBuilder->BuildCompositorHitTestInfoIfNeeded(this,
+ aLists.BorderBackground());
+ }
+
+ return result == AppendedBackgroundType::ThemedBackground;
+}
+
+void nsIFrame::DisplayBorderBackgroundOutline(nsDisplayListBuilder* aBuilder,
+ const nsDisplayListSet& aLists) {
+ // The visibility check belongs here since child elements have the
+ // opportunity to override the visibility property and display even if
+ // their parent is hidden.
+ if (!IsVisibleForPainting()) {
+ return;
+ }
+
+ DisplayOutsetBoxShadowUnconditional(aBuilder, aLists.BorderBackground());
+
+ bool bgIsThemed = DisplayBackgroundUnconditional(aBuilder, aLists);
+ DisplayInsetBoxShadowUnconditional(aBuilder, aLists.BorderBackground());
+
+ // If there's a themed background, we should not create a border item.
+ // It won't be rendered.
+ // Don't paint borders for tables here, since they paint them in a different
+ // order.
+ if (!bgIsThemed && StyleBorder()->HasBorder() && !IsTableFrame()) {
+ aLists.BorderBackground()->AppendNewToTop<nsDisplayBorder>(aBuilder, this);
+ }
+
+ DisplayOutlineUnconditional(aBuilder, aLists);
+}
+
+inline static bool IsSVGContentWithCSSClip(const nsIFrame* aFrame) {
+ // The CSS spec says that the 'clip' property only applies to absolutely
+ // positioned elements, whereas the SVG spec says that it applies to SVG
+ // elements regardless of the value of the 'position' property. Here we obey
+ // the CSS spec for outer-<svg> (since that's what we generally do), but
+ // obey the SVG spec for other SVG elements to which 'clip' applies.
+ return aFrame->HasAnyStateBits(NS_FRAME_SVG_LAYOUT) &&
+ aFrame->GetContent()->IsAnyOfSVGElements(nsGkAtoms::svg,
+ nsGkAtoms::foreignObject);
+}
+
+Maybe<nsRect> nsIFrame::GetClipPropClipRect(const nsStyleDisplay* aDisp,
+ const nsStyleEffects* aEffects,
+ const nsSize& aSize) const {
+ if (aEffects->mClip.IsAuto() ||
+ !(aDisp->IsAbsolutelyPositioned(this) || IsSVGContentWithCSSClip(this))) {
+ return Nothing();
+ }
+
+ auto& clipRect = aEffects->mClip.AsRect();
+ nsRect rect = clipRect.ToLayoutRect();
+ if (MOZ_LIKELY(StyleBorder()->mBoxDecorationBreak ==
+ StyleBoxDecorationBreak::Slice)) {
+ // The clip applies to the joined boxes so it's relative the first
+ // continuation.
+ nscoord y = 0;
+ for (nsIFrame* f = GetPrevContinuation(); f; f = f->GetPrevContinuation()) {
+ y += f->GetRect().height;
+ }
+ rect.MoveBy(nsPoint(0, -y));
+ }
+
+ if (clipRect.right.IsAuto()) {
+ rect.width = aSize.width - rect.x;
+ }
+ if (clipRect.bottom.IsAuto()) {
+ rect.height = aSize.height - rect.y;
+ }
+ return Some(rect);
+}
+
+/**
+ * If the CSS 'overflow' property applies to this frame, and is not
+ * handled by constructing a dedicated nsHTML/XULScrollFrame, set up clipping
+ * for that overflow in aBuilder->ClipState() to clip all containing-block
+ * descendants.
+ */
+static void ApplyOverflowClipping(
+ nsDisplayListBuilder* aBuilder, const nsIFrame* aFrame,
+ nsIFrame::PhysicalAxes aClipAxes,
+ DisplayListClipState::AutoClipMultiple& aClipState) {
+ // Only 'clip' is handled here (and 'hidden' for table frames, and any
+ // non-'visible' value for blocks in a paginated context).
+ // We allow 'clip' to apply to any kind of frame. This is required by
+ // comboboxes which make their display text (an inline frame) have clipping.
+ MOZ_ASSERT(aClipAxes != nsIFrame::PhysicalAxes::None);
+ MOZ_ASSERT(aFrame->ShouldApplyOverflowClipping(aFrame->StyleDisplay()) ==
+ aClipAxes);
+
+ nsRect clipRect;
+ bool haveRadii = false;
+ nscoord radii[8];
+ auto* disp = aFrame->StyleDisplay();
+ // Only deflate the padding if we clip to the content-box in that axis.
+ auto wm = aFrame->GetWritingMode();
+ bool cbH = (wm.IsVertical() ? disp->mOverflowClipBoxBlock
+ : disp->mOverflowClipBoxInline) ==
+ StyleOverflowClipBox::ContentBox;
+ bool cbV = (wm.IsVertical() ? disp->mOverflowClipBoxInline
+ : disp->mOverflowClipBoxBlock) ==
+ StyleOverflowClipBox::ContentBox;
+
+ nsMargin boxMargin = -aFrame->GetUsedPadding();
+ if (!cbH) {
+ boxMargin.left = boxMargin.right = nscoord(0);
+ }
+ if (!cbV) {
+ boxMargin.top = boxMargin.bottom = nscoord(0);
+ }
+
+ auto clipMargin = aFrame->OverflowClipMargin(aClipAxes);
+
+ boxMargin -= aFrame->GetUsedBorder();
+ boxMargin += nsMargin(clipMargin.height, clipMargin.width, clipMargin.height,
+ clipMargin.width);
+ boxMargin.ApplySkipSides(aFrame->GetSkipSides());
+
+ nsRect rect(nsPoint(0, 0), aFrame->GetSize());
+ rect.Inflate(boxMargin);
+ if (MOZ_UNLIKELY(!(aClipAxes & nsIFrame::PhysicalAxes::Horizontal))) {
+ // NOTE(mats) We shouldn't be clipping at all in this dimension really,
+ // but clipping in just one axis isn't supported by our GFX APIs so we
+ // clip to our visual overflow rect instead.
+ nsRect o = aFrame->InkOverflowRect();
+ rect.x = o.x;
+ rect.width = o.width;
+ }
+ if (MOZ_UNLIKELY(!(aClipAxes & nsIFrame::PhysicalAxes::Vertical))) {
+ // See the note above.
+ nsRect o = aFrame->InkOverflowRect();
+ rect.y = o.y;
+ rect.height = o.height;
+ }
+ clipRect = rect + aBuilder->ToReferenceFrame(aFrame);
+ haveRadii = aFrame->GetBoxBorderRadii(radii, boxMargin);
+ aClipState.ClipContainingBlockDescendantsExtra(clipRect,
+ haveRadii ? radii : nullptr);
+}
+
+nsSize nsIFrame::OverflowClipMargin(PhysicalAxes aClipAxes) const {
+ nsSize result;
+ if (aClipAxes == PhysicalAxes::None) {
+ return result;
+ }
+ const auto& margin = StyleMargin()->mOverflowClipMargin;
+ if (margin.IsZero()) {
+ return result;
+ }
+ nscoord marginAu = margin.ToAppUnits();
+ if (aClipAxes & PhysicalAxes::Horizontal) {
+ result.width = marginAu;
+ }
+ if (aClipAxes & PhysicalAxes::Vertical) {
+ result.height = marginAu;
+ }
+ return result;
+}
+
+/**
+ * Returns whether a display item that gets created with the builder's current
+ * state will have a scrolled clip, i.e. a clip that is scrolled by a scroll
+ * frame which does not move the item itself.
+ */
+static bool BuilderHasScrolledClip(nsDisplayListBuilder* aBuilder) {
+ const DisplayItemClipChain* currentClip =
+ aBuilder->ClipState().GetCurrentCombinedClipChain(aBuilder);
+ if (!currentClip) {
+ return false;
+ }
+
+ const ActiveScrolledRoot* currentClipASR = currentClip->mASR;
+ const ActiveScrolledRoot* currentASR = aBuilder->CurrentActiveScrolledRoot();
+ return ActiveScrolledRoot::PickDescendant(currentClipASR, currentASR) !=
+ currentASR;
+}
+
+class AutoSaveRestoreContainsBlendMode {
+ nsDisplayListBuilder& mBuilder;
+ bool mSavedContainsBlendMode;
+
+ public:
+ explicit AutoSaveRestoreContainsBlendMode(nsDisplayListBuilder& aBuilder)
+ : mBuilder(aBuilder),
+ mSavedContainsBlendMode(aBuilder.ContainsBlendMode()) {}
+
+ ~AutoSaveRestoreContainsBlendMode() {
+ mBuilder.SetContainsBlendMode(mSavedContainsBlendMode);
+ }
+};
+
+static bool IsFrameOrAncestorApzAware(nsIFrame* aFrame) {
+ nsIContent* node = aFrame->GetContent();
+ if (!node) {
+ return false;
+ }
+
+ do {
+ if (node->IsNodeApzAware()) {
+ return true;
+ }
+ nsIContent* shadowRoot = node->GetShadowRoot();
+ if (shadowRoot && shadowRoot->IsNodeApzAware()) {
+ return true;
+ }
+
+ // Even if the node owning aFrame doesn't have apz-aware event listeners
+ // itself, its shadow root or display: contents ancestors (which have no
+ // frames) might, so we need to account for them too.
+ } while ((node = node->GetFlattenedTreeParent()) && node->IsElement() &&
+ node->AsElement()->IsDisplayContents());
+
+ return false;
+}
+
+static void CheckForApzAwareEventHandlers(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aFrame) {
+ if (aBuilder->GetAncestorHasApzAwareEventHandler()) {
+ return;
+ }
+
+ if (IsFrameOrAncestorApzAware(aFrame)) {
+ aBuilder->SetAncestorHasApzAwareEventHandler(true);
+ }
+}
+
+static void UpdateCurrentHitTestInfo(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aFrame) {
+ if (!aBuilder->BuildCompositorHitTestInfo()) {
+ // Compositor hit test info is not used.
+ return;
+ }
+
+ CheckForApzAwareEventHandlers(aBuilder, aFrame);
+
+ const CompositorHitTestInfo info = aFrame->GetCompositorHitTestInfo(aBuilder);
+ aBuilder->SetCompositorHitTestInfo(info);
+}
+
+/**
+ * True if aDescendant participates the context aAncestor participating.
+ */
+static bool FrameParticipatesIn3DContext(nsIFrame* aAncestor,
+ nsIFrame* aDescendant) {
+ MOZ_ASSERT(aAncestor != aDescendant);
+ MOZ_ASSERT(aAncestor->GetContent() != aDescendant->GetContent());
+ MOZ_ASSERT(aAncestor->Extend3DContext());
+
+ nsIFrame* ancestor = aAncestor->FirstContinuation();
+ MOZ_ASSERT(ancestor->IsPrimaryFrame());
+
+ nsIFrame* frame;
+ for (frame = aDescendant->GetClosestFlattenedTreeAncestorPrimaryFrame();
+ frame && ancestor != frame;
+ frame = frame->GetClosestFlattenedTreeAncestorPrimaryFrame()) {
+ if (!frame->Extend3DContext()) {
+ return false;
+ }
+ }
+
+ MOZ_ASSERT(frame == ancestor);
+ return true;
+}
+
+static bool ItemParticipatesIn3DContext(nsIFrame* aAncestor,
+ nsDisplayItem* aItem) {
+ auto type = aItem->GetType();
+ const bool isContainer = type == DisplayItemType::TYPE_WRAP_LIST ||
+ type == DisplayItemType::TYPE_CONTAINER;
+
+ if (isContainer && aItem->GetChildren()->Length() == 1) {
+ // If the wraplist has only one child item, use the type of that item.
+ type = aItem->GetChildren()->GetBottom()->GetType();
+ }
+
+ if (type != DisplayItemType::TYPE_TRANSFORM &&
+ type != DisplayItemType::TYPE_PERSPECTIVE) {
+ return false;
+ }
+ nsIFrame* transformFrame = aItem->Frame();
+ if (aAncestor->GetContent() == transformFrame->GetContent()) {
+ return true;
+ }
+ return FrameParticipatesIn3DContext(aAncestor, transformFrame);
+}
+
+static void WrapSeparatorTransform(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aFrame,
+ nsDisplayList* aNonParticipants,
+ nsDisplayList* aParticipants, int aIndex,
+ nsDisplayItem** aSeparator) {
+ if (aNonParticipants->IsEmpty()) {
+ return;
+ }
+
+ nsDisplayTransform* item = MakeDisplayItemWithIndex<nsDisplayTransform>(
+ aBuilder, aFrame, aIndex, aNonParticipants, aBuilder->GetVisibleRect());
+
+ if (*aSeparator == nullptr && item) {
+ *aSeparator = item;
+ }
+
+ aParticipants->AppendToTop(item);
+}
+
+// Try to compute a clip rect to bound the contents of the mask item
+// that will be built for |aMaskedFrame|. If we're not able to compute
+// one, return an empty Maybe.
+// The returned clip rect, if there is one, is relative to |aMaskedFrame|.
+static Maybe<nsRect> ComputeClipForMaskItem(
+ nsDisplayListBuilder* aBuilder, nsIFrame* aMaskedFrame,
+ const SVGUtils::MaskUsage& aMaskUsage) {
+ const nsStyleSVGReset* svgReset = aMaskedFrame->StyleSVGReset();
+
+ nsPoint offsetToUserSpace =
+ nsLayoutUtils::ComputeOffsetToUserSpace(aBuilder, aMaskedFrame);
+ int32_t devPixelRatio = aMaskedFrame->PresContext()->AppUnitsPerDevPixel();
+ gfxPoint devPixelOffsetToUserSpace =
+ nsLayoutUtils::PointToGfxPoint(offsetToUserSpace, devPixelRatio);
+ CSSToLayoutDeviceScale cssToDevScale =
+ aMaskedFrame->PresContext()->CSSToDevPixelScale();
+
+ nsPoint toReferenceFrame;
+ aBuilder->FindReferenceFrameFor(aMaskedFrame, &toReferenceFrame);
+
+ Maybe<gfxRect> combinedClip;
+ if (aMaskUsage.ShouldApplyBasicShapeOrPath()) {
+ Maybe<Rect> result =
+ CSSClipPathInstance::GetBoundingRectForBasicShapeOrPathClip(
+ aMaskedFrame, svgReset->mClipPath);
+ if (result) {
+ combinedClip = Some(ThebesRect(*result));
+ }
+ } else if (aMaskUsage.ShouldApplyClipPath()) {
+ gfxRect result = SVGUtils::GetBBox(
+ aMaskedFrame,
+ SVGUtils::eBBoxIncludeClipped | SVGUtils::eBBoxIncludeFill |
+ SVGUtils::eBBoxIncludeMarkers | SVGUtils::eBBoxIncludeStroke |
+ SVGUtils::eDoNotClipToBBoxOfContentInsideClipPath);
+ combinedClip = Some(
+ ThebesRect((CSSRect::FromUnknownRect(ToRect(result)) * cssToDevScale)
+ .ToUnknownRect()));
+ } else {
+ // The code for this case is adapted from ComputeMaskGeometry().
+
+ nsRect borderArea(toReferenceFrame, aMaskedFrame->GetSize());
+ borderArea -= offsetToUserSpace;
+
+ // Use an infinite dirty rect to pass into nsCSSRendering::
+ // GetImageLayerClip() because we don't have an actual dirty rect to
+ // pass in. This is fine because the only time GetImageLayerClip() will
+ // not intersect the incoming dirty rect with something is in the "NoClip"
+ // case, and we handle that specially.
+ nsRect dirtyRect(nscoord_MIN / 2, nscoord_MIN / 2, nscoord_MAX,
+ nscoord_MAX);
+
+ nsIFrame* firstFrame =
+ nsLayoutUtils::FirstContinuationOrIBSplitSibling(aMaskedFrame);
+ nsTArray<SVGMaskFrame*> maskFrames;
+ // XXX check return value?
+ SVGObserverUtils::GetAndObserveMasks(firstFrame, &maskFrames);
+
+ for (uint32_t i = 0; i < maskFrames.Length(); ++i) {
+ gfxRect clipArea;
+ if (maskFrames[i]) {
+ clipArea = maskFrames[i]->GetMaskArea(aMaskedFrame);
+ clipArea = ThebesRect(
+ (CSSRect::FromUnknownRect(ToRect(clipArea)) * cssToDevScale)
+ .ToUnknownRect());
+ } else {
+ const auto& layer = svgReset->mMask.mLayers[i];
+ if (layer.mClip == StyleGeometryBox::NoClip) {
+ return Nothing();
+ }
+
+ nsCSSRendering::ImageLayerClipState clipState;
+ nsCSSRendering::GetImageLayerClip(
+ layer, aMaskedFrame, *aMaskedFrame->StyleBorder(), borderArea,
+ dirtyRect, false /* aWillPaintBorder */, devPixelRatio, &clipState);
+ clipArea = clipState.mDirtyRectInDevPx;
+ }
+ combinedClip = UnionMaybeRects(combinedClip, Some(clipArea));
+ }
+ }
+ if (combinedClip) {
+ if (combinedClip->IsEmpty()) {
+ // *clipForMask might be empty if all mask references are not resolvable
+ // or the size of them are empty. We still need to create a transparent
+ // mask before bug 1276834 fixed, so don't clip ctx by an empty rectangle
+ // for for now.
+ return Nothing();
+ }
+
+ // Convert to user space.
+ *combinedClip += devPixelOffsetToUserSpace;
+
+ // Round the clip out. In FrameLayerBuilder we round clips to nearest
+ // pixels, and if we have a really thin clip here, that can cause the
+ // clip to become empty if we didn't round out here.
+ // The rounding happens in coordinates that are relative to the reference
+ // frame, which matches what FrameLayerBuilder does.
+ combinedClip->RoundOut();
+
+ // Convert to app units.
+ nsRect result =
+ nsLayoutUtils::RoundGfxRectToAppRect(*combinedClip, devPixelRatio);
+
+ // The resulting clip is relative to the reference frame, but the caller
+ // expects it to be relative to the masked frame, so adjust it.
+ result -= toReferenceFrame;
+ return Some(result);
+ }
+ return Nothing();
+}
+
+struct AutoCheckBuilder {
+ explicit AutoCheckBuilder(nsDisplayListBuilder* aBuilder)
+ : mBuilder(aBuilder) {
+ aBuilder->Check();
+ }
+
+ ~AutoCheckBuilder() { mBuilder->Check(); }
+
+ nsDisplayListBuilder* mBuilder;
+};
+
+/**
+ * Tries to reuse a top-level stacking context item from the previous paint.
+ * Returns true if an item was reused, otherwise false.
+ */
+bool TryToReuseStackingContextItem(nsDisplayListBuilder* aBuilder,
+ nsDisplayList* aList, nsIFrame* aFrame) {
+ if (!aBuilder->IsForPainting() || !aBuilder->IsPartialUpdate() ||
+ aBuilder->InInvalidSubtree()) {
+ return false;
+ }
+
+ if (aFrame->IsFrameModified() || aFrame->HasModifiedDescendants()) {
+ return false;
+ }
+
+ auto& items = aFrame->DisplayItems();
+ auto* res = std::find_if(
+ items.begin(), items.end(),
+ [](nsDisplayItem* aItem) { return aItem->IsPreProcessed(); });
+
+ if (res == items.end()) {
+ return false;
+ }
+
+ nsDisplayItem* container = *res;
+ MOZ_ASSERT(container->Frame() == aFrame);
+ DL_LOGD("RDL - Found SC item %p (%s) (frame: %p)", container,
+ container->Name(), container->Frame());
+
+ aList->AppendToTop(container);
+ aBuilder->ReuseDisplayItem(container);
+ return true;
+}
+
+void nsIFrame::BuildDisplayListForStackingContext(
+ nsDisplayListBuilder* aBuilder, nsDisplayList* aList,
+ bool* aCreatedContainerItem) {
+#ifdef DEBUG
+ DL_LOGV("BuildDisplayListForStackingContext (%p) <", this);
+ ScopeExit e(
+ [this]() { DL_LOGV("> BuildDisplayListForStackingContext (%p)", this); });
+#endif
+
+ AutoCheckBuilder check(aBuilder);
+
+ if (aBuilder->IsReusingStackingContextItems() &&
+ TryToReuseStackingContextItem(aBuilder, aList, this)) {
+ if (aCreatedContainerItem) {
+ *aCreatedContainerItem = true;
+ }
+ return;
+ }
+
+ if (HasAnyStateBits(NS_FRAME_TOO_DEEP_IN_FRAME_TREE)) {
+ return;
+ }
+
+ const auto& style = *Style();
+ const nsStyleDisplay* disp = style.StyleDisplay();
+ const nsStyleEffects* effects = style.StyleEffects();
+ EffectSet* effectSetForOpacity =
+ EffectSet::GetForFrame(this, nsCSSPropertyIDSet::OpacityProperties());
+ // We can stop right away if this is a zero-opacity stacking context and
+ // we're painting, and we're not animating opacity.
+ bool needHitTestInfo = aBuilder->BuildCompositorHitTestInfo() &&
+ Style()->PointerEvents() != StylePointerEvents::None;
+ bool opacityItemForEventsOnly = false;
+ if (effects->IsTransparent() && aBuilder->IsForPainting() &&
+ !(disp->mWillChange.bits & StyleWillChangeBits::OPACITY) &&
+ !nsLayoutUtils::HasAnimationOfPropertySet(
+ this, nsCSSPropertyIDSet::OpacityProperties(), effectSetForOpacity)) {
+ if (needHitTestInfo) {
+ opacityItemForEventsOnly = true;
+ } else {
+ return;
+ }
+ }
+
+ if (aBuilder->IsForPainting() && disp->mWillChange.bits) {
+ aBuilder->AddToWillChangeBudget(this, GetSize());
+ }
+
+ // For preserves3d, use the dirty rect already installed on the
+ // builder, since aDirtyRect maybe distorted for transforms along
+ // the chain.
+ nsRect visibleRect = aBuilder->GetVisibleRect();
+ nsRect dirtyRect = aBuilder->GetDirtyRect();
+
+ // We build an opacity item if it's not going to be drawn by SVG content.
+ // We could in principle skip creating an nsDisplayOpacity item if
+ // nsDisplayOpacity::NeedsActiveLayer returns false and usingSVGEffects is
+ // true (the nsDisplayFilter/nsDisplayMasksAndClipPaths could handle the
+ // opacity). Since SVG has perf issues where we sometimes spend a lot of
+ // time creating display list items that might be helpful. We'd need to
+ // restore our mechanism to do that (changed in bug 1482403), and we'd
+ // need to invalidate the frame if the value that would be return from
+ // NeedsActiveLayer was to change, which we don't currently do.
+ const bool useOpacity =
+ HasVisualOpacity(disp, effects, effectSetForOpacity) &&
+ !SVGUtils::CanOptimizeOpacity(this);
+
+ const bool isTransformed = IsTransformed();
+ const bool hasPerspective = isTransformed && HasPerspective();
+ const bool extend3DContext =
+ Extend3DContext(disp, effects, effectSetForOpacity);
+ const bool combines3DTransformWithAncestors =
+ (extend3DContext || isTransformed) && Combines3DTransformWithAncestors();
+
+ Maybe<nsDisplayListBuilder::AutoPreserves3DContext> autoPreserves3DContext;
+ if (extend3DContext && !combines3DTransformWithAncestors) {
+ // Start a new preserves3d context to keep informations on
+ // nsDisplayListBuilder.
+ autoPreserves3DContext.emplace(aBuilder);
+ // Save dirty rect on the builder to avoid being distorted for
+ // multiple transforms along the chain.
+ aBuilder->SavePreserves3DRect();
+
+ // We rebuild everything within preserve-3d and don't try
+ // to retain, so override the dirty rect now.
+ if (aBuilder->IsRetainingDisplayList()) {
+ dirtyRect = visibleRect;
+ aBuilder->SetDisablePartialUpdates(true);
+ }
+ }
+
+ const bool useBlendMode = effects->mMixBlendMode != StyleBlend::Normal;
+ if (useBlendMode) {
+ aBuilder->SetContainsBlendMode(true);
+ }
+
+ // reset blend mode so we can keep track if this stacking context needs have
+ // a nsDisplayBlendContainer. Set the blend mode back when the routine exits
+ // so we keep track if the parent stacking context needs a container too.
+ AutoSaveRestoreContainsBlendMode autoRestoreBlendMode(*aBuilder);
+ aBuilder->SetContainsBlendMode(false);
+
+ // NOTE: When changing this condition make sure to tweak nsGfxScrollFrame as
+ // well.
+ bool usingBackdropFilter = effects->HasBackdropFilters() &&
+ IsVisibleForPainting() &&
+ !style.IsRootElementStyle();
+
+ nsRect visibleRectOutsideTransform = visibleRect;
+ nsDisplayTransform::PrerenderInfo prerenderInfo;
+ bool inTransform = aBuilder->IsInTransform();
+ if (isTransformed) {
+ prerenderInfo = nsDisplayTransform::ShouldPrerenderTransformedContent(
+ aBuilder, this, &visibleRect);
+
+ switch (prerenderInfo.mDecision) {
+ case nsDisplayTransform::PrerenderDecision::Full:
+ case nsDisplayTransform::PrerenderDecision::Partial:
+ dirtyRect = visibleRect;
+ break;
+ case nsDisplayTransform::PrerenderDecision::No: {
+ // If we didn't prerender an animated frame in a preserve-3d context,
+ // then we want disable async animations for the rest of the preserve-3d
+ // (especially ancestors).
+ if ((extend3DContext || combines3DTransformWithAncestors) &&
+ prerenderInfo.mHasAnimations) {
+ aBuilder->SavePreserves3DAllowAsyncAnimation(false);
+ }
+
+ const nsRect overflow = InkOverflowRectRelativeToSelf();
+ if (overflow.IsEmpty() && !extend3DContext) {
+ return;
+ }
+
+ // If we're in preserve-3d then grab the dirty rect that was given to
+ // the root and transform using the combined transform.
+ if (combines3DTransformWithAncestors) {
+ visibleRect = dirtyRect = aBuilder->GetPreserves3DRect();
+ }
+
+ float appPerDev = PresContext()->AppUnitsPerDevPixel();
+ auto transform = nsDisplayTransform::GetResultingTransformMatrix(
+ this, nsPoint(), appPerDev,
+ nsDisplayTransform::kTransformRectFlags);
+ nsRect untransformedDirtyRect;
+ if (nsDisplayTransform::UntransformRect(dirtyRect, overflow, transform,
+ appPerDev,
+ &untransformedDirtyRect)) {
+ dirtyRect = untransformedDirtyRect;
+ nsDisplayTransform::UntransformRect(visibleRect, overflow, transform,
+ appPerDev, &visibleRect);
+ } else {
+ // This should only happen if the transform is singular, in which case
+ // nothing is visible anyway
+ dirtyRect.SetEmpty();
+ visibleRect.SetEmpty();
+ }
+ }
+ }
+ inTransform = true;
+ } else if (IsFixedPosContainingBlock()) {
+ // Restict the building area to the overflow rect for these frames, since
+ // RetainedDisplayListBuilder uses it to know if the size of the stacking
+ // context changed.
+ visibleRect.IntersectRect(visibleRect, InkOverflowRect());
+ dirtyRect.IntersectRect(dirtyRect, InkOverflowRect());
+ }
+
+ bool hasOverrideDirtyRect = false;
+ // If we're doing a partial build, we're not invalid and we're capable
+ // of having an override building rect (stacking context and fixed pos
+ // containing block), then we should assume we have one.
+ // Either we have an explicit one, or nothing in our subtree changed and
+ // we have an implicit empty rect.
+ //
+ // These conditions should match |CanStoreDisplayListBuildingRect()| in
+ // RetainedDisplayListBuilder.cpp
+ if (!aBuilder->IsReusingStackingContextItems() &&
+ aBuilder->IsPartialUpdate() && !aBuilder->InInvalidSubtree() &&
+ !IsFrameModified() && IsFixedPosContainingBlock() &&
+ !GetPrevContinuation() && !GetNextContinuation()) {
+ dirtyRect = nsRect();
+ if (HasOverrideDirtyRegion()) {
+ nsDisplayListBuilder::DisplayListBuildingData* data =
+ GetProperty(nsDisplayListBuilder::DisplayListBuildingRect());
+ if (data) {
+ dirtyRect = data->mDirtyRect.Intersect(visibleRect);
+ hasOverrideDirtyRect = true;
+ }
+ }
+ }
+
+ bool usingFilter = effects->HasFilters() && !style.IsRootElementStyle();
+ SVGUtils::MaskUsage maskUsage = SVGUtils::DetermineMaskUsage(this, false);
+ bool usingMask = maskUsage.UsingMaskOrClipPath();
+ bool usingSVGEffects = usingFilter || usingMask;
+
+ nsRect visibleRectOutsideSVGEffects = visibleRect;
+ nsDisplayList hoistedScrollInfoItemsStorage(aBuilder);
+ if (usingSVGEffects) {
+ dirtyRect =
+ SVGIntegrationUtils::GetRequiredSourceForInvalidArea(this, dirtyRect);
+ visibleRect =
+ SVGIntegrationUtils::GetRequiredSourceForInvalidArea(this, visibleRect);
+ aBuilder->EnterSVGEffectsContents(this, &hoistedScrollInfoItemsStorage);
+ }
+
+ bool useStickyPosition = disp->mPosition == StylePositionProperty::Sticky;
+
+ bool useFixedPosition =
+ disp->mPosition == StylePositionProperty::Fixed &&
+ (DisplayPortUtils::IsFixedPosFrameInDisplayPort(this) ||
+ BuilderHasScrolledClip(aBuilder));
+
+ nsDisplayListBuilder::AutoBuildingDisplayList buildingDisplayList(
+ aBuilder, this, visibleRect, dirtyRect, isTransformed);
+
+ UpdateCurrentHitTestInfo(aBuilder, this);
+
+ // Depending on the effects that are applied to this frame, we can create
+ // multiple container display items and wrap them around our contents.
+ // This enum lists all the potential container display items, in the order
+ // outside to inside.
+ enum class ContainerItemType : uint8_t {
+ None = 0,
+ OwnLayerIfNeeded,
+ BlendMode,
+ FixedPosition,
+ OwnLayerForTransformWithRoundedClip,
+ Perspective,
+ Transform,
+ SeparatorTransforms,
+ Opacity,
+ Filter,
+ BlendContainer
+ };
+
+ nsDisplayListBuilder::AutoContainerASRTracker contASRTracker(aBuilder);
+
+ auto cssClip = GetClipPropClipRect(disp, effects, GetSize());
+ auto ApplyClipProp = [&](DisplayListClipState::AutoSaveRestore& aClipState) {
+ if (!cssClip) {
+ return;
+ }
+ nsPoint offset = aBuilder->GetCurrentFrameOffsetToReferenceFrame();
+ aBuilder->IntersectDirtyRect(*cssClip);
+ aBuilder->IntersectVisibleRect(*cssClip);
+ aClipState.ClipContentDescendants(*cssClip + offset);
+ };
+
+ // The CSS clip property is effectively inside the transform, but outside the
+ // filters. So if we're not transformed we can apply it just here for
+ // simplicity, instead of on each of the places that handle clipCapturedBy.
+ DisplayListClipState::AutoSaveRestore untransformedCssClip(aBuilder);
+ if (!isTransformed) {
+ ApplyClipProp(untransformedCssClip);
+ }
+
+ // If there is a current clip, then depending on the container items we
+ // create, different things can happen to it. Some container items simply
+ // propagate the clip to their children and aren't clipped themselves.
+ // But other container items, especially those that establish a different
+ // geometry for their contents (e.g. transforms), capture the clip on
+ // themselves and unset the clip for their contents. If we create more than
+ // one of those container items, the clip will be captured on the outermost
+ // one and the inner container items will be unclipped.
+ ContainerItemType clipCapturedBy = ContainerItemType::None;
+ if (useFixedPosition) {
+ clipCapturedBy = ContainerItemType::FixedPosition;
+ } else if (isTransformed) {
+ const DisplayItemClipChain* currentClip =
+ aBuilder->ClipState().GetCurrentCombinedClipChain(aBuilder);
+ if ((hasPerspective || extend3DContext) &&
+ (currentClip && currentClip->HasRoundedCorners())) {
+ // If we're creating an nsDisplayTransform item that is going to combine
+ // its transform with its children (preserve-3d or perspective), then we
+ // can't have an intermediate surface. Mask layers force an intermediate
+ // surface, so if we're going to need both then create a separate
+ // wrapping layer for the mask.
+ clipCapturedBy = ContainerItemType::OwnLayerForTransformWithRoundedClip;
+ } else if (hasPerspective) {
+ clipCapturedBy = ContainerItemType::Perspective;
+ } else {
+ clipCapturedBy = ContainerItemType::Transform;
+ }
+ } else if (usingFilter) {
+ clipCapturedBy = ContainerItemType::Filter;
+ }
+
+ DisplayListClipState::AutoSaveRestore clipState(aBuilder);
+ if (clipCapturedBy != ContainerItemType::None) {
+ clipState.Clear();
+ }
+
+ DisplayListClipState::AutoSaveRestore transformedCssClip(aBuilder);
+ if (isTransformed) {
+ // FIXME(emilio, bug 1525159): In the case we have a both a transform _and_
+ // filters, this clips the input to the filters as well, which is not
+ // correct (clipping by the `clip` property is supposed to happen after
+ // applying the filter effects, per [1].
+ //
+ // This is not a regression though, since we used to do that anyway before
+ // bug 1514384, and even without the transform we get it wrong.
+ //
+ // [1]: https://drafts.fxtf.org/css-masking/#placement
+ ApplyClipProp(transformedCssClip);
+ }
+
+ nsDisplayListCollection set(aBuilder);
+ Maybe<nsRect> clipForMask;
+ {
+ DisplayListClipState::AutoSaveRestore nestedClipState(aBuilder);
+ nsDisplayListBuilder::AutoInTransformSetter inTransformSetter(aBuilder,
+ inTransform);
+ nsDisplayListBuilder::AutoEnterFilter filterASRSetter(aBuilder,
+ usingFilter);
+ nsDisplayListBuilder::AutoInEventsOnly inEventsSetter(
+ aBuilder, opacityItemForEventsOnly);
+
+ // If we have a mask, compute a clip to bound the masked content.
+ // This is necessary in case the content moves with an ancestor
+ // ASR of the mask.
+ // Don't do this if we also have a filter, because then the clip
+ // would be applied before the filter, violating
+ // https://www.w3.org/TR/filter-effects-1/#placement.
+ // Filters are a containing block for fixed and absolute descendants,
+ // so the masked content cannot move with an ancestor ASR.
+ if (usingMask && !usingFilter) {
+ clipForMask = ComputeClipForMaskItem(aBuilder, this, maskUsage);
+ if (clipForMask) {
+ aBuilder->IntersectDirtyRect(*clipForMask);
+ aBuilder->IntersectVisibleRect(*clipForMask);
+ nestedClipState.ClipContentDescendants(
+ *clipForMask + aBuilder->GetCurrentFrameOffsetToReferenceFrame());
+ }
+ }
+
+ // extend3DContext also guarantees that applyAbsPosClipping and
+ // usingSVGEffects are false We only modify the preserve-3d rect if we are
+ // the top of a preserve-3d heirarchy
+ if (extend3DContext) {
+ // Mark these first so MarkAbsoluteFramesForDisplayList knows if we are
+ // going to be forced to descend into frames.
+ aBuilder->MarkPreserve3DFramesForDisplayList(this);
+ }
+
+ aBuilder->AdjustWindowDraggingRegion(this);
+
+ MarkAbsoluteFramesForDisplayList(aBuilder);
+ aBuilder->Check();
+ BuildDisplayList(aBuilder, set);
+ SetBuiltDisplayList(true);
+ aBuilder->Check();
+ aBuilder->DisplayCaret(this, set.Outlines());
+
+ // Blend modes are a real pain for retained display lists. We build a blend
+ // container item if the built list contains any blend mode items within
+ // the current stacking context. This can change without an invalidation
+ // to the stacking context frame, or the blend mode frame (e.g. by moving
+ // an intermediate frame).
+ // When we gain/remove a blend container item, we need to mark this frame
+ // as invalid and have the full display list for merging to track
+ // the change correctly.
+ // It seems really hard to track this in advance, as the bookkeeping
+ // required to note which stacking contexts have blend descendants
+ // is complex and likely to be buggy.
+ // Instead we're doing the sad thing, detecting it afterwards, and just
+ // repeating display list building if it changed.
+ // We have to repeat building for the entire display list (or at least
+ // the outer stacking context), since we need to mark this frame as invalid
+ // to remove any existing content that isn't wrapped in the blend container,
+ // and then we need to build content infront/behind the blend container
+ // to get correct positioning during merging.
+ if (aBuilder->ContainsBlendMode() && aBuilder->IsRetainingDisplayList()) {
+ if (aBuilder->IsPartialUpdate()) {
+ aBuilder->SetPartialBuildFailed(true);
+ } else {
+ aBuilder->SetDisablePartialUpdates(true);
+ }
+ }
+ }
+
+ if (aBuilder->IsBackgroundOnly()) {
+ set.BlockBorderBackgrounds()->DeleteAll(aBuilder);
+ set.Floats()->DeleteAll(aBuilder);
+ set.Content()->DeleteAll(aBuilder);
+ set.PositionedDescendants()->DeleteAll(aBuilder);
+ set.Outlines()->DeleteAll(aBuilder);
+ }
+
+ if (hasOverrideDirtyRect &&
+ StaticPrefs::layout_display_list_show_rebuild_area()) {
+ nsDisplaySolidColor* color = MakeDisplayItem<nsDisplaySolidColor>(
+ aBuilder, this,
+ dirtyRect + aBuilder->GetCurrentFrameOffsetToReferenceFrame(),
+ NS_RGBA(255, 0, 0, 64), false);
+ if (color) {
+ color->SetOverrideZIndex(INT32_MAX);
+ set.PositionedDescendants()->AppendToTop(color);
+ }
+ }
+
+ nsIContent* content = GetContent();
+ if (!content) {
+ content = PresContext()->Document()->GetRootElement();
+ }
+
+ nsDisplayList resultList(aBuilder);
+ set.SerializeWithCorrectZOrder(&resultList, content);
+
+ // Get the ASR to use for the container items that we create here.
+ const ActiveScrolledRoot* containerItemASR = contASRTracker.GetContainerASR();
+
+ bool createdContainer = false;
+
+ // If adding both a nsDisplayBlendContainer and a nsDisplayBlendMode to the
+ // same list, the nsDisplayBlendContainer should be added first. This only
+ // happens when the element creating this stacking context has mix-blend-mode
+ // and also contains a child which has mix-blend-mode.
+ // The nsDisplayBlendContainer must be added to the list first, so it does not
+ // isolate the containing element blending as well.
+ if (aBuilder->ContainsBlendMode()) {
+ resultList.AppendToTop(nsDisplayBlendContainer::CreateForMixBlendMode(
+ aBuilder, this, &resultList, containerItemASR));
+ createdContainer = true;
+ }
+
+ if (usingBackdropFilter) {
+ nsRect backdropRect =
+ GetRectRelativeToSelf() + aBuilder->ToReferenceFrame(this);
+ resultList.AppendNewToTop<nsDisplayBackdropFilters>(
+ aBuilder, this, &resultList, backdropRect, this);
+ createdContainer = true;
+ }
+
+ // If there are any SVG effects, wrap the list up in an SVG effects item
+ // (which also handles CSS group opacity). Note that we create an SVG effects
+ // item even if resultList is empty, since a filter can produce graphical
+ // output even if the element being filtered wouldn't otherwise do so.
+ if (usingSVGEffects) {
+ MOZ_ASSERT(usingFilter || usingMask,
+ "Beside filter & mask/clip-path, what else effect do we have?");
+
+ if (clipCapturedBy == ContainerItemType::Filter) {
+ clipState.Restore();
+ }
+ // Revert to the post-filter dirty rect.
+ aBuilder->SetVisibleRect(visibleRectOutsideSVGEffects);
+
+ // Skip all filter effects while generating glyph mask.
+ if (usingFilter && !aBuilder->IsForGenerateGlyphMask()) {
+ /* List now emptied, so add the new list to the top. */
+ resultList.AppendNewToTop<nsDisplayFilters>(aBuilder, this, &resultList,
+ this, usingBackdropFilter);
+ createdContainer = true;
+ }
+
+ if (usingMask) {
+ // The mask should move with aBuilder->CurrentActiveScrolledRoot(), so
+ // that's the ASR we prefer to use for the mask item. However, we can
+ // only do this if the mask if clipped with respect to that ASR, because
+ // an item always needs to have finite bounds with respect to its ASR.
+ // If we weren't able to compute a clip for the mask, we fall back to
+ // using containerItemASR, which is the lowest common ancestor clip of
+ // the mask's contents. That's not entirely correct, but it satisfies
+ // the base requirement of the ASR system (that items have finite bounds
+ // wrt. their ASR).
+ const ActiveScrolledRoot* maskASR =
+ clipForMask.isSome() ? aBuilder->CurrentActiveScrolledRoot()
+ : containerItemASR;
+ /* List now emptied, so add the new list to the top. */
+ resultList.AppendNewToTop<nsDisplayMasksAndClipPaths>(
+ aBuilder, this, &resultList, maskASR, usingBackdropFilter);
+ createdContainer = true;
+ }
+
+ // TODO(miko): We could probably create a wraplist here and avoid creating
+ // it later in |BuildDisplayListForChild()|.
+ createdContainer = false;
+
+ // Also add the hoisted scroll info items. We need those for APZ scrolling
+ // because nsDisplayMasksAndClipPaths items can't build active layers.
+ aBuilder->ExitSVGEffectsContents();
+ resultList.AppendToTop(&hoistedScrollInfoItemsStorage);
+ }
+
+ // If the list is non-empty and there is CSS group opacity without SVG
+ // effects, wrap it up in an opacity item.
+ if (useOpacity) {
+ const bool needsActiveOpacityLayer =
+ nsDisplayOpacity::NeedsActiveLayer(aBuilder, this);
+ resultList.AppendNewToTop<nsDisplayOpacity>(
+ aBuilder, this, &resultList, containerItemASR, opacityItemForEventsOnly,
+ needsActiveOpacityLayer, usingBackdropFilter);
+ createdContainer = true;
+ }
+
+ // If we're going to apply a transformation and don't have preserve-3d set,
+ // wrap everything in an nsDisplayTransform. If there's nothing in the list,
+ // don't add anything.
+ //
+ // For the preserve-3d case we want to individually wrap every child in the
+ // list with a separate nsDisplayTransform instead. When the child is already
+ // an nsDisplayTransform, we can skip this step, as the computed transform
+ // will already include our own.
+ //
+ // We also traverse into sublists created by nsDisplayWrapList, so that we
+ // find all the correct children.
+ if (isTransformed && extend3DContext) {
+ // Install dummy nsDisplayTransform as a leaf containing
+ // descendants not participating this 3D rendering context.
+ nsDisplayList nonparticipants(aBuilder);
+ nsDisplayList participants(aBuilder);
+ int index = 1;
+
+ nsDisplayItem* separator = nullptr;
+
+ // TODO: This can be simplified: |participants| is just |resultList|.
+ for (nsDisplayItem* item : resultList.TakeItems()) {
+ if (ItemParticipatesIn3DContext(this, item) &&
+ !item->GetClip().HasClip()) {
+ // The frame of this item participates the same 3D context.
+ WrapSeparatorTransform(aBuilder, this, &nonparticipants, &participants,
+ index++, &separator);
+
+ participants.AppendToTop(item);
+ } else {
+ // The frame of the item doesn't participate the current
+ // context, or has no transform.
+ //
+ // For items participating but not transformed, they are add
+ // to nonparticipants to get a separator layer for handling
+ // clips, if there is, on an intermediate surface.
+ // \see ContainerLayer::DefaultComputeEffectiveTransforms().
+ nonparticipants.AppendToTop(item);
+ }
+ }
+ WrapSeparatorTransform(aBuilder, this, &nonparticipants, &participants,
+ index++, &separator);
+
+ if (separator) {
+ createdContainer = true;
+ }
+
+ resultList.AppendToTop(&participants);
+ }
+
+ if (isTransformed) {
+ transformedCssClip.Restore();
+ if (clipCapturedBy == ContainerItemType::Transform) {
+ // Restore clip state now so nsDisplayTransform is clipped properly.
+ clipState.Restore();
+ }
+ // Revert to the dirtyrect coming in from the parent, without our transform
+ // taken into account.
+ aBuilder->SetVisibleRect(visibleRectOutsideTransform);
+
+ if (this != aBuilder->RootReferenceFrame()) {
+ // Revert to the outer reference frame and offset because all display
+ // items we create from now on are outside the transform.
+ nsPoint toOuterReferenceFrame;
+ const nsIFrame* outerReferenceFrame =
+ aBuilder->FindReferenceFrameFor(GetParent(), &toOuterReferenceFrame);
+ toOuterReferenceFrame += GetPosition();
+
+ buildingDisplayList.SetReferenceFrameAndCurrentOffset(
+ outerReferenceFrame, toOuterReferenceFrame);
+ }
+
+ // We would like to block async animations for ancestors of ones not
+ // prerendered in the preserve-3d tree. Now that we've finished processing
+ // all descendants, update allowAsyncAnimation to take their prerender
+ // state into account
+ // FIXME: We don't block async animations for previous siblings because
+ // their prerender decisions have been made. We may have to figure out a
+ // better way to rollback their prerender decisions.
+ // Alternatively we could not block animations for later siblings, and only
+ // block them for ancestors of a blocked one.
+ if ((extend3DContext || combines3DTransformWithAncestors) &&
+ prerenderInfo.CanUseAsyncAnimations() &&
+ !aBuilder->GetPreserves3DAllowAsyncAnimation()) {
+ // aBuilder->GetPreserves3DAllowAsyncAnimation() means the inner or
+ // previous silbing frames are allowed/disallowed for async animations.
+ prerenderInfo.mDecision = nsDisplayTransform::PrerenderDecision::No;
+ }
+
+ nsDisplayTransform* transformItem = MakeDisplayItem<nsDisplayTransform>(
+ aBuilder, this, &resultList, visibleRect, prerenderInfo.mDecision);
+ if (transformItem) {
+ resultList.AppendToTop(transformItem);
+ createdContainer = true;
+ }
+
+ if (hasPerspective) {
+ transformItem->MarkWithAssociatedPerspective();
+
+ if (clipCapturedBy == ContainerItemType::Perspective) {
+ clipState.Restore();
+ }
+ resultList.AppendNewToTop<nsDisplayPerspective>(aBuilder, this,
+ &resultList);
+ createdContainer = true;
+ }
+ }
+
+ if (clipCapturedBy ==
+ ContainerItemType::OwnLayerForTransformWithRoundedClip) {
+ clipState.Restore();
+ resultList.AppendNewToTopWithIndex<nsDisplayOwnLayer>(
+ aBuilder, this,
+ /* aIndex = */ nsDisplayOwnLayer::OwnLayerForTransformWithRoundedClip,
+ &resultList, aBuilder->CurrentActiveScrolledRoot(),
+ nsDisplayOwnLayerFlags::None, ScrollbarData{},
+ /* aForceActive = */ false, false);
+ createdContainer = true;
+ }
+
+ // If we have sticky positioning, wrap it in a sticky position item.
+ if (useFixedPosition) {
+ if (clipCapturedBy == ContainerItemType::FixedPosition) {
+ clipState.Restore();
+ }
+ // The ASR for the fixed item should be the ASR of our containing block,
+ // which has been set as the builder's current ASR, unless this frame is
+ // invisible and we hadn't saved display item data for it. In that case,
+ // we need to take the containerItemASR since we might have fixed children.
+ // For WebRender, we want to the know what |containerItemASR| is for the
+ // case where the fixed-pos item is not a "real" fixed-pos item (e.g. it's
+ // nested inside a scrolling transform), so we stash that on the display
+ // item as well.
+ const ActiveScrolledRoot* fixedASR = ActiveScrolledRoot::PickAncestor(
+ containerItemASR, aBuilder->CurrentActiveScrolledRoot());
+ resultList.AppendNewToTop<nsDisplayFixedPosition>(
+ aBuilder, this, &resultList, fixedASR, containerItemASR);
+ createdContainer = true;
+ } else if (useStickyPosition) {
+ // For position:sticky, the clip needs to be applied both to the sticky
+ // container item and to the contents. The container item needs the clip
+ // because a scrolled clip needs to move independently from the sticky
+ // contents, and the contents need the clip so that they have finite
+ // clipped bounds with respect to the container item's ASR. The latter is
+ // a little tricky in the case where the sticky item has both fixed and
+ // non-fixed descendants, because that means that the sticky container
+ // item's ASR is the ASR of the fixed descendant.
+ // For WebRender display list building, though, we still want to know the
+ // the ASR that the sticky container item would normally have, so we stash
+ // that on the display item as the "container ASR" (i.e. the normal ASR of
+ // the container item, excluding the special behaviour induced by fixed
+ // descendants).
+ const ActiveScrolledRoot* stickyASR = ActiveScrolledRoot::PickAncestor(
+ containerItemASR, aBuilder->CurrentActiveScrolledRoot());
+
+ auto* stickyItem = MakeDisplayItem<nsDisplayStickyPosition>(
+ aBuilder, this, &resultList, stickyASR,
+ aBuilder->CurrentActiveScrolledRoot(),
+ clipState.IsClippedToDisplayPort());
+
+ bool shouldFlatten = true;
+
+ StickyScrollContainer* stickyScrollContainer =
+ StickyScrollContainer::GetStickyScrollContainerForFrame(this);
+ if (stickyScrollContainer &&
+ stickyScrollContainer->ScrollFrame()->IsMaybeAsynchronouslyScrolled()) {
+ shouldFlatten = false;
+ }
+
+ stickyItem->SetShouldFlatten(shouldFlatten);
+
+ resultList.AppendToTop(stickyItem);
+ createdContainer = true;
+
+ // If the sticky element is inside a filter, annotate the scroll frame that
+ // scrolls the filter as having out-of-flow content inside a filter (this
+ // inhibits paint skipping).
+ if (aBuilder->GetFilterASR() && aBuilder->GetFilterASR() == stickyASR) {
+ aBuilder->GetFilterASR()
+ ->mScrollableFrame->SetHasOutOfFlowContentInsideFilter();
+ }
+ }
+
+ // If there's blending, wrap up the list in a blend-mode item. Note that
+ // opacity can be applied before blending as the blend color is not affected
+ // by foreground opacity (only background alpha).
+ if (useBlendMode) {
+ DisplayListClipState::AutoSaveRestore blendModeClipState(aBuilder);
+ resultList.AppendNewToTop<nsDisplayBlendMode>(aBuilder, this, &resultList,
+ effects->mMixBlendMode,
+ containerItemASR, false);
+ createdContainer = true;
+ }
+
+ if (aBuilder->IsReusingStackingContextItems()) {
+ if (resultList.IsEmpty()) {
+ return;
+ }
+
+ nsDisplayItem* container = resultList.GetBottom();
+ if (resultList.Length() > 1 || container->Frame() != this) {
+ container = MakeDisplayItem<nsDisplayContainer>(
+ aBuilder, this, containerItemASR, &resultList);
+ } else {
+ MOZ_ASSERT(resultList.Length() == 1);
+ resultList.Clear();
+ }
+
+ // Mark the outermost display item as reusable. These display items and
+ // their chidren can be reused during the next paint if no ancestor or
+ // descendant frames have been modified.
+ if (!container->IsReusedItem()) {
+ container->SetReusable();
+ }
+ aList->AppendToTop(container);
+ createdContainer = true;
+ } else {
+ aList->AppendToTop(&resultList);
+ }
+
+ if (aCreatedContainerItem) {
+ *aCreatedContainerItem = createdContainer;
+ }
+}
+
+static nsDisplayItem* WrapInWrapList(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aFrame, nsDisplayList* aList,
+ const ActiveScrolledRoot* aContainerASR,
+ bool aBuiltContainerItem = false) {
+ nsDisplayItem* item = aList->GetBottom();
+ if (!item) {
+ return nullptr;
+ }
+
+ // We need a wrap list if there are multiple items, or if the single
+ // item has a different frame. This can change in a partial build depending
+ // on which items we build, so we need to ensure that we don't transition
+ // to/from a wrap list without invalidating correctly.
+ bool needsWrapList =
+ aList->Length() > 1 || item->Frame() != aFrame || item->GetChildren();
+
+ // If we have an explicit container item (that can't change without an
+ // invalidation) or we're doing a full build and don't need a wrap list, then
+ // we can skip adding one.
+ if (aBuiltContainerItem || (!aBuilder->IsPartialUpdate() && !needsWrapList)) {
+ MOZ_ASSERT(aList->Length() == 1);
+ aList->Clear();
+ return item;
+ }
+
+ // If we're doing a partial build and we didn't need a wrap list
+ // previously then we can try to work from there.
+ if (aBuilder->IsPartialUpdate() &&
+ !aFrame->HasDisplayItem(uint32_t(DisplayItemType::TYPE_CONTAINER))) {
+ // If we now need a wrap list, we must previously have had no display items
+ // or a single one belonging to this frame. Mark the item itself as
+ // discarded so that RetainedDisplayListBuilder uses the ones we just built.
+ // We don't want to mark the frame as modified as that would invalidate
+ // positioned descendants that might be outside of this list, and might not
+ // have been rebuilt this time.
+ if (needsWrapList) {
+ DiscardOldItems(aFrame);
+ } else {
+ MOZ_ASSERT(aList->Length() == 1);
+ aList->Clear();
+ return item;
+ }
+ }
+
+ // The last case we could try to handle is when we previously had a wrap list,
+ // but no longer need it. Unfortunately we can't differentiate this case from
+ // a partial build where other children exist but we just didn't build them
+ // this time.
+ // TODO:RetainedDisplayListBuilder's merge phase has the full list and
+ // could strip them out.
+
+ return MakeDisplayItem<nsDisplayContainer>(aBuilder, aFrame, aContainerASR,
+ aList);
+}
+
+/**
+ * Check if a frame should be visited for building display list.
+ */
+static bool DescendIntoChild(nsDisplayListBuilder* aBuilder,
+ const nsIFrame* aChild, const nsRect& aVisible,
+ const nsRect& aDirty) {
+ if (aChild->HasAnyStateBits(NS_FRAME_FORCE_DISPLAY_LIST_DESCEND_INTO)) {
+ return true;
+ }
+
+ // If the child is a scrollframe that we want to ignore, then we need
+ // to descend into it because its scrolled child may intersect the dirty
+ // area even if the scrollframe itself doesn't.
+ if (aChild == aBuilder->GetIgnoreScrollFrame()) {
+ return true;
+ }
+
+ // There are cases where the "ignore scroll frame" on the builder is not set
+ // correctly, and so we additionally want to catch cases where the child is
+ // a root scrollframe and we are ignoring scrolling on the viewport.
+ if (aChild == aBuilder->GetPresShellIgnoreScrollFrame()) {
+ return true;
+ }
+
+ nsRect overflow = aChild->InkOverflowRect();
+
+ // On mobile, there may be a dynamic toolbar. The root content document's
+ // root scroll frame's ink overflow rect does not include the toolbar
+ // height, but if the toolbar is hidden, we still want to be able to target
+ // content underneath the toolbar, so expand the overflow rect here to
+ // allow display list building to descend into the scroll frame.
+ if (aBuilder->IsForEventDelivery() &&
+ aChild == aChild->PresShell()->GetRootScrollFrame() &&
+ aChild->PresContext()->IsRootContentDocumentCrossProcess() &&
+ aChild->PresContext()->HasDynamicToolbar()) {
+ overflow.SizeTo(nsLayoutUtils::ExpandHeightForDynamicToolbar(
+ aChild->PresContext(), overflow.Size()));
+ }
+
+ if (aDirty.Intersects(overflow)) {
+ return true;
+ }
+
+ if (aChild->ForceDescendIntoIfVisible() && aVisible.Intersects(overflow)) {
+ return true;
+ }
+
+ if (aChild->IsTablePart()) {
+ // Relative positioning and transforms can cause table parts to move, but we
+ // will still paint the backgrounds for their ancestor parts under them at
+ // their 'normal' position. That means that we must consider the overflow
+ // rects at both positions.
+
+ // We convert the overflow rect into the nsTableFrame's coordinate
+ // space, applying the normal position offset at each step. Then we
+ // compare that against the builder's cached dirty rect in table
+ // coordinate space.
+ const nsIFrame* f = aChild;
+ nsRect normalPositionOverflowRelativeToTable = overflow;
+
+ while (f->IsTablePart()) {
+ normalPositionOverflowRelativeToTable += f->GetNormalPosition();
+ f = f->GetParent();
+ }
+
+ nsDisplayTableBackgroundSet* tableBGs = aBuilder->GetTableBackgroundSet();
+ if (tableBGs && tableBGs->GetDirtyRect().Intersects(
+ normalPositionOverflowRelativeToTable)) {
+ return true;
+ }
+ }
+
+ return false;
+}
+
+void nsIFrame::BuildDisplayListForSimpleChild(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aChild,
+ const nsDisplayListSet& aLists) {
+ // This is the shortcut for frames been handled along the common
+ // path, the most common one of THE COMMON CASE mentioned later.
+ MOZ_ASSERT(aChild->Type() != LayoutFrameType::Placeholder);
+ MOZ_ASSERT(!aBuilder->GetSelectedFramesOnly() &&
+ !aBuilder->GetIncludeAllOutOfFlows(),
+ "It should be held for painting to window");
+ MOZ_ASSERT(aChild->HasAnyStateBits(NS_FRAME_SIMPLE_DISPLAYLIST));
+
+ const nsPoint offset = aChild->GetOffsetTo(this);
+ const nsRect visible = aBuilder->GetVisibleRect() - offset;
+ const nsRect dirty = aBuilder->GetDirtyRect() - offset;
+
+ if (!DescendIntoChild(aBuilder, aChild, visible, dirty)) {
+ DL_LOGV("Skipped frame %p", aChild);
+ return;
+ }
+
+ // Child cannot be transformed since it is not a stacking context.
+ nsDisplayListBuilder::AutoBuildingDisplayList buildingForChild(
+ aBuilder, aChild, visible, dirty, false);
+
+ UpdateCurrentHitTestInfo(aBuilder, aChild);
+
+ aChild->MarkAbsoluteFramesForDisplayList(aBuilder);
+ aBuilder->AdjustWindowDraggingRegion(aChild);
+ aBuilder->Check();
+ aChild->BuildDisplayList(aBuilder, aLists);
+ aChild->SetBuiltDisplayList(true);
+ aBuilder->Check();
+ aBuilder->DisplayCaret(aChild, aLists.Outlines());
+}
+
+static bool ShouldSkipFrame(nsDisplayListBuilder* aBuilder,
+ const nsIFrame* aFrame) {
+ // If painting is restricted to just the background of the top level frame,
+ // then we have nothing to do here.
+ if (aBuilder->IsBackgroundOnly()) {
+ return true;
+ }
+ if (aBuilder->IsForGenerateGlyphMask() &&
+ (!aFrame->IsTextFrame() && aFrame->IsLeaf())) {
+ return true;
+ }
+ // The placeholder frame should have the same content as the OOF frame.
+ if (aBuilder->GetSelectedFramesOnly() &&
+ (aFrame->IsLeaf() && !aFrame->IsSelected())) {
+ return true;
+ }
+ static const nsFrameState skipFlags =
+ (NS_FRAME_TOO_DEEP_IN_FRAME_TREE | NS_FRAME_IS_NONDISPLAY);
+ if (aFrame->HasAnyStateBits(skipFlags)) {
+ return true;
+ }
+ return aFrame->StyleUIReset()->mMozSubtreeHiddenOnlyVisually;
+}
+
+void nsIFrame::BuildDisplayListForChild(nsDisplayListBuilder* aBuilder,
+ nsIFrame* aChild,
+ const nsDisplayListSet& aLists,
+ DisplayChildFlags aFlags) {
+ AutoCheckBuilder check(aBuilder);
+#ifdef DEBUG
+ DL_LOGV("BuildDisplayListForChild (%p) <", aChild);
+ ScopeExit e(
+ [aChild]() { DL_LOGV("> BuildDisplayListForChild (%p)", aChild); });
+#endif
+
+ if (ShouldSkipFrame(aBuilder, aChild)) {
+ return;
+ }
+
+ if (HidesContent()) {
+ return;
+ }
+
+ // If we're generating a display list for printing, include Link items for
+ // frames that correspond to HTML link elements so that we can have active
+ // links in saved PDF output. Note that the state of "within a link" is
+ // set on the display-list builder, such that all descendants of the link
+ // element will generate display-list links.
+ // TODO: we should be able to optimize this so as to avoid creating links
+ // for the same destination that entirely overlap each other, which adds
+ // nothing useful to the final PDF.
+ Maybe<nsDisplayListBuilder::Linkifier> linkifier;
+ if (StaticPrefs::print_save_as_pdf_links_enabled() &&
+ aBuilder->IsForPrinting()) {
+ linkifier.emplace(aBuilder, aChild, aLists.Content());
+ linkifier->MaybeAppendLink(aBuilder, aChild);
+ }
+
+ nsIFrame* child = aChild;
+ auto* placeholder = child->IsPlaceholderFrame()
+ ? static_cast<nsPlaceholderFrame*>(child)
+ : nullptr;
+ nsIFrame* childOrOutOfFlow =
+ placeholder ? placeholder->GetOutOfFlowFrame() : child;
+
+ nsIFrame* parent = childOrOutOfFlow->GetParent();
+ const auto* parentDisplay = parent->StyleDisplay();
+ const auto overflowClipAxes =
+ parent->ShouldApplyOverflowClipping(parentDisplay);
+
+ const bool isPaintingToWindow = aBuilder->IsPaintingToWindow();
+ const bool doingShortcut =
+ isPaintingToWindow &&
+ child->HasAnyStateBits(NS_FRAME_SIMPLE_DISPLAYLIST) &&
+ // Animations may change the stacking context state.
+ // ShouldApplyOverflowClipping is affected by the parent style, which does
+ // not invalidate the NS_FRAME_SIMPLE_DISPLAYLIST bit.
+ !(overflowClipAxes != PhysicalAxes::None ||
+ child->MayHaveTransformAnimation() || child->MayHaveOpacityAnimation());
+
+ if (aBuilder->IsForPainting()) {
+ aBuilder->ClearWillChangeBudgetStatus(child);
+ }
+
+ if (StaticPrefs::layout_css_scroll_anchoring_highlight()) {
+ if (child->FirstContinuation()->IsScrollAnchor()) {
+ nsRect bounds = child->GetContentRectRelativeToSelf() +
+ aBuilder->ToReferenceFrame(child);
+ nsDisplaySolidColor* color = MakeDisplayItem<nsDisplaySolidColor>(
+ aBuilder, child, bounds, NS_RGBA(255, 0, 255, 64));
+ if (color) {
+ color->SetOverrideZIndex(INT32_MAX);
+ aLists.PositionedDescendants()->AppendToTop(color);
+ }
+ }
+ }
+
+ if (doingShortcut) {
+ BuildDisplayListForSimpleChild(aBuilder, child, aLists);
+ return;
+ }
+
+ // dirty rect in child-relative coordinates
+ NS_ASSERTION(aBuilder->GetCurrentFrame() == this, "Wrong coord space!");
+ const nsPoint offset = child->GetOffsetTo(this);
+ nsRect visible = aBuilder->GetVisibleRect() - offset;
+ nsRect dirty = aBuilder->GetDirtyRect() - offset;
+
+ nsDisplayListBuilder::OutOfFlowDisplayData* savedOutOfFlowData = nullptr;
+ if (placeholder) {
+ if (placeholder->HasAnyStateBits(PLACEHOLDER_FOR_TOPLAYER)) {
+ // If the out-of-flow frame is in the top layer, the viewport frame
+ // will paint it. Skip it here. Note that, only out-of-flow frames
+ // with this property should be skipped, because non-HTML elements
+ // may stop their children from being out-of-flow. Those frames
+ // should still be handled in the normal in-flow path.
+ return;
+ }
+
+ child = childOrOutOfFlow;
+ if (aBuilder->IsForPainting()) {
+ aBuilder->ClearWillChangeBudgetStatus(child);
+ }
+
+ // If 'child' is a pushed float then it's owned by a block that's not an
+ // ancestor of the placeholder, and it will be painted by that block and
+ // should not be painted through the placeholder. Also recheck
+ // NS_FRAME_TOO_DEEP_IN_FRAME_TREE and NS_FRAME_IS_NONDISPLAY.
+ static const nsFrameState skipFlags =
+ (NS_FRAME_IS_PUSHED_FLOAT | NS_FRAME_TOO_DEEP_IN_FRAME_TREE |
+ NS_FRAME_IS_NONDISPLAY);
+ if (child->HasAnyStateBits(skipFlags) || nsLayoutUtils::IsPopup(child)) {
+ return;
+ }
+
+ MOZ_ASSERT(child->HasAnyStateBits(NS_FRAME_OUT_OF_FLOW));
+ savedOutOfFlowData = nsDisplayListBuilder::GetOutOfFlowData(child);
+
+ if (aBuilder->GetIncludeAllOutOfFlows()) {
+ visible = child->InkOverflowRect();
+ dirty = child->InkOverflowRect();
+ } else if (savedOutOfFlowData) {
+ visible =
+ savedOutOfFlowData->GetVisibleRectForFrame(aBuilder, child, &dirty);
+ } else {
+ // The out-of-flow frame did not intersect the dirty area. We may still
+ // need to traverse into it, since it may contain placeholders we need
+ // to enter to reach other out-of-flow frames that are visible.
+ visible.SetEmpty();
+ dirty.SetEmpty();
+ }
+ }
+
+ NS_ASSERTION(!child->IsPlaceholderFrame(),
+ "Should have dealt with placeholders already");
+
+ if (!DescendIntoChild(aBuilder, child, visible, dirty)) {
+ DL_LOGV("Skipped frame %p", child);
+ return;
+ }
+
+ const bool isSVG = child->HasAnyStateBits(NS_FRAME_SVG_LAYOUT);
+
+ // This flag is raised if the control flow strays off the common path.
+ // The common path is the most common one of THE COMMON CASE mentioned later.
+ bool awayFromCommonPath = !isPaintingToWindow;
+
+ // true if this is a real or pseudo stacking context
+ bool pseudoStackingContext =
+ aFlags.contains(DisplayChildFlag::ForcePseudoStackingContext);
+
+ if (!pseudoStackingContext && !isSVG &&
+ aFlags.contains(DisplayChildFlag::Inline) &&
+ !child->IsLineParticipant()) {
+ // child is a non-inline frame in an inline context, i.e.,
+ // it acts like inline-block or inline-table. Therefore it is a
+ // pseudo-stacking-context.
+ pseudoStackingContext = true;
+ }
+
+ const nsStyleDisplay* ourDisp = StyleDisplay();
+ // Don't paint our children if the theme object is a leaf.
+ if (IsThemed(ourDisp) && !PresContext()->Theme()->WidgetIsContainer(
+ ourDisp->EffectiveAppearance())) {
+ return;
+ }
+
+ // Since we're now sure that we're adding this frame to the display list
+ // (which means we're painting it, modulo occlusion), mark it as visible
+ // within the displayport.
+ if (isPaintingToWindow && child->TrackingVisibility() &&
+ child->IsVisibleForPainting()) {
+ child->PresShell()->EnsureFrameInApproximatelyVisibleList(child);
+ awayFromCommonPath = true;
+ }
+
+ // Child is composited if it's transformed, partially transparent, or has
+ // SVG effects or a blend mode..
+ const nsStyleDisplay* disp = child->StyleDisplay();
+ const nsStyleEffects* effects = child->StyleEffects();
+
+ const bool isPositioned = disp->IsPositionedStyle();
+ const bool isStackingContext =
+ aFlags.contains(DisplayChildFlag::ForceStackingContext) ||
+ child->IsStackingContext(disp, effects);
+
+ if (pseudoStackingContext || isStackingContext || isPositioned ||
+ placeholder || (!isSVG && disp->IsFloating(child)) ||
+ (isSVG && effects->mClip.IsRect() && IsSVGContentWithCSSClip(child))) {
+ pseudoStackingContext = true;
+ awayFromCommonPath = true;
+ }
+
+ NS_ASSERTION(!isStackingContext || pseudoStackingContext,
+ "Stacking contexts must also be pseudo-stacking-contexts");
+
+ nsDisplayListBuilder::AutoBuildingDisplayList buildingForChild(
+ aBuilder, child, visible, dirty);
+
+ UpdateCurrentHitTestInfo(aBuilder, child);
+
+ DisplayListClipState::AutoClipMultiple clipState(aBuilder);
+ nsDisplayListBuilder::AutoCurrentActiveScrolledRootSetter asrSetter(aBuilder);
+
+ if (savedOutOfFlowData) {
+ aBuilder->SetBuildingInvisibleItems(false);
+
+ clipState.SetClipChainForContainingBlockDescendants(
+ savedOutOfFlowData->mContainingBlockClipChain);
+ asrSetter.SetCurrentActiveScrolledRoot(
+ savedOutOfFlowData->mContainingBlockActiveScrolledRoot);
+ asrSetter.SetCurrentScrollParentId(savedOutOfFlowData->mScrollParentId);
+ MOZ_ASSERT(awayFromCommonPath,
+ "It is impossible when savedOutOfFlowData is true");
+ } else if (HasAnyStateBits(NS_FRAME_FORCE_DISPLAY_LIST_DESCEND_INTO) &&
+ placeholder) {
+ NS_ASSERTION(visible.IsEmpty(), "should have empty visible rect");
+ // Every item we build from now until we descent into an out of flow that
+ // does have saved out of flow data should be invisible. This state gets
+ // restored when AutoBuildingDisplayList gets out of scope.
+ aBuilder->SetBuildingInvisibleItems(true);
+
+ // If we have nested out-of-flow frames and the outer one isn't visible
+ // then we won't have stored clip data for it. We can just clear the clip
+ // instead since we know we won't render anything, and the inner out-of-flow
+ // frame will setup the correct clip for itself.
+ clipState.SetClipChainForContainingBlockDescendants(nullptr);
+ }
+
+ // Setup clipping for the parent's overflow:clip,
+ // or overflow:hidden on elements that don't support scrolling (and therefore
+ // don't create nsHTML/XULScrollFrame). This clipping needs to not clip
+ // anything directly rendered by the parent, only the rendering of its
+ // children.
+ // Don't use overflowClip to restrict the dirty rect, since some of the
+ // descendants may not be clipped by it. Even if we end up with unnecessary
+ // display items, they'll be pruned during ComputeVisibility.
+ //
+ // FIXME(emilio): Why can't we handle this more similarly to `clip` (on the
+ // parent, rather than on the children)? Would ClipContentDescendants do what
+ // we want?
+ if (overflowClipAxes != PhysicalAxes::None) {
+ ApplyOverflowClipping(aBuilder, parent, overflowClipAxes, clipState);
+ awayFromCommonPath = true;
+ }
+
+ nsDisplayList list(aBuilder);
+ nsDisplayList extraPositionedDescendants(aBuilder);
+ const ActiveScrolledRoot* wrapListASR;
+ bool builtContainerItem = false;
+ if (isStackingContext) {
+ // True stacking context.
+ // For stacking contexts, BuildDisplayListForStackingContext handles
+ // clipping and MarkAbsoluteFramesForDisplayList.
+ nsDisplayListBuilder::AutoContainerASRTracker contASRTracker(aBuilder);
+ child->BuildDisplayListForStackingContext(aBuilder, &list,
+ &builtContainerItem);
+ wrapListASR = contASRTracker.GetContainerASR();
+ if (!aBuilder->IsReusingStackingContextItems() &&
+ aBuilder->GetCaretFrame() == child) {
+ builtContainerItem = false;
+ }
+ } else {
+ Maybe<nsRect> clipPropClip =
+ child->GetClipPropClipRect(disp, effects, child->GetSize());
+ if (clipPropClip) {
+ aBuilder->IntersectVisibleRect(*clipPropClip);
+ aBuilder->IntersectDirtyRect(*clipPropClip);
+ clipState.ClipContentDescendants(*clipPropClip +
+ aBuilder->ToReferenceFrame(child));
+ awayFromCommonPath = true;
+ }
+
+ child->MarkAbsoluteFramesForDisplayList(aBuilder);
+ child->SetBuiltDisplayList(true);
+
+ // Some SVG frames might change opacity without invalidating the frame, so
+ // exclude them from the fast-path.
+ if (!awayFromCommonPath && !child->IsSVGFrame()) {
+ // The shortcut is available for the child for next time.
+ child->AddStateBits(NS_FRAME_SIMPLE_DISPLAYLIST);
+ }
+
+ if (!pseudoStackingContext) {
+ // THIS IS THE COMMON CASE.
+ // Not a pseudo or real stacking context. Do the simple thing and
+ // return early.
+ aBuilder->AdjustWindowDraggingRegion(child);
+ aBuilder->Check();
+ child->BuildDisplayList(aBuilder, aLists);
+ aBuilder->Check();
+ aBuilder->DisplayCaret(child, aLists.Outlines());
+ return;
+ }
+
+ // A pseudo-stacking context (e.g., a positioned element with z-index auto).
+ // We allow positioned descendants of the child to escape to our parent
+ // stacking context's positioned descendant list, because they might be
+ // z-index:non-auto
+ nsDisplayListCollection pseudoStack(aBuilder);
+
+ aBuilder->AdjustWindowDraggingRegion(child);
+ nsDisplayListBuilder::AutoContainerASRTracker contASRTracker(aBuilder);
+ aBuilder->Check();
+ child->BuildDisplayList(aBuilder, pseudoStack);
+ aBuilder->Check();
+ if (aBuilder->DisplayCaret(child, pseudoStack.Outlines())) {
+ builtContainerItem = false;
+ }
+ wrapListASR = contASRTracker.GetContainerASR();
+
+ list.AppendToTop(pseudoStack.BorderBackground());
+ list.AppendToTop(pseudoStack.BlockBorderBackgrounds());
+ list.AppendToTop(pseudoStack.Floats());
+ list.AppendToTop(pseudoStack.Content());
+ list.AppendToTop(pseudoStack.Outlines());
+ extraPositionedDescendants.AppendToTop(pseudoStack.PositionedDescendants());
+ }
+
+ buildingForChild.RestoreBuildingInvisibleItemsValue();
+
+ if (!list.IsEmpty()) {
+ if (isPositioned || isStackingContext) {
+ // Genuine stacking contexts, and positioned pseudo-stacking-contexts,
+ // go in this level.
+ nsDisplayItem* item = WrapInWrapList(aBuilder, child, &list, wrapListASR,
+ builtContainerItem);
+ if (isSVG) {
+ aLists.Content()->AppendToTop(item);
+ } else {
+ aLists.PositionedDescendants()->AppendToTop(item);
+ }
+ } else if (!isSVG && disp->IsFloating(child)) {
+ aLists.Floats()->AppendToTop(
+ WrapInWrapList(aBuilder, child, &list, wrapListASR));
+ } else {
+ aLists.Content()->AppendToTop(&list);
+ }
+ }
+ // We delay placing the positioned descendants of positioned frames to here,
+ // because in the absence of z-index this is the correct order for them.
+ // This doesn't affect correctness because the positioned descendants list
+ // is sorted by z-order and content in BuildDisplayListForStackingContext,
+ // but it means that sort routine needs to do less work.
+ aLists.PositionedDescendants()->AppendToTop(&extraPositionedDescendants);
+}
+
+void nsIFrame::MarkAbsoluteFramesForDisplayList(
+ nsDisplayListBuilder* aBuilder) {
+ if (IsAbsoluteContainer()) {
+ aBuilder->MarkFramesForDisplayList(
+ this, GetAbsoluteContainingBlock()->GetChildList());
+ }
+}
+
+nsresult nsIFrame::GetContentForEvent(const WidgetEvent* aEvent,
+ nsIContent** aContent) {
+ nsIFrame* f = nsLayoutUtils::GetNonGeneratedAncestor(this);
+ *aContent = f->GetContent();
+ NS_IF_ADDREF(*aContent);
+ return NS_OK;
+}
+
+void nsIFrame::FireDOMEvent(const nsAString& aDOMEventName,
+ nsIContent* aContent) {
+ nsIContent* target = aContent ? aContent : GetContent();
+
+ if (target) {
+ RefPtr<AsyncEventDispatcher> asyncDispatcher = new AsyncEventDispatcher(
+ target, aDOMEventName, CanBubble::eYes, ChromeOnlyDispatch::eNo);
+ DebugOnly<nsresult> rv = asyncDispatcher->PostDOMEvent();
+ NS_ASSERTION(NS_SUCCEEDED(rv), "AsyncEventDispatcher failed to dispatch");
+ }
+}
+
+nsresult nsIFrame::HandleEvent(nsPresContext* aPresContext,
+ WidgetGUIEvent* aEvent,
+ nsEventStatus* aEventStatus) {
+ if (aEvent->mMessage == eMouseMove) {
+ // XXX If the second argument of HandleDrag() is WidgetMouseEvent,
+ // the implementation becomes simpler.
+ return HandleDrag(aPresContext, aEvent, aEventStatus);
+ }
+
+ if ((aEvent->mClass == eMouseEventClass &&
+ aEvent->AsMouseEvent()->mButton == MouseButton::ePrimary) ||
+ aEvent->mClass == eTouchEventClass) {
+ if (aEvent->mMessage == eMouseDown || aEvent->mMessage == eTouchStart) {
+ HandlePress(aPresContext, aEvent, aEventStatus);
+ } else if (aEvent->mMessage == eMouseUp || aEvent->mMessage == eTouchEnd) {
+ HandleRelease(aPresContext, aEvent, aEventStatus);
+ }
+ return NS_OK;
+ }
+
+ // When secondary buttion is down, we need to move selection to make users
+ // possible to paste something at click point quickly.
+ // When middle button is down, we need to just move selection and focus at
+ // the clicked point. Note that even if middle click paste is not enabled,
+ // Chrome moves selection at middle mouse button down. So, we should follow
+ // the behavior for the compatibility.
+ if (aEvent->mMessage == eMouseDown) {
+ WidgetMouseEvent* mouseEvent = aEvent->AsMouseEvent();
+ if (mouseEvent && (mouseEvent->mButton == MouseButton::eSecondary ||
+ mouseEvent->mButton == MouseButton::eMiddle)) {
+ if (*aEventStatus == nsEventStatus_eConsumeNoDefault) {
+ return NS_OK;
+ }
+ return MoveCaretToEventPoint(aPresContext, mouseEvent, aEventStatus);
+ }
+ }
+
+ return NS_OK;
+}
+
+nsresult nsIFrame::GetDataForTableSelection(
+ const nsFrameSelection* aFrameSelection, mozilla::PresShell* aPresShell,
+ WidgetMouseEvent* aMouseEvent, nsIContent** aParentContent,
+ int32_t* aContentOffset, TableSelectionMode* aTarget) {
+ if (!aFrameSelection || !aPresShell || !aMouseEvent || !aParentContent ||
+ !aContentOffset || !aTarget)
+ return NS_ERROR_NULL_POINTER;
+
+ *aParentContent = nullptr;
+ *aContentOffset = 0;
+ *aTarget = TableSelectionMode::None;
+
+ int16_t displaySelection = aPresShell->GetSelectionFlags();
+
+ bool selectingTableCells = aFrameSelection->IsInTableSelectionMode();
+
+ // DISPLAY_ALL means we're in an editor.
+ // If already in cell selection mode,
+ // continue selecting with mouse drag or end on mouse up,
+ // or when using shift key to extend block of cells
+ // (Mouse down does normal selection unless Ctrl/Cmd is pressed)
+ bool doTableSelection =
+ displaySelection == nsISelectionDisplay::DISPLAY_ALL &&
+ selectingTableCells &&
+ (aMouseEvent->mMessage == eMouseMove ||
+ (aMouseEvent->mMessage == eMouseUp &&
+ aMouseEvent->mButton == MouseButton::ePrimary) ||
+ aMouseEvent->IsShift());
+
+ if (!doTableSelection) {
+ // In Browser, special 'table selection' key must be pressed for table
+ // selection or when just Shift is pressed and we're already in table/cell
+ // selection mode
+#ifdef XP_MACOSX
+ doTableSelection = aMouseEvent->IsMeta() ||
+ (aMouseEvent->IsShift() && selectingTableCells);
+#else
+ doTableSelection = aMouseEvent->IsControl() ||
+ (aMouseEvent->IsShift() && selectingTableCells);
+#endif
+ }
+ if (!doTableSelection) return NS_OK;
+
+ // Get the cell frame or table frame (or parent) of the current content node
+ nsIFrame* frame = this;
+ bool foundCell = false;
+ bool foundTable = false;
+
+ // Get the limiting node to stop parent frame search
+ nsIContent* limiter = aFrameSelection->GetLimiter();
+
+ // If our content node is an ancestor of the limiting node,
+ // we should stop the search right now.
+ if (limiter && limiter->IsInclusiveDescendantOf(GetContent())) return NS_OK;
+
+ // We don't initiate row/col selection from here now,
+ // but we may in future
+ // bool selectColumn = false;
+ // bool selectRow = false;
+
+ while (frame) {
+ // Check for a table cell by querying to a known CellFrame interface
+ nsITableCellLayout* cellElement = do_QueryFrame(frame);
+ if (cellElement) {
+ foundCell = true;
+ // TODO: If we want to use proximity to top or left border
+ // for row and column selection, this is the place to do it
+ break;
+ } else {
+ // If not a cell, check for table
+ // This will happen when starting frame is the table or child of a table,
+ // such as a row (we were inbetween cells or in table border)
+ nsTableWrapperFrame* tableFrame = do_QueryFrame(frame);
+ if (tableFrame) {
+ foundTable = true;
+ // TODO: How can we select row when along left table edge
+ // or select column when along top edge?
+ break;
+ } else {
+ frame = frame->GetParent();
+ // Stop if we have hit the selection's limiting content node
+ if (frame && frame->GetContent() == limiter) break;
+ }
+ }
+ }
+ // We aren't in a cell or table
+ if (!foundCell && !foundTable) return NS_OK;
+
+ nsIContent* tableOrCellContent = frame->GetContent();
+ if (!tableOrCellContent) return NS_ERROR_FAILURE;
+
+ nsCOMPtr<nsIContent> parentContent = tableOrCellContent->GetParent();
+ if (!parentContent) return NS_ERROR_FAILURE;
+
+ const int32_t offset =
+ parentContent->ComputeIndexOf_Deprecated(tableOrCellContent);
+ // Not likely?
+ if (offset < 0) {
+ return NS_ERROR_FAILURE;
+ }
+
+ // Everything is OK -- set the return values
+ parentContent.forget(aParentContent);
+
+ *aContentOffset = offset;
+
+#if 0
+ if (selectRow)
+ *aTarget = TableSelectionMode::Row;
+ else if (selectColumn)
+ *aTarget = TableSelectionMode::Column;
+ else
+#endif
+ if (foundCell) {
+ *aTarget = TableSelectionMode::Cell;
+ } else if (foundTable) {
+ *aTarget = TableSelectionMode::Table;
+ }
+
+ return NS_OK;
+}
+
+static bool IsEditingHost(const nsIFrame* aFrame) {
+ nsIContent* content = aFrame->GetContent();
+ return content && content->IsEditingHost();
+}
+
+static StyleUserSelect UsedUserSelect(const nsIFrame* aFrame) {
+ if (aFrame->IsGeneratedContentFrame()) {
+ return StyleUserSelect::None;
+ }
+
+ // Per https://drafts.csswg.org/css-ui-4/#content-selection:
+ //
+ // The used value is the same as the computed value, except:
+ //
+ // 1 - on editable elements where the used value is always 'contain'
+ // regardless of the computed value
+ // 2 - when the computed value is auto, in which case the used value is one
+ // of the other values...
+ //
+ // See https://github.com/w3c/csswg-drafts/issues/3344 to see why we do this
+ // at used-value time instead of at computed-value time.
+
+ if (aFrame->IsTextInputFrame() || IsEditingHost(aFrame)) {
+ // We don't implement 'contain' itself, but we make 'text' behave as
+ // 'contain' for contenteditable and <input> / <textarea> elements anyway so
+ // this is ok.
+ return StyleUserSelect::Text;
+ }
+
+ auto style = aFrame->Style()->UserSelect();
+ if (style != StyleUserSelect::Auto) {
+ return style;
+ }
+
+ auto* parent = nsLayoutUtils::GetParentOrPlaceholderFor(aFrame);
+ return parent ? UsedUserSelect(parent) : StyleUserSelect::Text;
+}
+
+bool nsIFrame::IsSelectable(StyleUserSelect* aSelectStyle) const {
+ auto style = UsedUserSelect(this);
+ if (aSelectStyle) {
+ *aSelectStyle = style;
+ }
+ return style != StyleUserSelect::None;
+}
+
+bool nsIFrame::ShouldHaveLineIfEmpty() const {
+ if (Style()->IsPseudoOrAnonBox() &&
+ Style()->GetPseudoType() != PseudoStyleType::scrolledContent) {
+ return false;
+ }
+ return IsEditingHost(this);
+}
+
+/**
+ * Handles the Mouse Press Event for the frame
+ */
+NS_IMETHODIMP
+nsIFrame::HandlePress(nsPresContext* aPresContext, WidgetGUIEvent* aEvent,
+ nsEventStatus* aEventStatus) {
+ NS_ENSURE_ARG_POINTER(aEventStatus);
+ if (nsEventStatus_eConsumeNoDefault == *aEventStatus) {
+ return NS_OK;
+ }
+
+ NS_ENSURE_ARG_POINTER(aEvent);
+ if (aEvent->mClass == eTouchEventClass) {
+ return NS_OK;
+ }
+
+ return MoveCaretToEventPoint(aPresContext, aEvent->AsMouseEvent(),
+ aEventStatus);
+}
+
+nsresult nsIFrame::MoveCaretToEventPoint(nsPresContext* aPresContext,
+ WidgetMouseEvent* aMouseEvent,
+ nsEventStatus* aEventStatus) {
+ MOZ_ASSERT(aPresContext);
+ MOZ_ASSERT(aMouseEvent);
+ MOZ_ASSERT(aMouseEvent->mMessage == eMouseDown);
+ MOZ_ASSERT(aEventStatus);
+ MOZ_ASSERT(nsEventStatus_eConsumeNoDefault != *aEventStatus);
+
+ mozilla::PresShell* presShell = aPresContext->GetPresShell();
+ if (!presShell) {
+ return NS_ERROR_FAILURE;
+ }
+
+ // We often get out of sync state issues with mousedown events that
+ // get interrupted by alerts/dialogs.
+ // Check with the ESM to see if we should process this one
+ if (!aPresContext->EventStateManager()->EventStatusOK(aMouseEvent)) {
+ return NS_OK;
+ }
+
+ const nsPoint pt = nsLayoutUtils::GetEventCoordinatesRelativeTo(
+ aMouseEvent, RelativeTo{this});
+
+ // When not using `alt`, and clicking on a draggable, but non-editable
+ // element, don't do anything, and let d&d handle the event.
+ //
+ // See bug 48876, bug 388659 and bug 55921 for context here.
+ //
+ // FIXME(emilio): The .Contains(pt) check looks a bit fishy. When would it be
+ // false given we're the event target? If it is needed, why not checking the
+ // actual draggable node rect instead?
+ if (!aMouseEvent->IsAlt() && GetRectRelativeToSelf().Contains(pt)) {
+ for (nsIContent* content = mContent; content;
+ content = content->GetFlattenedTreeParent()) {
+ if (nsContentUtils::ContentIsDraggable(content) &&
+ !content->IsEditable()) {
+ return NS_OK;
+ }
+ }
+ }
+
+ // If we are in Navigator and the click is in a draggable node, we don't want
+ // to start selection because we don't want to interfere with a potential
+ // drag of said node and steal all its glory.
+ const bool isEditor =
+ presShell->GetSelectionFlags() == nsISelectionDisplay::DISPLAY_ALL;
+
+ // Don't do something if it's middle button down event.
+ const bool isPrimaryButtonDown =
+ aMouseEvent->mButton == MouseButton::ePrimary;
+
+ // check whether style allows selection
+ // if not, don't tell selection the mouse event even occurred.
+ StyleUserSelect selectStyle;
+ // check for select: none
+ if (!IsSelectable(&selectStyle)) {
+ return NS_OK;
+ }
+
+ if (isPrimaryButtonDown) {
+ // If the mouse is dragged outside the nearest enclosing scrollable area
+ // while making a selection, the area will be scrolled. To do this, capture
+ // the mouse on the nearest scrollable frame. If there isn't a scrollable
+ // frame, or something else is already capturing the mouse, there's no
+ // reason to capture.
+ if (!PresShell::GetCapturingContent()) {
+ nsIScrollableFrame* scrollFrame =
+ nsLayoutUtils::GetNearestScrollableFrame(
+ this, nsLayoutUtils::SCROLLABLE_SAME_DOC |
+ nsLayoutUtils::SCROLLABLE_INCLUDE_HIDDEN);
+ if (scrollFrame) {
+ nsIFrame* capturingFrame = do_QueryFrame(scrollFrame);
+ PresShell::SetCapturingContent(capturingFrame->GetContent(),
+ CaptureFlags::IgnoreAllowedState);
+ }
+ }
+ }
+
+ // XXX This is screwy; it really should use the selection frame, not the
+ // event frame
+ const nsFrameSelection* frameselection =
+ selectStyle == StyleUserSelect::Text ? GetConstFrameSelection()
+ : presShell->ConstFrameSelection();
+
+ if (!frameselection || frameselection->GetDisplaySelection() ==
+ nsISelectionController::SELECTION_OFF) {
+ return NS_OK; // nothing to do we cannot affect selection from here
+ }
+
+#ifdef XP_MACOSX
+ // If Control key is pressed on macOS, it should be treated as right click.
+ // So, don't change selection.
+ if (aMouseEvent->IsControl()) {
+ return NS_OK;
+ }
+ const bool control = aMouseEvent->IsMeta();
+#else
+ const bool control = aMouseEvent->IsControl();
+#endif
+
+ RefPtr<nsFrameSelection> fc = const_cast<nsFrameSelection*>(frameselection);
+ if (isPrimaryButtonDown && aMouseEvent->mClickCount > 1) {
+ // These methods aren't const but can't actually delete anything,
+ // so no need for AutoWeakFrame.
+ fc->SetDragState(true);
+ return HandleMultiplePress(aPresContext, aMouseEvent, aEventStatus,
+ control);
+ }
+
+ ContentOffsets offsets = GetContentOffsetsFromPoint(pt, SKIP_HIDDEN);
+
+ if (!offsets.content) {
+ return NS_ERROR_FAILURE;
+ }
+
+ const bool isSecondaryButton =
+ aMouseEvent->mButton == MouseButton::eSecondary;
+ if (isSecondaryButton &&
+ !MovingCaretToEventPointAllowedIfSecondaryButtonEvent(
+ *frameselection, *aMouseEvent, *offsets.content,
+ // When we collapse selection in nsFrameSelection::TakeFocus,
+ // we always collapse selection to the start offset. Therefore,
+ // we can ignore the end offset here. E.g., when an <img> is clicked,
+ // set the primary offset to after it, but the the secondary offset
+ // may be before it, see OffsetsForSingleFrame for the detail.
+ offsets.StartOffset())) {
+ return NS_OK;
+ }
+
+ if (aMouseEvent->mMessage == eMouseDown &&
+ aMouseEvent->mButton == MouseButton::eMiddle &&
+ !offsets.content->IsEditable()) {
+ // However, some users don't like the Chrome compatible behavior of
+ // middle mouse click. They want to keep selection after starting
+ // autoscroll. However, the selection change is important for middle
+ // mouse past. Therefore, we should allow users to take the traditional
+ // behavior back by themselves unless middle click paste is enabled or
+ // autoscrolling is disabled.
+ if (!Preferences::GetBool("middlemouse.paste", false) &&
+ Preferences::GetBool("general.autoScroll", false) &&
+ Preferences::GetBool("general.autoscroll.prevent_to_collapse_selection_"
+ "by_middle_mouse_down",
+ false)) {
+ return NS_OK;
+ }
+ }
+
+ if (isPrimaryButtonDown) {
+ // Let Ctrl/Cmd + left mouse down do table selection instead of drag
+ // initiation.
+ nsCOMPtr<nsIContent> parentContent;
+ int32_t contentOffset;
+ TableSelectionMode target;
+ nsresult rv = GetDataForTableSelection(
+ frameselection, presShell, aMouseEvent, getter_AddRefs(parentContent),
+ &contentOffset, &target);
+ if (NS_SUCCEEDED(rv) && parentContent) {
+ fc->SetDragState(true);
+ return fc->HandleTableSelection(parentContent, contentOffset, target,
+ aMouseEvent);
+ }
+ }
+
+ fc->SetDelayedCaretData(0);
+
+ if (isPrimaryButtonDown) {
+ // Check if any part of this frame is selected, and if the user clicked
+ // inside the selected region, and if it's the left button. If so, we delay
+ // starting a new selection since the user may be trying to drag the
+ // selected region to some other app.
+
+ if (GetContent() && GetContent()->IsMaybeSelected()) {
+ bool inSelection = false;
+ UniquePtr<SelectionDetails> details = frameselection->LookUpSelection(
+ offsets.content, 0, offsets.EndOffset(), false);
+
+ //
+ // If there are any details, check to see if the user clicked
+ // within any selected region of the frame.
+ //
+
+ for (SelectionDetails* curDetail = details.get(); curDetail;
+ curDetail = curDetail->mNext.get()) {
+ //
+ // If the user clicked inside a selection, then just
+ // return without doing anything. We will handle placing
+ // the caret later on when the mouse is released. We ignore
+ // the spellcheck, find and url formatting selections.
+ //
+ if (curDetail->mSelectionType != SelectionType::eSpellCheck &&
+ curDetail->mSelectionType != SelectionType::eFind &&
+ curDetail->mSelectionType != SelectionType::eURLSecondary &&
+ curDetail->mSelectionType != SelectionType::eURLStrikeout &&
+ curDetail->mSelectionType != SelectionType::eHighlight &&
+ curDetail->mStart <= offsets.StartOffset() &&
+ offsets.EndOffset() <= curDetail->mEnd) {
+ inSelection = true;
+ }
+ }
+
+ if (inSelection) {
+ fc->SetDragState(false);
+ fc->SetDelayedCaretData(aMouseEvent);
+ return NS_OK;
+ }
+ }
+
+ fc->SetDragState(true);
+ }
+
+ // Do not touch any nsFrame members after this point without adding
+ // weakFrame checks.
+ const nsFrameSelection::FocusMode focusMode = [&]() {
+ // If "Shift" and "Ctrl" are both pressed, "Shift" is given precedence. This
+ // mimics the old behaviour.
+ const bool isShift =
+ aMouseEvent->IsShift() &&
+ // If Shift + secondary button press shoud open context menu without a
+ // contextmenu event, user wants to open context menu like as a
+ // secondary button press without Shift key.
+ !(isSecondaryButton &&
+ StaticPrefs::dom_event_contextmenu_shift_suppresses_event());
+ if (isShift) {
+ // If clicked in a link when focused content is editable, we should
+ // collapse selection in the link for compatibility with Blink.
+ if (isEditor) {
+ for (Element* element : mContent->InclusiveAncestorsOfType<Element>()) {
+ if (element->IsLink()) {
+ return nsFrameSelection::FocusMode::kCollapseToNewPoint;
+ }
+ }
+ }
+ return nsFrameSelection::FocusMode::kExtendSelection;
+ }
+
+ if (isPrimaryButtonDown && control) {
+ return nsFrameSelection::FocusMode::kMultiRangeSelection;
+ }
+
+ return nsFrameSelection::FocusMode::kCollapseToNewPoint;
+ }();
+
+ nsresult rv = fc->HandleClick(
+ MOZ_KnownLive(offsets.content) /* bug 1636889 */, offsets.StartOffset(),
+ offsets.EndOffset(), focusMode, offsets.associate);
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+
+ // We don't handle mouse button up if it's middle button.
+ if (isPrimaryButtonDown && offsets.offset != offsets.secondaryOffset) {
+ fc->MaintainSelection();
+ }
+
+ if (isPrimaryButtonDown && isEditor && !aMouseEvent->IsShift() &&
+ (offsets.EndOffset() - offsets.StartOffset()) == 1) {
+ // A single node is selected and we aren't extending an existing selection,
+ // which means the user clicked directly on an object (either
+ // `user-select: all` or a non-text node without children). Therefore,
+ // disable selection extension during mouse moves.
+ // XXX This is a bit hacky; shouldn't editor be able to deal with this?
+ fc->SetDragState(false);
+ }
+
+ return NS_OK;
+}
+
+bool nsIFrame::MovingCaretToEventPointAllowedIfSecondaryButtonEvent(
+ const nsFrameSelection& aFrameSelection,
+ WidgetMouseEvent& aSecondaryButtonEvent,
+ const nsIContent& aContentAtEventPoint, int32_t aOffsetAtEventPoint) const {
+ MOZ_ASSERT(aSecondaryButtonEvent.mButton == MouseButton::eSecondary);
+
+ if (NS_WARN_IF(aOffsetAtEventPoint < 0)) {
+ return false;
+ }
+
+ const bool contentIsEditable = aContentAtEventPoint.IsEditable();
+ const TextControlElement* const contentAsTextControl =
+ TextControlElement::FromNodeOrNull(
+ aContentAtEventPoint.IsTextControlElement()
+ ? &aContentAtEventPoint
+ : aContentAtEventPoint.GetClosestNativeAnonymousSubtreeRoot());
+ if (Selection* selection =
+ aFrameSelection.GetSelection(SelectionType::eNormal)) {
+ const bool selectionIsCollapsed = selection->IsCollapsed();
+ // If right click in a selection range, we should not collapse selection.
+ if (!selectionIsCollapsed &&
+ nsContentUtils::IsPointInSelection(
+ *selection, aContentAtEventPoint,
+ static_cast<uint32_t>(aOffsetAtEventPoint))) {
+ return false;
+ }
+ const bool wantToPreventMoveCaret =
+ StaticPrefs::
+ ui_mouse_right_click_move_caret_stop_if_in_focused_editable_node() &&
+ selectionIsCollapsed && (contentIsEditable || contentAsTextControl);
+ const bool wantToPreventCollapseSelection =
+ StaticPrefs::
+ ui_mouse_right_click_collapse_selection_stop_if_non_collapsed_selection() &&
+ !selectionIsCollapsed;
+ if (wantToPreventMoveCaret || wantToPreventCollapseSelection) {
+ // If currently selection is limited in an editing host, we should not
+ // collapse selection nor move caret if the clicked point is in the
+ // ancestor limiter. Otherwise, this mouse click moves focus from the
+ // editing host to different one or blur the editing host. In this case,
+ // we need to update selection because keeping current selection in the
+ // editing host looks like it's not blurred.
+ // FIXME: If the active editing host is the document element, editor
+ // does not set ancestor limiter properly. Fix it in the editor side.
+ if (nsIContent* ancestorLimiter = selection->GetAncestorLimiter()) {
+ MOZ_ASSERT(ancestorLimiter->IsEditable());
+ return !aContentAtEventPoint.IsInclusiveDescendantOf(ancestorLimiter);
+ }
+ }
+ // If selection is editable and `stop_if_in_focused_editable_node` pref is
+ // set to true, user does not want to move caret to right click place if
+ // clicked in the focused text control element.
+ if (wantToPreventMoveCaret && contentAsTextControl &&
+ contentAsTextControl == nsFocusManager::GetFocusedElementStatic()) {
+ return false;
+ }
+ // If currently selection is not limited in an editing host, we should
+ // collapse selection only when this click moves focus to an editing
+ // host because we need to update selection in this case.
+ if (wantToPreventCollapseSelection && !contentIsEditable) {
+ return false;
+ }
+ }
+
+ return !StaticPrefs::
+ ui_mouse_right_click_collapse_selection_stop_if_non_editable_node() ||
+ // The user does not want to collapse selection into non-editable
+ // content by a right button click.
+ contentIsEditable ||
+ // Treat clicking in a text control as always clicked on editable
+ // content because we want a hack only for clicking in normal text
+ // nodes which is outside any editing hosts.
+ contentAsTextControl;
+}
+
+nsresult nsIFrame::SelectByTypeAtPoint(nsPresContext* aPresContext,
+ const nsPoint& aPoint,
+ nsSelectionAmount aBeginAmountType,
+ nsSelectionAmount aEndAmountType,
+ uint32_t aSelectFlags) {
+ NS_ENSURE_ARG_POINTER(aPresContext);
+
+ // No point in selecting if selection is turned off
+ if (DetermineDisplaySelection() == nsISelectionController::SELECTION_OFF) {
+ return NS_OK;
+ }
+
+ ContentOffsets offsets = GetContentOffsetsFromPoint(
+ aPoint, SKIP_HIDDEN | IGNORE_NATIVE_ANONYMOUS_SUBTREE);
+ if (!offsets.content) {
+ return NS_ERROR_FAILURE;
+ }
+
+ uint32_t offset;
+ nsIFrame* frame = SelectionMovementUtils::GetFrameForNodeOffset(
+ offsets.content, offsets.offset, offsets.associate, &offset);
+ if (!frame) {
+ return NS_ERROR_FAILURE;
+ }
+ return frame->PeekBackwardAndForward(
+ aBeginAmountType, aEndAmountType, static_cast<int32_t>(offset),
+ aBeginAmountType != eSelectWord, aSelectFlags);
+}
+
+/**
+ * Multiple Mouse Press -- line or paragraph selection -- for the frame.
+ * Wouldn't it be nice if this didn't have to be hardwired into Frame code?
+ */
+NS_IMETHODIMP
+nsIFrame::HandleMultiplePress(nsPresContext* aPresContext,
+ WidgetGUIEvent* aEvent,
+ nsEventStatus* aEventStatus, bool aControlHeld) {
+ NS_ENSURE_ARG_POINTER(aEvent);
+ NS_ENSURE_ARG_POINTER(aEventStatus);
+
+ if (nsEventStatus_eConsumeNoDefault == *aEventStatus ||
+ DetermineDisplaySelection() == nsISelectionController::SELECTION_OFF) {
+ return NS_OK;
+ }
+
+ // Find out whether we're doing line or paragraph selection.
+ // If browser.triple_click_selects_paragraph is true, triple-click selects
+ // paragraph. Otherwise, triple-click selects line, and quadruple-click
+ // selects paragraph (on platforms that support quadruple-click).
+ nsSelectionAmount beginAmount, endAmount;
+ WidgetMouseEvent* mouseEvent = aEvent->AsMouseEvent();
+ if (!mouseEvent) {
+ return NS_OK;
+ }
+
+ if (mouseEvent->mClickCount == 4) {
+ beginAmount = endAmount = eSelectParagraph;
+ } else if (mouseEvent->mClickCount == 3) {
+ if (Preferences::GetBool("browser.triple_click_selects_paragraph")) {
+ beginAmount = endAmount = eSelectParagraph;
+ } else {
+ beginAmount = eSelectBeginLine;
+ endAmount = eSelectEndLine;
+ }
+ } else if (mouseEvent->mClickCount == 2) {
+ // We only want inline frames; PeekBackwardAndForward dislikes blocks
+ beginAmount = endAmount = eSelectWord;
+ } else {
+ return NS_OK;
+ }
+
+ nsPoint relPoint = nsLayoutUtils::GetEventCoordinatesRelativeTo(
+ mouseEvent, RelativeTo{this});
+ return SelectByTypeAtPoint(aPresContext, relPoint, beginAmount, endAmount,
+ (aControlHeld ? SELECT_ACCUMULATE : 0));
+}
+
+nsresult nsIFrame::PeekBackwardAndForward(nsSelectionAmount aAmountBack,
+ nsSelectionAmount aAmountForward,
+ int32_t aStartPos, bool aJumpLines,
+ uint32_t aSelectFlags) {
+ nsIFrame* baseFrame = this;
+ int32_t baseOffset = aStartPos;
+ nsresult rv;
+
+ PeekOffsetOptions peekOffsetOptions{PeekOffsetOption::StopAtScroller};
+ if (aJumpLines) {
+ peekOffsetOptions += PeekOffsetOption::JumpLines;
+ }
+
+ if (aAmountBack == eSelectWord) {
+ // To avoid selecting the previous word when at start of word,
+ // first move one character forward.
+ PeekOffsetStruct pos(eSelectCharacter, eDirNext, aStartPos, nsPoint(0, 0),
+ peekOffsetOptions);
+ rv = PeekOffset(&pos);
+ if (NS_SUCCEEDED(rv)) {
+ baseFrame = pos.mResultFrame;
+ baseOffset = pos.mContentOffset;
+ }
+ }
+
+ // Search backward for a boundary.
+ PeekOffsetStruct startpos(aAmountBack, eDirPrevious, baseOffset,
+ nsPoint(0, 0), peekOffsetOptions);
+ rv = baseFrame->PeekOffset(&startpos);
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+
+ // If the backward search stayed within the same frame, search forward from
+ // that position for the end boundary; but if it crossed out to a sibling or
+ // ancestor, start from the original position.
+ if (startpos.mResultFrame == baseFrame) {
+ baseOffset = startpos.mContentOffset;
+ } else {
+ baseFrame = this;
+ baseOffset = aStartPos;
+ }
+
+ PeekOffsetStruct endpos(aAmountForward, eDirNext, baseOffset, nsPoint(0, 0),
+ peekOffsetOptions);
+ rv = baseFrame->PeekOffset(&endpos);
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+
+ // Keep frameSelection alive.
+ RefPtr<nsFrameSelection> frameSelection = GetFrameSelection();
+
+ const nsFrameSelection::FocusMode focusMode =
+ (aSelectFlags & SELECT_ACCUMULATE)
+ ? nsFrameSelection::FocusMode::kMultiRangeSelection
+ : nsFrameSelection::FocusMode::kCollapseToNewPoint;
+ rv = frameSelection->HandleClick(
+ MOZ_KnownLive(startpos.mResultContent) /* bug 1636889 */,
+ startpos.mContentOffset, startpos.mContentOffset, focusMode,
+ CaretAssociationHint::After);
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+
+ rv = frameSelection->HandleClick(
+ MOZ_KnownLive(endpos.mResultContent) /* bug 1636889 */,
+ endpos.mContentOffset, endpos.mContentOffset,
+ nsFrameSelection::FocusMode::kExtendSelection,
+ CaretAssociationHint::Before);
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+ if (aAmountBack == eSelectWord) {
+ frameSelection->SetIsDoubleClickSelection(true);
+ }
+
+ // maintain selection
+ return frameSelection->MaintainSelection(aAmountBack);
+}
+
+NS_IMETHODIMP nsIFrame::HandleDrag(nsPresContext* aPresContext,
+ WidgetGUIEvent* aEvent,
+ nsEventStatus* aEventStatus) {
+ MOZ_ASSERT(aEvent->mClass == eMouseEventClass,
+ "HandleDrag can only handle mouse event");
+
+ NS_ENSURE_ARG_POINTER(aEventStatus);
+
+ RefPtr<nsFrameSelection> frameselection = GetFrameSelection();
+ if (!frameselection) {
+ return NS_OK;
+ }
+
+ bool mouseDown = frameselection->GetDragState();
+ if (!mouseDown) {
+ return NS_OK;
+ }
+
+ nsIFrame* scrollbar =
+ nsLayoutUtils::GetClosestFrameOfType(this, LayoutFrameType::Scrollbar);
+ if (!scrollbar) {
+ // XXX Do we really need to exclude non-selectable content here?
+ // GetContentOffsetsFromPoint can handle it just fine, although some
+ // other stuff might not like it.
+ // NOTE: DetermineDisplaySelection() returns SELECTION_OFF for
+ // non-selectable frames.
+ if (DetermineDisplaySelection() == nsISelectionController::SELECTION_OFF) {
+ return NS_OK;
+ }
+ }
+
+ frameselection->StopAutoScrollTimer();
+
+ // Check if we are dragging in a table cell
+ nsCOMPtr<nsIContent> parentContent;
+ int32_t contentOffset;
+ TableSelectionMode target;
+ WidgetMouseEvent* mouseEvent = aEvent->AsMouseEvent();
+ mozilla::PresShell* presShell = aPresContext->PresShell();
+ nsresult result;
+ result = GetDataForTableSelection(frameselection, presShell, mouseEvent,
+ getter_AddRefs(parentContent),
+ &contentOffset, &target);
+
+ AutoWeakFrame weakThis = this;
+ if (NS_SUCCEEDED(result) && parentContent) {
+ result = frameselection->HandleTableSelection(parentContent, contentOffset,
+ target, mouseEvent);
+ if (NS_WARN_IF(NS_FAILED(result))) {
+ return result;
+ }
+ } else {
+ nsPoint pt = nsLayoutUtils::GetEventCoordinatesRelativeTo(mouseEvent,
+ RelativeTo{this});
+ frameselection->HandleDrag(this, pt);
+ }
+
+ // The frameselection object notifies selection listeners synchronously above
+ // which might have killed us.
+ if (!weakThis.IsAlive()) {
+ return NS_OK;
+ }
+
+ // get the nearest scrollframe
+ nsIScrollableFrame* scrollFrame = nsLayoutUtils::GetNearestScrollableFrame(
+ this, nsLayoutUtils::SCROLLABLE_SAME_DOC |
+ nsLayoutUtils::SCROLLABLE_INCLUDE_HIDDEN);
+
+ if (scrollFrame) {
+ nsIFrame* capturingFrame = scrollFrame->GetScrolledFrame();
+ if (capturingFrame) {
+ nsPoint pt = nsLayoutUtils::GetEventCoordinatesRelativeTo(
+ mouseEvent, RelativeTo{capturingFrame});
+ frameselection->StartAutoScrollTimer(capturingFrame, pt, 30);
+ }
+ }
+
+ return NS_OK;
+}
+
+/**
+ * This static method handles part of the nsIFrame::HandleRelease in a way
+ * which doesn't rely on the nsFrame object to stay alive.
+ */
+MOZ_CAN_RUN_SCRIPT_BOUNDARY static nsresult HandleFrameSelection(
+ nsFrameSelection* aFrameSelection, nsIFrame::ContentOffsets& aOffsets,
+ bool aHandleTableSel, int32_t aContentOffsetForTableSel,
+ TableSelectionMode aTargetForTableSel,
+ nsIContent* aParentContentForTableSel, WidgetGUIEvent* aEvent,
+ const nsEventStatus* aEventStatus) {
+ if (!aFrameSelection) {
+ return NS_OK;
+ }
+
+ nsresult rv = NS_OK;
+
+ if (nsEventStatus_eConsumeNoDefault != *aEventStatus) {
+ if (!aHandleTableSel) {
+ if (!aOffsets.content || !aFrameSelection->HasDelayedCaretData()) {
+ return NS_ERROR_FAILURE;
+ }
+
+ // We are doing this to simulate what we would have done on HandlePress.
+ // We didn't do it there to give the user an opportunity to drag
+ // the text, but since they didn't drag, we want to place the
+ // caret.
+ // However, we'll use the mouse position from the release, since:
+ // * it's easier
+ // * that's the normal click position to use (although really, in
+ // the normal case, small movements that don't count as a drag
+ // can do selection)
+ aFrameSelection->SetDragState(true);
+
+ const nsFrameSelection::FocusMode focusMode =
+ aFrameSelection->IsShiftDownInDelayedCaretData()
+ ? nsFrameSelection::FocusMode::kExtendSelection
+ : nsFrameSelection::FocusMode::kCollapseToNewPoint;
+ rv = aFrameSelection->HandleClick(
+ MOZ_KnownLive(aOffsets.content) /* bug 1636889 */,
+ aOffsets.StartOffset(), aOffsets.EndOffset(), focusMode,
+ aOffsets.associate);
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+ } else if (aParentContentForTableSel) {
+ aFrameSelection->SetDragState(false);
+ rv = aFrameSelection->HandleTableSelection(
+ aParentContentForTableSel, aContentOffsetForTableSel,
+ aTargetForTableSel, aEvent->AsMouseEvent());
+ if (NS_FAILED(rv)) {
+ return rv;
+ }
+ }
+ aFrameSelection->SetDelayedCaretData(0);
+ }
+
+ aFrameSelection->SetDragState(false);
+ aFrameSelection->StopAutoScrollTimer();
+
+ return NS_OK;
+}
+
+NS_IMETHODIMP nsIFrame::HandleRelease(nsPresContext* aPresContext,
+ WidgetGUIEvent* aEvent,
+ nsEventStatus* aEventStatus) {
+ if (aEvent->mClass != eMouseEventClass) {
+ return NS_OK;
+ }
+
+ nsIFrame* activeFrame = GetActiveSelectionFrame(aPresContext, this);
+
+ nsCOMPtr<nsIContent> captureContent = PresShell::GetCapturingContent();
+
+ bool selectionOff =
+ (DetermineDisplaySelection() == nsISelectionController::SELECTION_OFF);
+
+ RefPtr<nsFrameSelection> frameselection;
+ ContentOffsets offsets;
+ nsCOMPtr<nsIContent> parentContent;
+ int32_t contentOffsetForTableSel = 0;
+ TableSelectionMode targetForTableSel = TableSelectionMode::None;
+ bool handleTableSelection = true;
+
+ if (!selectionOff) {
+ frameselection = GetFrameSelection();
+ if (nsEventStatus_eConsumeNoDefault != *aEventStatus && frameselection) {
+ // Check if the frameselection recorded the mouse going down.
+ // If not, the user must have clicked in a part of the selection.
+ // Place the caret before continuing!
+
+ if (frameselection->MouseDownRecorded()) {
+ nsPoint pt = nsLayoutUtils::GetEventCoordinatesRelativeTo(
+ aEvent, RelativeTo{this});
+ offsets = GetContentOffsetsFromPoint(pt, SKIP_HIDDEN);
+ handleTableSelection = false;
+ } else {
+ GetDataForTableSelection(frameselection, PresShell(),
+ aEvent->AsMouseEvent(),
+ getter_AddRefs(parentContent),
+ &contentOffsetForTableSel, &targetForTableSel);
+ }
+ }
+ }
+
+ // We might be capturing in some other document and the event just happened to
+ // trickle down here. Make sure that document's frame selection is notified.
+ // Note, this may cause the current nsFrame object to be deleted, bug 336592.
+ RefPtr<nsFrameSelection> frameSelection;
+ if (activeFrame != this && activeFrame->DetermineDisplaySelection() !=
+ nsISelectionController::SELECTION_OFF) {
+ frameSelection = activeFrame->GetFrameSelection();
+ }
+
+ // Also check the selection of the capturing content which might be in a
+ // different document.
+ if (!frameSelection && captureContent) {
+ if (Document* doc = captureContent->GetComposedDoc()) {
+ mozilla::PresShell* capturingPresShell = doc->GetPresShell();
+ if (capturingPresShell &&
+ capturingPresShell != PresContext()->GetPresShell()) {
+ frameSelection = capturingPresShell->FrameSelection();
+ }
+ }
+ }
+
+ if (frameSelection) {
+ AutoWeakFrame wf(this);
+ frameSelection->SetDragState(false);
+ frameSelection->StopAutoScrollTimer();
+ if (wf.IsAlive()) {
+ nsIScrollableFrame* scrollFrame =
+ nsLayoutUtils::GetNearestScrollableFrame(
+ this, nsLayoutUtils::SCROLLABLE_SAME_DOC |
+ nsLayoutUtils::SCROLLABLE_INCLUDE_HIDDEN);
+ if (scrollFrame) {
+ // Perform any additional scrolling needed to maintain CSS snap point
+ // requirements when autoscrolling is over.
+ scrollFrame->ScrollSnap();
+ }
+ }
+ }
+
+ // Do not call any methods of the current object after this point!!!
+ // The object is perhaps dead!
+
+ return selectionOff ? NS_OK
+ : HandleFrameSelection(
+ frameselection, offsets, handleTableSelection,
+ contentOffsetForTableSel, targetForTableSel,
+ parentContent, aEvent, aEventStatus);
+}
+
+struct MOZ_STACK_CLASS FrameContentRange {
+ FrameContentRange(nsIContent* aContent, int32_t aStart, int32_t aEnd)
+ : content(aContent), start(aStart), end(aEnd) {}
+ nsCOMPtr<nsIContent> content;
+ int32_t start;
+ int32_t end;
+};
+
+// Retrieve the content offsets of a frame
+static FrameContentRange GetRangeForFrame(const nsIFrame* aFrame) {
+ nsIContent* content = aFrame->GetContent();
+ if (!content) {
+ NS_WARNING("Frame has no content");
+ return FrameContentRange(nullptr, -1, -1);
+ }
+
+ LayoutFrameType type = aFrame->Type();
+ if (type == LayoutFrameType::Text) {
+ auto [offset, offsetEnd] = aFrame->GetOffsets();
+ return FrameContentRange(content, offset, offsetEnd);
+ }
+
+ if (type == LayoutFrameType::Br) {
+ nsIContent* parent = content->GetParent();
+ const int32_t beginOffset = parent->ComputeIndexOf_Deprecated(content);
+ return FrameContentRange(parent, beginOffset, beginOffset);
+ }
+
+ while (content->IsRootOfNativeAnonymousSubtree()) {
+ content = content->GetParent();
+ }
+
+ nsIContent* parent = content->GetParent();
+ if (aFrame->IsBlockOutside() || !parent) {
+ return FrameContentRange(content, 0, content->GetChildCount());
+ }
+
+ // TODO(emilio): Revise this in presence of Shadow DOM / display: contents,
+ // it's likely that we don't want to just walk the light tree, and we need to
+ // change the representation of FrameContentRange.
+ const int32_t index = parent->ComputeIndexOf_Deprecated(content);
+ MOZ_ASSERT(index >= 0);
+ return FrameContentRange(parent, index, index + 1);
+}
+
+// The FrameTarget represents the closest frame to a point that can be selected
+// The frame is the frame represented, frameEdge says whether one end of the
+// frame is the result (in which case different handling is needed), and
+// afterFrame says which end is represented if frameEdge is true
+struct FrameTarget {
+ explicit operator bool() const { return !!frame; }
+
+ nsIFrame* frame = nullptr;
+ bool frameEdge = false;
+ bool afterFrame = false;
+};
+
+// See function implementation for information
+static FrameTarget GetSelectionClosestFrame(nsIFrame* aFrame,
+ const nsPoint& aPoint,
+ uint32_t aFlags);
+
+static bool SelfIsSelectable(nsIFrame* aFrame, uint32_t aFlags) {
+ if ((aFlags & nsIFrame::SKIP_HIDDEN) &&
+ !aFrame->StyleVisibility()->IsVisible()) {
+ return false;
+ }
+ return !aFrame->IsGeneratedContentFrame() &&
+ aFrame->Style()->UserSelect() != StyleUserSelect::None;
+}
+
+static bool FrameContentCanHaveParentSelectionRange(nsIFrame* aFrame) {
+ // If we are only near (not directly over) then don't traverse
+ // frames with independent selection (e.g. text and list controls, see bug
+ // 268497). Note that this prevents any of the users of this method from
+ // entering form controls.
+ // XXX We might want some way to allow using the up-arrow to go into a form
+ // control, but the focus didn't work right anyway; it'd probably be enough
+ // if the left and right arrows could enter textboxes (which I don't believe
+ // they can at the moment)
+ if (aFrame->IsTextInputFrame() || aFrame->IsListControlFrame()) {
+ MOZ_ASSERT(aFrame->HasAnyStateBits(NS_FRAME_INDEPENDENT_SELECTION));
+ return false;
+ }
+
+ // Failure in this assertion means a new type of frame forms the root of an
+ // NS_FRAME_INDEPENDENT_SELECTION subtree. In such case, the condition above
+ // should be changed to handle it.
+ MOZ_ASSERT_IF(
+ aFrame->HasAnyStateBits(NS_FRAME_INDEPENDENT_SELECTION),
+ aFrame->GetParent()->HasAnyStateBits(NS_FRAME_INDEPENDENT_SELECTION));
+
+ return !aFrame->IsGeneratedContentFrame();
+}
+
+static bool SelectionDescendToKids(nsIFrame* aFrame) {
+ if (!FrameContentCanHaveParentSelectionRange(aFrame)) {
+ return false;
+ }
+ auto style = aFrame->Style()->UserSelect();
+ return style != StyleUserSelect::All && style != StyleUserSelect::None;
+}
+
+static FrameTarget GetSelectionClosestFrameForChild(nsIFrame* aChild,
+ const nsPoint& aPoint,
+ uint32_t aFlags) {
+ nsIFrame* parent = aChild->GetParent();
+ if (SelectionDescendToKids(aChild)) {
+ nsPoint pt = aPoint - aChild->GetOffsetTo(parent);
+ return GetSelectionClosestFrame(aChild, pt, aFlags);
+ }
+ return FrameTarget{aChild, false, false};
+}
+
+// When the cursor needs to be at the beginning of a block, it shouldn't be
+// before the first child. A click on a block whose first child is a block
+// should put the cursor in the child. The cursor shouldn't be between the
+// blocks, because that's not where it's expected.
+// Note that this method is guaranteed to succeed.
+static FrameTarget DrillDownToSelectionFrame(nsIFrame* aFrame, bool aEndFrame,
+ uint32_t aFlags) {
+ if (SelectionDescendToKids(aFrame)) {
+ nsIFrame* result = nullptr;
+ nsIFrame* frame = aFrame->PrincipalChildList().FirstChild();
+ if (!aEndFrame) {
+ while (frame && (!SelfIsSelectable(frame, aFlags) || frame->IsEmpty()))
+ frame = frame->GetNextSibling();
+ if (frame) result = frame;
+ } else {
+ // Because the frame tree is singly linked, to find the last frame,
+ // we have to iterate through all the frames
+ // XXX I have a feeling this could be slow for long blocks, although
+ // I can't find any slowdowns
+ while (frame) {
+ if (!frame->IsEmpty() && SelfIsSelectable(frame, aFlags))
+ result = frame;
+ frame = frame->GetNextSibling();
+ }
+ }
+ if (result) return DrillDownToSelectionFrame(result, aEndFrame, aFlags);
+ }
+ // If the current frame has no targetable children, target the current frame
+ return FrameTarget{aFrame, true, aEndFrame};
+}
+
+// This method finds the closest valid FrameTarget on a given line; if there is
+// no valid FrameTarget on the line, it returns a null FrameTarget
+static FrameTarget GetSelectionClosestFrameForLine(
+ nsBlockFrame* aParent, nsBlockFrame::LineIterator aLine,
+ const nsPoint& aPoint, uint32_t aFlags) {
+ // Account for end of lines (any iterator from the block is valid)
+ if (aLine == aParent->LinesEnd())
+ return DrillDownToSelectionFrame(aParent, true, aFlags);
+ nsIFrame* frame = aLine->mFirstChild;
+ nsIFrame* closestFromIStart = nullptr;
+ nsIFrame* closestFromIEnd = nullptr;
+ nscoord closestIStart = aLine->IStart(), closestIEnd = aLine->IEnd();
+ WritingMode wm = aLine->mWritingMode;
+ LogicalPoint pt(wm, aPoint, aLine->mContainerSize);
+ bool canSkipBr = false;
+ bool lastFrameWasEditable = false;
+ for (int32_t n = aLine->GetChildCount(); n;
+ --n, frame = frame->GetNextSibling()) {
+ // Skip brFrames. Can only skip if the line contains at least
+ // one selectable and non-empty frame before. Also, avoid skipping brs if
+ // the previous thing had a different editableness than us, since then we
+ // may end up not being able to select after it if the br is the last thing
+ // on the line.
+ if (!SelfIsSelectable(frame, aFlags) || frame->IsEmpty() ||
+ (canSkipBr && frame->IsBrFrame() &&
+ lastFrameWasEditable == frame->GetContent()->IsEditable())) {
+ continue;
+ }
+ canSkipBr = true;
+ lastFrameWasEditable =
+ frame->GetContent() && frame->GetContent()->IsEditable();
+ LogicalRect frameRect =
+ LogicalRect(wm, frame->GetRect(), aLine->mContainerSize);
+ if (pt.I(wm) >= frameRect.IStart(wm)) {
+ if (pt.I(wm) < frameRect.IEnd(wm)) {
+ return GetSelectionClosestFrameForChild(frame, aPoint, aFlags);
+ }
+ if (frameRect.IEnd(wm) >= closestIStart) {
+ closestFromIStart = frame;
+ closestIStart = frameRect.IEnd(wm);
+ }
+ } else {
+ if (frameRect.IStart(wm) <= closestIEnd) {
+ closestFromIEnd = frame;
+ closestIEnd = frameRect.IStart(wm);
+ }
+ }
+ }
+ if (!closestFromIStart && !closestFromIEnd) {
+ // We should only get here if there are no selectable frames on a line
+ // XXX Do we need more elaborate handling here?
+ return FrameTarget();
+ }
+ if (closestFromIStart &&
+ (!closestFromIEnd ||
+ (abs(pt.I(wm) - closestIStart) <= abs(pt.I(wm) - closestIEnd)))) {
+ return GetSelectionClosestFrameForChild(closestFromIStart, aPoint, aFlags);
+ }
+ return GetSelectionClosestFrameForChild(closestFromIEnd, aPoint, aFlags);
+}
+
+// This method is for the special handling we do for block frames; they're
+// special because they represent paragraphs and because they are organized
+// into lines, which have bounds that are not stored elsewhere in the
+// frame tree. Returns a null FrameTarget for frames which are not
+// blocks or blocks with no lines except editable one.
+static FrameTarget GetSelectionClosestFrameForBlock(nsIFrame* aFrame,
+ const nsPoint& aPoint,
+ uint32_t aFlags) {
+ nsBlockFrame* bf = do_QueryFrame(aFrame);
+ if (!bf) {
+ return FrameTarget();
+ }
+
+ // This code searches for the correct line
+ nsBlockFrame::LineIterator end = bf->LinesEnd();
+ nsBlockFrame::LineIterator curLine = bf->LinesBegin();
+ nsBlockFrame::LineIterator closestLine = end;
+
+ if (curLine != end) {
+ // Convert aPoint into a LogicalPoint in the writing-mode of this block
+ WritingMode wm = curLine->mWritingMode;
+ LogicalPoint pt(wm, aPoint, curLine->mContainerSize);
+ do {
+ // Check to see if our point lies within the line's block-direction bounds
+ nscoord BCoord = pt.B(wm) - curLine->BStart();
+ nscoord BSize = curLine->BSize();
+ if (BCoord >= 0 && BCoord < BSize) {
+ closestLine = curLine;
+ break; // We found the line; stop looking
+ }
+ if (BCoord < 0) break;
+ ++curLine;
+ } while (curLine != end);
+
+ if (closestLine == end) {
+ nsBlockFrame::LineIterator prevLine = curLine.prev();
+ nsBlockFrame::LineIterator nextLine = curLine;
+ // Avoid empty lines
+ while (nextLine != end && nextLine->IsEmpty()) ++nextLine;
+ while (prevLine != end && prevLine->IsEmpty()) --prevLine;
+
+ // This hidden pref dictates whether a point above or below all lines
+ // comes up with a line or the beginning or end of the frame; 0 on
+ // Windows, 1 on other platforms by default at the writing of this code
+ int32_t dragOutOfFrame =
+ Preferences::GetInt("browser.drag_out_of_frame_style");
+
+ if (prevLine == end) {
+ if (dragOutOfFrame == 1 || nextLine == end)
+ return DrillDownToSelectionFrame(aFrame, false, aFlags);
+ closestLine = nextLine;
+ } else if (nextLine == end) {
+ if (dragOutOfFrame == 1)
+ return DrillDownToSelectionFrame(aFrame, true, aFlags);
+ closestLine = prevLine;
+ } else { // Figure out which line is closer
+ if (pt.B(wm) - prevLine->BEnd() < nextLine->BStart() - pt.B(wm))
+ closestLine = prevLine;
+ else
+ closestLine = nextLine;
+ }
+ }
+ }
+
+ do {
+ if (auto target =
+ GetSelectionClosestFrameForLine(bf, closestLine, aPoint, aFlags)) {
+ return target;
+ }
+ ++closestLine;
+ } while (closestLine != end);
+
+ // Fall back to just targeting the last targetable place
+ return DrillDownToSelectionFrame(aFrame, true, aFlags);
+}
+
+// Use frame edge for grid, flex, table, and non-editable images. Choose the
+// edge based on the point position past the frame rect. If past the middle,
+// caret should be at end, otherwise at start. This behavior matches Blink.
+//
+// TODO(emilio): Can we use this code path for other replaced elements other
+// than images? Or even all other frames? We only get there when we didn't find
+// selectable children... At least one XUL test fails if we make this apply to
+// XUL labels. Also, editable images need _not_ to use the frame edge, see
+// below.
+static bool UseFrameEdge(nsIFrame* aFrame) {
+ if (aFrame->IsFlexOrGridContainer() || aFrame->IsTableFrame()) {
+ return true;
+ }
+ const nsImageFrame* image = do_QueryFrame(aFrame);
+ if (image && !aFrame->GetContent()->IsEditable()) {
+ // Editable images are a special-case because editing relies on clicking on
+ // an editable image selecting it, for it to show resizers.
+ return true;
+ }
+ return false;
+}
+
+static FrameTarget LastResortFrameTargetForFrame(nsIFrame* aFrame,
+ const nsPoint& aPoint) {
+ if (!UseFrameEdge(aFrame)) {
+ return {aFrame, false, false};
+ }
+ const auto& rect = aFrame->GetRectRelativeToSelf();
+ nscoord reference;
+ nscoord middle;
+ if (aFrame->GetWritingMode().IsVertical()) {
+ reference = aPoint.y;
+ middle = rect.Height() / 2;
+ } else {
+ reference = aPoint.x;
+ middle = rect.Width() / 2;
+ }
+ const bool afterFrame = reference > middle;
+ return {aFrame, true, afterFrame};
+}
+
+// GetSelectionClosestFrame is the helper function that calculates the closest
+// frame to the given point.
+// It doesn't completely account for offset styles, so needs to be used in
+// restricted environments.
+// Cannot handle overlapping frames correctly, so it should receive the output
+// of GetFrameForPoint
+// Guaranteed to return a valid FrameTarget.
+// aPoint is relative to aFrame.
+static FrameTarget GetSelectionClosestFrame(nsIFrame* aFrame,
+ const nsPoint& aPoint,
+ uint32_t aFlags) {
+ // Handle blocks; if the frame isn't a block, the method fails
+ if (auto target = GetSelectionClosestFrameForBlock(aFrame, aPoint, aFlags)) {
+ return target;
+ }
+
+ if (aFlags & nsIFrame::IGNORE_NATIVE_ANONYMOUS_SUBTREE &&
+ !FrameContentCanHaveParentSelectionRange(aFrame)) {
+ return LastResortFrameTargetForFrame(aFrame, aPoint);
+ }
+
+ if (nsIFrame* kid = aFrame->PrincipalChildList().FirstChild()) {
+ // Go through all the child frames to find the closest one
+ nsIFrame::FrameWithDistance closest = {nullptr, nscoord_MAX, nscoord_MAX};
+ for (; kid; kid = kid->GetNextSibling()) {
+ if (!SelfIsSelectable(kid, aFlags) || kid->IsEmpty()) {
+ continue;
+ }
+
+ kid->FindCloserFrameForSelection(aPoint, &closest);
+ }
+ if (closest.mFrame) {
+ if (closest.mFrame->IsInSVGTextSubtree())
+ return FrameTarget{closest.mFrame, false, false};
+ return GetSelectionClosestFrameForChild(closest.mFrame, aPoint, aFlags);
+ }
+ }
+
+ return LastResortFrameTargetForFrame(aFrame, aPoint);
+}
+
+static nsIFrame::ContentOffsets OffsetsForSingleFrame(nsIFrame* aFrame,
+ const nsPoint& aPoint) {
+ nsIFrame::ContentOffsets offsets;
+ FrameContentRange range = GetRangeForFrame(aFrame);
+ offsets.content = range.content;
+ // If there are continuations (meaning it's not one rectangle), this is the
+ // best this function can do
+ if (aFrame->GetNextContinuation() || aFrame->GetPrevContinuation()) {
+ offsets.offset = range.start;
+ offsets.secondaryOffset = range.end;
+ offsets.associate = CaretAssociationHint::After;
+ return offsets;
+ }
+
+ // Figure out whether the offsets should be over, after, or before the frame
+ nsRect rect(nsPoint(0, 0), aFrame->GetSize());
+
+ bool isBlock = !aFrame->StyleDisplay()->IsInlineFlow();
+ bool isRtl = (aFrame->StyleVisibility()->mDirection == StyleDirection::Rtl);
+ if ((isBlock && rect.y < aPoint.y) ||
+ (!isBlock && ((isRtl && rect.x + rect.width / 2 > aPoint.x) ||
+ (!isRtl && rect.x + rect.width / 2 < aPoint.x)))) {
+ offsets.offset = range.end;
+ if (rect.Contains(aPoint))
+ offsets.secondaryOffset = range.start;
+ else
+ offsets.secondaryOffset = range.end;
+ } else {
+ offsets.offset = range.start;
+ if (rect.Contains(aPoint))
+ offsets.secondaryOffset = range.end;
+ else
+ offsets.secondaryOffset = range.start;
+ }
+ offsets.associate = offsets.offset == range.start
+ ? CaretAssociationHint::After
+ : CaretAssociationHint::Before;
+ return offsets;
+}
+
+static nsIFrame* AdjustFrameForSelectionStyles(nsIFrame* aFrame) {
+ nsIFrame* adjustedFrame = aFrame;
+ for (nsIFrame* frame = aFrame; frame; frame = frame->GetParent()) {
+ // These are the conditions that make all children not able to handle
+ // a cursor.
+ auto userSelect = frame->Style()->UserSelect();
+ if (userSelect != StyleUserSelect::Auto &&
+ userSelect != StyleUserSelect::All) {
+ break;
+ }
+ if (userSelect == StyleUserSelect::All ||
+ frame->IsGeneratedContentFrame()) {
+ adjustedFrame = frame;
+ }
+ }
+ return adjustedFrame;
+}
+
+nsIFrame::ContentOffsets nsIFrame::GetContentOffsetsFromPoint(
+ const nsPoint& aPoint, uint32_t aFlags) {
+ nsIFrame* adjustedFrame;
+ if (aFlags & IGNORE_SELECTION_STYLE) {
+ adjustedFrame = this;
+ } else {
+ // This section of code deals with special selection styles. Note that
+ // -moz-all exists, even though it doesn't need to be explicitly handled.
+ //
+ // The offset is forced not to end up in generated content; content offsets
+ // cannot represent content outside of the document's content tree.
+
+ adjustedFrame = AdjustFrameForSelectionStyles(this);
+
+ // `user-select: all` needs special handling, because clicking on it should
+ // lead to the whole frame being selected.
+ if (adjustedFrame->Style()->UserSelect() == StyleUserSelect::All) {
+ nsPoint adjustedPoint = aPoint + GetOffsetTo(adjustedFrame);
+ return OffsetsForSingleFrame(adjustedFrame, adjustedPoint);
+ }
+
+ // For other cases, try to find a closest frame starting from the parent of
+ // the unselectable frame
+ if (adjustedFrame != this) {
+ adjustedFrame = adjustedFrame->GetParent();
+ }
+ }
+
+ nsPoint adjustedPoint = aPoint + GetOffsetTo(adjustedFrame);
+
+ FrameTarget closest =
+ GetSelectionClosestFrame(adjustedFrame, adjustedPoint, aFlags);
+
+ // If the correct offset is at one end of a frame, use offset-based
+ // calculation method
+ if (closest.frameEdge) {
+ ContentOffsets offsets;
+ FrameContentRange range = GetRangeForFrame(closest.frame);
+ offsets.content = range.content;
+ if (closest.afterFrame)
+ offsets.offset = range.end;
+ else
+ offsets.offset = range.start;
+ offsets.secondaryOffset = offsets.offset;
+ offsets.associate = offsets.offset == range.start
+ ? CaretAssociationHint::After
+ : CaretAssociationHint::Before;
+ return offsets;
+ }
+
+ nsPoint pt;
+ if (closest.frame != this) {
+ if (closest.frame->IsInSVGTextSubtree()) {
+ pt = nsLayoutUtils::TransformAncestorPointToFrame(
+ RelativeTo{closest.frame}, aPoint, RelativeTo{this});
+ } else {
+ pt = aPoint - closest.frame->GetOffsetTo(this);
+ }
+ } else {
+ pt = aPoint;
+ }
+ return closest.frame->CalcContentOffsetsFromFramePoint(pt);
+
+ // XXX should I add some kind of offset standardization?
+ // consider <b>xxxxx</b><i>zzzzz</i>; should any click between the last
+ // x and first z put the cursor in the same logical position in addition
+ // to the same visual position?
+}
+
+nsIFrame::ContentOffsets nsIFrame::CalcContentOffsetsFromFramePoint(
+ const nsPoint& aPoint) {
+ return OffsetsForSingleFrame(this, aPoint);
+}
+
+bool nsIFrame::AssociateImage(const StyleImage& aImage) {
+ imgRequestProxy* req = aImage.GetImageRequest();
+ if (!req) {
+ return false;
+ }
+
+ mozilla::css::ImageLoader* loader =
+ PresContext()->Document()->StyleImageLoader();
+
+ loader->AssociateRequestToFrame(req, this);
+ return true;
+}
+
+void nsIFrame::DisassociateImage(const StyleImage& aImage) {
+ imgRequestProxy* req = aImage.GetImageRequest();
+ if (!req) {
+ return;
+ }
+
+ mozilla::css::ImageLoader* loader =
+ PresContext()->Document()->StyleImageLoader();
+
+ loader->DisassociateRequestFromFrame(req, this);
+}
+
+StyleImageRendering nsIFrame::UsedImageRendering() const {
+ ComputedStyle* style;
+ if (IsCanvasFrame()) {
+ // XXXdholbert Maybe we should use FindCanvasBackground here (instead of
+ // FindBackground), since we're inside an IsCanvasFrame check? Though then
+ // we'd also have to copypaste or abstract-away the multi-part root-frame
+ // lookup that the canvas-flavored API requires.
+ style = nsCSSRendering::FindBackground(this);
+ } else {
+ style = Style();
+ }
+ return style->StyleVisibility()->mImageRendering;
+}
+
+// The touch-action CSS property applies to: all elements except: non-replaced
+// inline elements, table rows, row groups, table columns, and column groups.
+StyleTouchAction nsIFrame::UsedTouchAction() const {
+ if (IsLineParticipant()) {
+ return StyleTouchAction::AUTO;
+ }
+ auto& disp = *StyleDisplay();
+ if (disp.IsInternalTableStyleExceptCell()) {
+ return StyleTouchAction::AUTO;
+ }
+ return disp.mTouchAction;
+}
+
+nsIFrame::Cursor nsIFrame::GetCursor(const nsPoint&) {
+ StyleCursorKind kind = StyleUI()->Cursor().keyword;
+ if (kind == StyleCursorKind::Auto) {
+ // If this is editable, I-beam cursor is better for most elements.
+ kind = (mContent && mContent->IsEditable()) ? StyleCursorKind::Text
+ : StyleCursorKind::Default;
+ }
+ if (kind == StyleCursorKind::Text && GetWritingMode().IsVertical()) {
+ // Per CSS UI spec, UA may treat value 'text' as
+ // 'vertical-text' for vertical text.
+ kind = StyleCursorKind::VerticalText;
+ }
+
+ return Cursor{kind, AllowCustomCursorImage::Yes};
+}
+
+// Resize and incremental reflow
+
+/* virtual */
+void nsIFrame::MarkIntrinsicISizesDirty() {
+ // If we're a flex item, clear our flex-item-specific cached measurements
+ // (which likely depended on our now-stale intrinsic isize).
+ if (IsFlexItem()) {
+ nsFlexContainerFrame::MarkCachedFlexMeasurementsDirty(this);
+ }
+
+ if (HasAnyStateBits(NS_FRAME_FONT_INFLATION_FLOW_ROOT)) {
+ nsFontInflationData::MarkFontInflationDataTextDirty(this);
+ }
+
+ RemoveProperty(nsGridContainerFrame::CachedBAxisMeasurement::Prop());
+}
+
+void nsIFrame::MarkSubtreeDirty() {
+ if (HasAnyStateBits(NS_FRAME_IS_DIRTY)) {
+ return;
+ }
+ // Unconditionally mark given frame dirty.
+ AddStateBits(NS_FRAME_IS_DIRTY);
+
+ // Mark all descendants dirty, unless:
+ // - Already dirty.
+ // - TableColGroup
+ AutoTArray<nsIFrame*, 32> stack;
+ for (const auto& childLists : ChildLists()) {
+ for (nsIFrame* kid : childLists.mList) {
+ stack.AppendElement(kid);
+ }
+ }
+ while (!stack.IsEmpty()) {
+ nsIFrame* f = stack.PopLastElement();
+ if (f->HasAnyStateBits(NS_FRAME_IS_DIRTY) || f->IsTableColGroupFrame()) {
+ continue;
+ }
+
+ f->AddStateBits(NS_FRAME_IS_DIRTY);
+
+ for (const auto& childLists : f->ChildLists()) {
+ for (nsIFrame* kid : childLists.mList) {
+ stack.AppendElement(kid);
+ }
+ }
+ }
+}
+
+/* virtual */
+nscoord nsIFrame::GetMinISize(gfxContext* aRenderingContext) {
+ nscoord result = 0;
+ DISPLAY_MIN_INLINE_SIZE(this, result);
+ return result;
+}
+
+/* virtual */
+nscoord nsIFrame::GetPrefISize(gfxContext* aRenderingContext) {
+ nscoord result = 0;
+ DISPLAY_PREF_INLINE_SIZE(this, result);
+ return result;
+}
+
+/* virtual */
+void nsIFrame::AddInlineMinISize(gfxContext* aRenderingContext,
+ nsIFrame::InlineMinISizeData* aData) {
+ nscoord isize = nsLayoutUtils::IntrinsicForContainer(
+ aRenderingContext, this, IntrinsicISizeType::MinISize);
+ aData->DefaultAddInlineMinISize(this, isize);
+}
+
+/* virtual */
+void nsIFrame::AddInlinePrefISize(gfxContext* aRenderingContext,
+ nsIFrame::InlinePrefISizeData* aData) {
+ nscoord isize = nsLayoutUtils::IntrinsicForContainer(
+ aRenderingContext, this, IntrinsicISizeType::PrefISize);
+ aData->DefaultAddInlinePrefISize(isize);
+}
+
+void nsIFrame::InlineMinISizeData::DefaultAddInlineMinISize(nsIFrame* aFrame,
+ nscoord aISize,
+ bool aAllowBreak) {
+ auto parent = aFrame->GetParent();
+ MOZ_ASSERT(parent, "Must have a parent if we get here!");
+ const bool mayBreak = aAllowBreak && !aFrame->CanContinueTextRun() &&
+ !parent->Style()->ShouldSuppressLineBreak() &&
+ parent->StyleText()->WhiteSpaceCanWrap(parent);
+ if (mayBreak) {
+ OptionallyBreak();
+ }
+ mTrailingWhitespace = 0;
+ mSkipWhitespace = false;
+ mCurrentLine += aISize;
+ mAtStartOfLine = false;
+ if (mayBreak) {
+ OptionallyBreak();
+ }
+}
+
+void nsIFrame::InlinePrefISizeData::DefaultAddInlinePrefISize(nscoord aISize) {
+ mCurrentLine = NSCoordSaturatingAdd(mCurrentLine, aISize);
+ mTrailingWhitespace = 0;
+ mSkipWhitespace = false;
+ mLineIsEmpty = false;
+}
+
+void nsIFrame::InlineMinISizeData::ForceBreak() {
+ mCurrentLine -= mTrailingWhitespace;
+ mPrevLines = std::max(mPrevLines, mCurrentLine);
+ mCurrentLine = mTrailingWhitespace = 0;
+
+ for (uint32_t i = 0, i_end = mFloats.Length(); i != i_end; ++i) {
+ nscoord float_min = mFloats[i].Width();
+ if (float_min > mPrevLines) mPrevLines = float_min;
+ }
+ mFloats.Clear();
+ mSkipWhitespace = true;
+}
+
+void nsIFrame::InlineMinISizeData::OptionallyBreak(nscoord aHyphenWidth) {
+ // If we can fit more content into a smaller width by staying on this
+ // line (because we're still at a negative offset due to negative
+ // text-indent or negative margin), don't break. Otherwise, do the
+ // same as ForceBreak. it doesn't really matter when we accumulate
+ // floats.
+ if (mCurrentLine + aHyphenWidth < 0 || mAtStartOfLine) return;
+ mCurrentLine += aHyphenWidth;
+ ForceBreak();
+}
+
+void nsIFrame::InlinePrefISizeData::ForceBreak(StyleClear aClearType) {
+ // If this force break is not clearing any float, we can leave all the
+ // floats to the next force break.
+ if (!mFloats.IsEmpty() && aClearType != StyleClear::None) {
+ // preferred widths accumulated for floats that have already
+ // been cleared past
+ nscoord floats_done = 0,
+ // preferred widths accumulated for floats that have not yet
+ // been cleared past
+ floats_cur_left = 0, floats_cur_right = 0;
+
+ for (const FloatInfo& floatInfo : mFloats) {
+ const nsStyleDisplay* floatDisp = floatInfo.Frame()->StyleDisplay();
+ StyleClear clearType = floatDisp->mClear;
+ if (clearType == StyleClear::Left || clearType == StyleClear::Right ||
+ clearType == StyleClear::Both) {
+ nscoord floats_cur =
+ NSCoordSaturatingAdd(floats_cur_left, floats_cur_right);
+ if (floats_cur > floats_done) {
+ floats_done = floats_cur;
+ }
+ if (clearType != StyleClear::Right) {
+ floats_cur_left = 0;
+ }
+ if (clearType != StyleClear::Left) {
+ floats_cur_right = 0;
+ }
+ }
+
+ StyleFloat floatStyle = floatDisp->mFloat;
+ nscoord& floats_cur =
+ floatStyle == StyleFloat::Left ? floats_cur_left : floats_cur_right;
+ nscoord floatWidth = floatInfo.Width();
+ // Negative-width floats don't change the available space so they
+ // shouldn't change our intrinsic line width either.
+ floats_cur = NSCoordSaturatingAdd(floats_cur, std::max(0, floatWidth));
+ }
+
+ nscoord floats_cur =
+ NSCoordSaturatingAdd(floats_cur_left, floats_cur_right);
+ if (floats_cur > floats_done) floats_done = floats_cur;
+
+ mCurrentLine = NSCoordSaturatingAdd(mCurrentLine, floats_done);
+
+ if (aClearType == StyleClear::Both) {
+ mFloats.Clear();
+ } else {
+ // If the break type does not clear all floats, it means there may
+ // be some floats whose isize should contribute to the intrinsic
+ // isize of the next line. The code here scans the current mFloats
+ // and keeps floats which are not cleared by this break. Note that
+ // floats may be cleared directly or indirectly. See below.
+ nsTArray<FloatInfo> newFloats;
+ MOZ_ASSERT(
+ aClearType == StyleClear::Left || aClearType == StyleClear::Right,
+ "Other values should have been handled in other branches");
+ StyleFloat clearFloatType =
+ aClearType == StyleClear::Left ? StyleFloat::Left : StyleFloat::Right;
+ // Iterate the array in reverse so that we can stop when there are
+ // no longer any floats we need to keep. See below.
+ for (FloatInfo& floatInfo : Reversed(mFloats)) {
+ const nsStyleDisplay* floatDisp = floatInfo.Frame()->StyleDisplay();
+ if (floatDisp->mFloat != clearFloatType) {
+ newFloats.AppendElement(floatInfo);
+ } else {
+ // This is a float on the side that this break directly clears
+ // which means we're not keeping it in mFloats. However, if
+ // this float clears floats on the opposite side (via a value
+ // of either 'both' or one of 'left'/'right'), any remaining
+ // (earlier) floats on that side would be indirectly cleared
+ // as well. Thus, we should break out of this loop and stop
+ // considering earlier floats to be kept in mFloats.
+ StyleClear clearType = floatDisp->mClear;
+ if (clearType != aClearType && clearType != StyleClear::None) {
+ break;
+ }
+ }
+ }
+ newFloats.Reverse();
+ mFloats = std::move(newFloats);
+ }
+ }
+
+ mCurrentLine =
+ NSCoordSaturatingSubtract(mCurrentLine, mTrailingWhitespace, nscoord_MAX);
+ mPrevLines = std::max(mPrevLines, mCurrentLine);
+ mCurrentLine = mTrailingWhitespace = 0;
+ mSkipWhitespace = true;
+ mLineIsEmpty = true;
+}
+
+static nscoord ResolveMargin(const LengthPercentageOrAuto& aStyle,
+ nscoord aPercentageBasis) {
+ if (aStyle.IsAuto()) {
+ return nscoord(0);
+ }
+ return nsLayoutUtils::ResolveToLength<false>(aStyle.AsLengthPercentage(),
+ aPercentageBasis);
+}
+
+static nscoord ResolvePadding(const LengthPercentage& aStyle,
+ nscoord aPercentageBasis) {
+ return nsLayoutUtils::ResolveToLength<true>(aStyle, aPercentageBasis);
+}
+
+static nsIFrame::IntrinsicSizeOffsetData IntrinsicSizeOffsets(
+ nsIFrame* aFrame, nscoord aPercentageBasis, bool aForISize) {
+ nsIFrame::IntrinsicSizeOffsetData result;
+ WritingMode wm = aFrame->GetWritingMode();
+ const auto& margin = aFrame->StyleMargin()->mMargin;
+ bool verticalAxis = aForISize == wm.IsVertical();
+ if (verticalAxis) {
+ result.margin += ResolveMargin(margin.Get(eSideTop), aPercentageBasis);
+ result.margin += ResolveMargin(margin.Get(eSideBottom), aPercentageBasis);
+ } else {
+ result.margin += ResolveMargin(margin.Get(eSideLeft), aPercentageBasis);
+ result.margin += ResolveMargin(margin.Get(eSideRight), aPercentageBasis);
+ }
+
+ const auto& padding = aFrame->StylePadding()->mPadding;
+ if (verticalAxis) {
+ result.padding += ResolvePadding(padding.Get(eSideTop), aPercentageBasis);
+ result.padding +=
+ ResolvePadding(padding.Get(eSideBottom), aPercentageBasis);
+ } else {
+ result.padding += ResolvePadding(padding.Get(eSideLeft), aPercentageBasis);
+ result.padding += ResolvePadding(padding.Get(eSideRight), aPercentageBasis);
+ }
+
+ const nsStyleBorder* styleBorder = aFrame->StyleBorder();
+ if (verticalAxis) {
+ result.border += styleBorder->GetComputedBorderWidth(eSideTop);
+ result.border += styleBorder->GetComputedBorderWidth(eSideBottom);
+ } else {
+ result.border += styleBorder->GetComputedBorderWidth(eSideLeft);
+ result.border += styleBorder->GetComputedBorderWidth(eSideRight);
+ }
+
+ const nsStyleDisplay* disp = aFrame->StyleDisplay();
+ if (aFrame->IsThemed(disp)) {
+ nsPresContext* presContext = aFrame->PresContext();
+
+ LayoutDeviceIntMargin border = presContext->Theme()->GetWidgetBorder(
+ presContext->DeviceContext(), aFrame, disp->EffectiveAppearance());
+ result.border = presContext->DevPixelsToAppUnits(
+ verticalAxis ? border.TopBottom() : border.LeftRight());
+
+ LayoutDeviceIntMargin padding;
+ if (presContext->Theme()->GetWidgetPadding(
+ presContext->DeviceContext(), aFrame, disp->EffectiveAppearance(),
+ &padding)) {
+ result.padding = presContext->DevPixelsToAppUnits(
+ verticalAxis ? padding.TopBottom() : padding.LeftRight());
+ }
+ }
+ return result;
+}
+
+/* virtual */ nsIFrame::IntrinsicSizeOffsetData nsIFrame::IntrinsicISizeOffsets(
+ nscoord aPercentageBasis) {
+ return IntrinsicSizeOffsets(this, aPercentageBasis, true);
+}
+
+nsIFrame::IntrinsicSizeOffsetData nsIFrame::IntrinsicBSizeOffsets(
+ nscoord aPercentageBasis) {
+ return IntrinsicSizeOffsets(this, aPercentageBasis, false);
+}
+
+/* virtual */
+IntrinsicSize nsIFrame::GetIntrinsicSize() {
+ return IntrinsicSize(); // default is width/height set to eStyleUnit_None
+}
+
+AspectRatio nsIFrame::GetAspectRatio() const {
+ // Per spec, 'aspect-ratio' property applies to all elements except inline
+ // boxes and internal ruby or table boxes.
+ // https://drafts.csswg.org/css-sizing-4/#aspect-ratio
+ // For those frame types that don't support aspect-ratio, they must not have
+ // the natural ratio, so this early return is fine.
+ if (!SupportsAspectRatio()) {
+ return AspectRatio();
+ }
+
+ const StyleAspectRatio& aspectRatio = StylePosition()->mAspectRatio;
+ // If aspect-ratio is zero or infinite, it's a degenerate ratio and behaves
+ // as auto.
+ // https://drafts.csswg.org/css-sizing-4/#valdef-aspect-ratio-ratio
+ if (!aspectRatio.BehavesAsAuto()) {
+ // Non-auto. Return the preferred aspect ratio from the aspect-ratio style.
+ return aspectRatio.ratio.AsRatio().ToLayoutRatio(UseBoxSizing::Yes);
+ }
+
+ // The rest of the cases are when aspect-ratio has 'auto'.
+ if (auto intrinsicRatio = GetIntrinsicRatio()) {
+ return intrinsicRatio;
+ }
+
+ if (aspectRatio.HasRatio()) {
+ // If it's a degenerate ratio, this returns 0. Just the same as the auto
+ // case.
+ return aspectRatio.ratio.AsRatio().ToLayoutRatio(UseBoxSizing::No);
+ }
+
+ return AspectRatio();
+}
+
+/* virtual */
+AspectRatio nsIFrame::GetIntrinsicRatio() const { return AspectRatio(); }
+
+static bool ShouldApplyAutomaticMinimumOnInlineAxis(
+ WritingMode aWM, const nsStyleDisplay* aDisplay,
+ const nsStylePosition* aPosition) {
+ // Apply the automatic minimum size for aspect ratio:
+ // Note: The replaced elements shouldn't be here, so we only check the scroll
+ // container.
+ // https://drafts.csswg.org/css-sizing-4/#aspect-ratio-minimum
+ return !aDisplay->IsScrollableOverflow() && aPosition->MinISize(aWM).IsAuto();
+}
+
+struct MinMaxSize {
+ nscoord mMinSize = 0;
+ nscoord mMaxSize = NS_UNCONSTRAINEDSIZE;
+
+ nscoord ClampSizeToMinAndMax(nscoord aSize) const {
+ return NS_CSS_MINMAX(aSize, mMinSize, mMaxSize);
+ }
+};
+static MinMaxSize ComputeTransferredMinMaxInlineSize(
+ const WritingMode aWM, const AspectRatio& aAspectRatio,
+ const MinMaxSize& aMinMaxBSize, const LogicalSize& aBoxSizingAdjustment) {
+ // Note: the spec mentions that
+ // 1. This transferred minimum is capped by any definite preferred or maximum
+ // size in the destination axis.
+ // 2. This transferred maximum is floored by any definite preferred or minimum
+ // size in the destination axis
+ //
+ // https://drafts.csswg.org/css-sizing-4/#aspect-ratio
+ //
+ // The spec requires us to clamp these by the specified size (it calls it the
+ // preferred size). However, we actually don't need to worry about that,
+ // because we only use this if the inline size is indefinite.
+ //
+ // We do not need to clamp the transferred minimum and maximum as long as we
+ // always apply the transferred min/max size before the explicit min/max size,
+ // the result will be identical.
+
+ MinMaxSize transferredISize;
+
+ if (aMinMaxBSize.mMinSize > 0) {
+ transferredISize.mMinSize = aAspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisInline, aWM, aMinMaxBSize.mMinSize,
+ aBoxSizingAdjustment);
+ }
+
+ if (aMinMaxBSize.mMaxSize != NS_UNCONSTRAINEDSIZE) {
+ transferredISize.mMaxSize = aAspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisInline, aWM, aMinMaxBSize.mMaxSize,
+ aBoxSizingAdjustment);
+ }
+
+ // Minimum size wins over maximum size.
+ transferredISize.mMaxSize =
+ std::max(transferredISize.mMinSize, transferredISize.mMaxSize);
+ return transferredISize;
+}
+
+/* virtual */
+nsIFrame::SizeComputationResult nsIFrame::ComputeSize(
+ gfxContext* aRenderingContext, WritingMode aWM, const LogicalSize& aCBSize,
+ nscoord aAvailableISize, const LogicalSize& aMargin,
+ const LogicalSize& aBorderPadding, const StyleSizeOverrides& aSizeOverrides,
+ ComputeSizeFlags aFlags) {
+ MOZ_ASSERT(!GetIntrinsicRatio(),
+ "Please override this method and call "
+ "nsContainerFrame::ComputeSizeWithIntrinsicDimensions instead.");
+ LogicalSize result =
+ ComputeAutoSize(aRenderingContext, aWM, aCBSize, aAvailableISize, aMargin,
+ aBorderPadding, aSizeOverrides, aFlags);
+ const nsStylePosition* stylePos = StylePosition();
+ const nsStyleDisplay* disp = StyleDisplay();
+ auto aspectRatioUsage = AspectRatioUsage::None;
+
+ const auto boxSizingAdjust = stylePos->mBoxSizing == StyleBoxSizing::Border
+ ? aBorderPadding
+ : LogicalSize(aWM);
+ nscoord boxSizingToMarginEdgeISize = aMargin.ISize(aWM) +
+ aBorderPadding.ISize(aWM) -
+ boxSizingAdjust.ISize(aWM);
+
+ const auto& styleISize = aSizeOverrides.mStyleISize
+ ? *aSizeOverrides.mStyleISize
+ : stylePos->ISize(aWM);
+ const auto& styleBSize = aSizeOverrides.mStyleBSize
+ ? *aSizeOverrides.mStyleBSize
+ : stylePos->BSize(aWM);
+ const auto& aspectRatio = aSizeOverrides.mAspectRatio
+ ? *aSizeOverrides.mAspectRatio
+ : GetAspectRatio();
+
+ auto parentFrame = GetParent();
+ auto alignCB = parentFrame;
+ bool isGridItem = IsGridItem();
+ const bool isSubgrid = IsSubgrid();
+ if (parentFrame && parentFrame->IsTableWrapperFrame() && IsTableFrame()) {
+ // An inner table frame is sized as a grid item if its table wrapper is,
+ // because they actually have the same CB (the wrapper's CB).
+ // @see ReflowInput::InitCBReflowInput
+ auto tableWrapper = GetParent();
+ auto grandParent = tableWrapper->GetParent();
+ isGridItem = grandParent->IsGridContainerFrame() &&
+ !tableWrapper->HasAnyStateBits(NS_FRAME_OUT_OF_FLOW);
+ if (isGridItem) {
+ // When resolving justify/align-self below, we want to use the grid
+ // container's justify/align-items value and WritingMode.
+ alignCB = grandParent;
+ }
+ }
+ const bool isFlexItem =
+ IsFlexItem() && !parentFrame->HasAnyStateBits(
+ NS_STATE_FLEX_IS_EMULATING_LEGACY_WEBKIT_BOX);
+ // This variable only gets set (and used) if isFlexItem is true. It
+ // indicates which axis (in this frame's own WM) corresponds to its
+ // flex container's main axis.
+ LogicalAxis flexMainAxis =
+ eLogicalAxisInline; // (init to make valgrind happy)
+ if (isFlexItem) {
+ flexMainAxis = nsFlexContainerFrame::IsItemInlineAxisMainAxis(this)
+ ? eLogicalAxisInline
+ : eLogicalAxisBlock;
+ }
+
+ const bool isOrthogonal = aWM.IsOrthogonalTo(alignCB->GetWritingMode());
+ const bool isAutoISize = styleISize.IsAuto();
+ const bool isAutoBSize =
+ nsLayoutUtils::IsAutoBSize(styleBSize, aCBSize.BSize(aWM));
+
+ // Compute inline-axis size
+ const bool isSubgriddedInInlineAxis =
+ isSubgrid && static_cast<nsGridContainerFrame*>(this)->IsColSubgrid();
+
+ // Per https://drafts.csswg.org/css-grid/#subgrid-box-alignment, if we are
+ // subgridded in the inline-axis, ignore our style inline-size, and stretch to
+ // fill the CB.
+ const bool shouldComputeISize = !isAutoISize && !isSubgriddedInInlineAxis;
+ if (shouldComputeISize) {
+ auto iSizeResult = ComputeISizeValue(
+ aRenderingContext, aWM, aCBSize, boxSizingAdjust,
+ boxSizingToMarginEdgeISize, styleISize, aSizeOverrides, aFlags);
+ result.ISize(aWM) = iSizeResult.mISize;
+ aspectRatioUsage = iSizeResult.mAspectRatioUsage;
+ } else if (MOZ_UNLIKELY(isGridItem) && !IsTrueOverflowContainer()) {
+ // 'auto' inline-size for grid-level box - fill the CB for 'stretch' /
+ // 'normal' and clamp it to the CB if requested:
+ bool stretch = false;
+ bool mayUseAspectRatio = aspectRatio && !isAutoBSize;
+ if (!aFlags.contains(ComputeSizeFlag::ShrinkWrap) &&
+ !StyleMargin()->HasInlineAxisAuto(aWM) &&
+ !alignCB->IsMasonry(isOrthogonal ? eLogicalAxisBlock
+ : eLogicalAxisInline)) {
+ auto inlineAxisAlignment =
+ isOrthogonal ? StylePosition()->UsedAlignSelf(alignCB->Style())._0
+ : StylePosition()->UsedJustifySelf(alignCB->Style())._0;
+ stretch = inlineAxisAlignment == StyleAlignFlags::STRETCH ||
+ (inlineAxisAlignment == StyleAlignFlags::NORMAL &&
+ !mayUseAspectRatio);
+ }
+
+ // Apply the preferred aspect ratio for alignments other than *stretch* and
+ // *normal without aspect ratio*.
+ // The spec says all other values should size the items as fit-content, and
+ // the intrinsic size should respect the preferred aspect ratio, so we also
+ // apply aspect ratio for all other values.
+ // https://drafts.csswg.org/css-grid/#grid-item-sizing
+ if (!stretch && mayUseAspectRatio) {
+ // Note: we don't need to handle aspect ratio for inline axis if both
+ // width/height are auto. The default ratio-dependent axis is block axis
+ // in this case, so we can simply get the block size from the non-auto
+ // |styleBSize|.
+ auto bSize = nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ styleBSize.AsLengthPercentage());
+ result.ISize(aWM) = aspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisInline, aWM, bSize, boxSizingAdjust);
+ aspectRatioUsage = AspectRatioUsage::ToComputeISize;
+ }
+
+ if (stretch || aFlags.contains(ComputeSizeFlag::IClampMarginBoxMinSize)) {
+ auto iSizeToFillCB =
+ std::max(nscoord(0), aCBSize.ISize(aWM) - aBorderPadding.ISize(aWM) -
+ aMargin.ISize(aWM));
+ if (stretch || result.ISize(aWM) > iSizeToFillCB) {
+ result.ISize(aWM) = iSizeToFillCB;
+ }
+ }
+ } else if (aspectRatio && !isAutoBSize) {
+ auto bSize = nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ styleBSize.AsLengthPercentage());
+ result.ISize(aWM) = aspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisInline, aWM, bSize, boxSizingAdjust);
+ aspectRatioUsage = AspectRatioUsage::ToComputeISize;
+ }
+
+ // Calculate and apply transferred min & max size contraints.
+ // https://drafts.csswg.org/css-sizing-4/#aspect-ratio-size-transfers
+ //
+ // Note: The basic principle is that sizing constraints transfer through the
+ // aspect-ratio to the other side to preserve the aspect ratio to the extent
+ // that they can without violating any sizes specified explicitly on that
+ // affected axis.
+ //
+ // FIXME: The spec words may not be correct, so we may have to update this
+ // tentative solution once this spec issue gets resolved. Here, we clamp the
+ // flex base size by the transferred min and max sizes, and don't include
+ // the transferred min & max sizes into its used min & max sizes. So this
+ // lets us match other browsers' current behaviors.
+ // https://github.com/w3c/csswg-drafts/issues/6071
+ //
+ // Note: This may make more sense if we clamp the flex base size in
+ // FlexItem::ResolveFlexBaseSizeFromAspectRatio(). However, the result should
+ // be identical. FlexItem::ResolveFlexBaseSizeFromAspectRatio() only handles
+ // the case of the definite cross size, and the definite cross size is clamped
+ // by the min & max cross sizes below in this function. This means its flex
+ // base size has been clamped by the transferred min & max size already after
+ // generating the flex items. So here we make the code more general for both
+ // definite cross size and indefinite cross size.
+ const bool isDefiniteISize = styleISize.IsLengthPercentage();
+ const auto& minBSizeCoord = stylePos->MinBSize(aWM);
+ const auto& maxBSizeCoord = stylePos->MaxBSize(aWM);
+ const bool isAutoMinBSize =
+ nsLayoutUtils::IsAutoBSize(minBSizeCoord, aCBSize.BSize(aWM));
+ const bool isAutoMaxBSize =
+ nsLayoutUtils::IsAutoBSize(maxBSizeCoord, aCBSize.BSize(aWM));
+ if (aspectRatio && !isDefiniteISize) {
+ const MinMaxSize minMaxBSize{
+ isAutoMinBSize ? 0
+ : nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ minBSizeCoord.AsLengthPercentage()),
+ isAutoMaxBSize ? NS_UNCONSTRAINEDSIZE
+ : nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ maxBSizeCoord.AsLengthPercentage())};
+ MinMaxSize transferredMinMaxISize = ComputeTransferredMinMaxInlineSize(
+ aWM, aspectRatio, minMaxBSize, boxSizingAdjust);
+
+ result.ISize(aWM) =
+ transferredMinMaxISize.ClampSizeToMinAndMax(result.ISize(aWM));
+ }
+
+ // Flex items ignore their min & max sizing properties in their
+ // flex container's main-axis. (Those properties get applied later in
+ // the flexbox algorithm.)
+ const bool isFlexItemInlineAxisMainAxis =
+ isFlexItem && flexMainAxis == eLogicalAxisInline;
+ // Grid items that are subgridded in inline-axis also ignore their min & max
+ // sizing properties in that axis.
+ const bool shouldIgnoreMinMaxISize =
+ isFlexItemInlineAxisMainAxis || isSubgriddedInInlineAxis;
+ const auto& maxISizeCoord = stylePos->MaxISize(aWM);
+ nscoord maxISize = NS_UNCONSTRAINEDSIZE;
+ if (!maxISizeCoord.IsNone() && !shouldIgnoreMinMaxISize) {
+ maxISize = ComputeISizeValue(aRenderingContext, aWM, aCBSize,
+ boxSizingAdjust, boxSizingToMarginEdgeISize,
+ maxISizeCoord, aSizeOverrides, aFlags)
+ .mISize;
+ result.ISize(aWM) = std::min(maxISize, result.ISize(aWM));
+ }
+
+ const auto& minISizeCoord = stylePos->MinISize(aWM);
+ nscoord minISize;
+ if (!minISizeCoord.IsAuto() && !shouldIgnoreMinMaxISize) {
+ minISize = ComputeISizeValue(aRenderingContext, aWM, aCBSize,
+ boxSizingAdjust, boxSizingToMarginEdgeISize,
+ minISizeCoord, aSizeOverrides, aFlags)
+ .mISize;
+ } else if (MOZ_UNLIKELY(
+ aFlags.contains(ComputeSizeFlag::IApplyAutoMinSize))) {
+ // This implements "Implied Minimum Size of Grid Items".
+ // https://drafts.csswg.org/css-grid/#min-size-auto
+ minISize = std::min(maxISize, GetMinISize(aRenderingContext));
+ if (styleISize.IsLengthPercentage()) {
+ minISize = std::min(minISize, result.ISize(aWM));
+ } else if (aFlags.contains(ComputeSizeFlag::IClampMarginBoxMinSize)) {
+ // "if the grid item spans only grid tracks that have a fixed max track
+ // sizing function, its automatic minimum size in that dimension is
+ // further clamped to less than or equal to the size necessary to fit
+ // its margin box within the resulting grid area (flooring at zero)"
+ // https://drafts.csswg.org/css-grid/#min-size-auto
+ auto maxMinISize =
+ std::max(nscoord(0), aCBSize.ISize(aWM) - aBorderPadding.ISize(aWM) -
+ aMargin.ISize(aWM));
+ minISize = std::min(minISize, maxMinISize);
+ }
+ } else if (aspectRatioUsage == AspectRatioUsage::ToComputeISize &&
+ ShouldApplyAutomaticMinimumOnInlineAxis(aWM, disp, stylePos)) {
+ // This means we successfully applied aspect-ratio and now need to check
+ // if we need to apply the implied minimum size:
+ // https://drafts.csswg.org/css-sizing-4/#aspect-ratio-minimum
+ MOZ_ASSERT(!HasReplacedSizing(),
+ "aspect-ratio minimums should not apply to replaced elements");
+ // The inline size computed by aspect-ratio shouldn't less than the content
+ // size.
+ minISize = GetMinISize(aRenderingContext);
+ } else {
+ // Treat "min-width: auto" as 0.
+ // NOTE: Technically, "auto" is supposed to behave like "min-content" on
+ // flex items. However, we don't need to worry about that here, because
+ // flex items' min-sizes are intentionally ignored until the flex
+ // container explicitly considers them during space distribution.
+ minISize = 0;
+ }
+ result.ISize(aWM) = std::max(minISize, result.ISize(aWM));
+
+ // Compute block-axis size
+ // (but not if we have auto bsize -- then, we'll just stick with the bsize
+ // that we already calculated in the initial ComputeAutoSize() call. However,
+ // if we have a valid preferred aspect ratio, we still have to compute the
+ // block size because aspect ratio affects the intrinsic content size.)
+ const bool isSubgriddedInBlockAxis =
+ isSubgrid && static_cast<nsGridContainerFrame*>(this)->IsRowSubgrid();
+
+ // Per https://drafts.csswg.org/css-grid/#subgrid-box-alignment, if we are
+ // subgridded in the block-axis, ignore our style block-size, and stretch to
+ // fill the CB.
+ const bool shouldComputeBSize = !isAutoBSize && !isSubgriddedInBlockAxis;
+ if (shouldComputeBSize) {
+ result.BSize(aWM) = nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ styleBSize.AsLengthPercentage());
+ } else if (MOZ_UNLIKELY(isGridItem) && styleBSize.IsAuto() &&
+ !aFlags.contains(ComputeSizeFlag::IsGridMeasuringReflow) &&
+ !IsTrueOverflowContainer() &&
+ !alignCB->IsMasonry(isOrthogonal ? eLogicalAxisInline
+ : eLogicalAxisBlock)) {
+ auto cbSize = aCBSize.BSize(aWM);
+ if (cbSize != NS_UNCONSTRAINEDSIZE) {
+ // 'auto' block-size for grid-level box - fill the CB for 'stretch' /
+ // 'normal' and clamp it to the CB if requested:
+ bool stretch = false;
+ bool mayUseAspectRatio =
+ aspectRatio && result.ISize(aWM) != NS_UNCONSTRAINEDSIZE;
+ if (!StyleMargin()->HasBlockAxisAuto(aWM)) {
+ auto blockAxisAlignment =
+ isOrthogonal ? StylePosition()->UsedJustifySelf(alignCB->Style())._0
+ : StylePosition()->UsedAlignSelf(alignCB->Style())._0;
+ stretch = blockAxisAlignment == StyleAlignFlags::STRETCH ||
+ (blockAxisAlignment == StyleAlignFlags::NORMAL &&
+ !mayUseAspectRatio);
+ }
+
+ // Apply the preferred aspect ratio for alignments other than *stretch*
+ // and *normal without aspect ratio*.
+ // The spec says all other values should size the items as fit-content,
+ // and the intrinsic size should respect the preferred aspect ratio, so
+ // we also apply aspect ratio for all other values.
+ // https://drafts.csswg.org/css-grid/#grid-item-sizing
+ if (!stretch && mayUseAspectRatio) {
+ result.BSize(aWM) = aspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisBlock, aWM, result.ISize(aWM),
+ boxSizingAdjust);
+ MOZ_ASSERT(aspectRatioUsage == AspectRatioUsage::None);
+ aspectRatioUsage = AspectRatioUsage::ToComputeBSize;
+ }
+
+ if (stretch || aFlags.contains(ComputeSizeFlag::BClampMarginBoxMinSize)) {
+ auto bSizeToFillCB =
+ std::max(nscoord(0),
+ cbSize - aBorderPadding.BSize(aWM) - aMargin.BSize(aWM));
+ if (stretch || (result.BSize(aWM) != NS_UNCONSTRAINEDSIZE &&
+ result.BSize(aWM) > bSizeToFillCB)) {
+ result.BSize(aWM) = bSizeToFillCB;
+ }
+ }
+ }
+ } else if (aspectRatio) {
+ // If both inline and block dimensions are auto, the block axis is the
+ // ratio-dependent axis by default.
+ // If we have a super large inline size, aspect-ratio should still be
+ // applied (so aspectRatioUsage flag is set as expected). That's why we
+ // apply aspect-ratio unconditionally for auto block size here.
+ result.BSize(aWM) = aspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisBlock, aWM, result.ISize(aWM),
+ boxSizingAdjust);
+ MOZ_ASSERT(aspectRatioUsage == AspectRatioUsage::None);
+ aspectRatioUsage = AspectRatioUsage::ToComputeBSize;
+ }
+
+ if (result.BSize(aWM) != NS_UNCONSTRAINEDSIZE) {
+ // Flex items ignore their min & max sizing properties in their flex
+ // container's main-axis. (Those properties get applied later in the flexbox
+ // algorithm.)
+ const bool isFlexItemBlockAxisMainAxis =
+ isFlexItem && flexMainAxis == eLogicalAxisBlock;
+ // Grid items that are subgridded in block-axis also ignore their min & max
+ // sizing properties in that axis.
+ const bool shouldIgnoreMinMaxBSize =
+ isFlexItemBlockAxisMainAxis || isSubgriddedInBlockAxis;
+ if (!isAutoMaxBSize && !shouldIgnoreMinMaxBSize) {
+ nscoord maxBSize = nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ maxBSizeCoord.AsLengthPercentage());
+ result.BSize(aWM) = std::min(maxBSize, result.BSize(aWM));
+ }
+
+ if (!isAutoMinBSize && !shouldIgnoreMinMaxBSize) {
+ nscoord minBSize = nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), boxSizingAdjust.BSize(aWM),
+ minBSizeCoord.AsLengthPercentage());
+ result.BSize(aWM) = std::max(minBSize, result.BSize(aWM));
+ }
+ }
+
+ if (IsThemed(disp)) {
+ nsPresContext* pc = PresContext();
+ const LayoutDeviceIntSize widget = pc->Theme()->GetMinimumWidgetSize(
+ pc, this, disp->EffectiveAppearance());
+
+ // Convert themed widget's physical dimensions to logical coords
+ LogicalSize size(aWM, LayoutDeviceIntSize::ToAppUnits(
+ widget, pc->AppUnitsPerDevPixel()));
+
+ // GetMinimumWidgetSize() returns border-box; we need content-box.
+ size -= aBorderPadding;
+
+ if (size.BSize(aWM) > result.BSize(aWM)) {
+ result.BSize(aWM) = size.BSize(aWM);
+ }
+ if (size.ISize(aWM) > result.ISize(aWM)) {
+ result.ISize(aWM) = size.ISize(aWM);
+ }
+ }
+
+ result.ISize(aWM) = std::max(0, result.ISize(aWM));
+ result.BSize(aWM) = std::max(0, result.BSize(aWM));
+
+ return {result, aspectRatioUsage};
+}
+
+nsRect nsIFrame::ComputeTightBounds(DrawTarget* aDrawTarget) const {
+ return InkOverflowRect();
+}
+
+/* virtual */
+nsresult nsIFrame::GetPrefWidthTightBounds(gfxContext* aContext, nscoord* aX,
+ nscoord* aXMost) {
+ return NS_ERROR_NOT_IMPLEMENTED;
+}
+
+/* virtual */
+LogicalSize nsIFrame::ComputeAutoSize(
+ gfxContext* aRenderingContext, WritingMode aWM,
+ const mozilla::LogicalSize& aCBSize, nscoord aAvailableISize,
+ const mozilla::LogicalSize& aMargin,
+ const mozilla::LogicalSize& aBorderPadding,
+ const StyleSizeOverrides& aSizeOverrides, ComputeSizeFlags aFlags) {
+ // Use basic shrink-wrapping as a default implementation.
+ LogicalSize result(aWM, 0xdeadbeef, NS_UNCONSTRAINEDSIZE);
+
+ // don't bother setting it if the result won't be used
+ const auto& styleISize = aSizeOverrides.mStyleISize
+ ? *aSizeOverrides.mStyleISize
+ : StylePosition()->ISize(aWM);
+ if (styleISize.IsAuto()) {
+ nscoord availBased =
+ aAvailableISize - aMargin.ISize(aWM) - aBorderPadding.ISize(aWM);
+ result.ISize(aWM) = ShrinkISizeToFit(aRenderingContext, availBased, aFlags);
+ }
+ return result;
+}
+
+nscoord nsIFrame::ShrinkISizeToFit(gfxContext* aRenderingContext,
+ nscoord aISizeInCB,
+ ComputeSizeFlags aFlags) {
+ // If we're a container for font size inflation, then shrink
+ // wrapping inside of us should not apply font size inflation.
+ AutoMaybeDisableFontInflation an(this);
+
+ nscoord result;
+ nscoord minISize = GetMinISize(aRenderingContext);
+ if (minISize > aISizeInCB) {
+ const bool clamp = aFlags.contains(ComputeSizeFlag::IClampMarginBoxMinSize);
+ result = MOZ_UNLIKELY(clamp) ? aISizeInCB : minISize;
+ } else {
+ nscoord prefISize = GetPrefISize(aRenderingContext);
+ if (prefISize > aISizeInCB) {
+ result = aISizeInCB;
+ } else {
+ result = prefISize;
+ }
+ }
+ return result;
+}
+
+Maybe<nscoord> nsIFrame::ComputeInlineSizeFromAspectRatio(
+ WritingMode aWM, const LogicalSize& aCBSize,
+ const LogicalSize& aContentEdgeToBoxSizing,
+ const StyleSizeOverrides& aSizeOverrides, ComputeSizeFlags aFlags) const {
+ // FIXME: Bug 1670151: Use GetAspectRatio() to cover replaced elements (and
+ // then we can drop the check of eSupportsAspectRatio).
+ const AspectRatio aspectRatio =
+ aSizeOverrides.mAspectRatio
+ ? *aSizeOverrides.mAspectRatio
+ : StylePosition()->mAspectRatio.ToLayoutRatio();
+ if (!SupportsAspectRatio() || !aspectRatio) {
+ return Nothing();
+ }
+
+ const StyleSize& styleBSize = aSizeOverrides.mStyleBSize
+ ? *aSizeOverrides.mStyleBSize
+ : StylePosition()->BSize(aWM);
+ if (nsLayoutUtils::IsAutoBSize(styleBSize, aCBSize.BSize(aWM))) {
+ return Nothing();
+ }
+
+ MOZ_ASSERT(styleBSize.IsLengthPercentage());
+ nscoord bSize = nsLayoutUtils::ComputeBSizeValue(
+ aCBSize.BSize(aWM), aContentEdgeToBoxSizing.BSize(aWM),
+ styleBSize.AsLengthPercentage());
+ return Some(aspectRatio.ComputeRatioDependentSize(
+ LogicalAxis::eLogicalAxisInline, aWM, bSize, aContentEdgeToBoxSizing));
+}
+
+nsIFrame::ISizeComputationResult nsIFrame::ComputeISizeValue(
+ gfxContext* aRenderingContext, const WritingMode aWM,
+ const LogicalSize& aContainingBlockSize,
+ const LogicalSize& aContentEdgeToBoxSizing, nscoord aBoxSizingToMarginEdge,
+ ExtremumLength aSize, Maybe<nscoord> aAvailableISizeOverride,
+ const StyleSizeOverrides& aSizeOverrides, ComputeSizeFlags aFlags) {
+ // If 'this' is a container for font size inflation, then shrink
+ // wrapping inside of it should not apply font size inflation.
+ AutoMaybeDisableFontInflation an(this);
+ // If we have an aspect-ratio and a definite block size, we resolve the
+ // min-content and max-content size by the aspect-ratio and the block size.
+ // https://github.com/w3c/csswg-drafts/issues/5032
+ Maybe<nscoord> intrinsicSizeFromAspectRatio =
+ aSize == ExtremumLength::MozAvailable
+ ? Nothing()
+ : ComputeInlineSizeFromAspectRatio(aWM, aContainingBlockSize,
+ aContentEdgeToBoxSizing,
+ aSizeOverrides, aFlags);
+ nscoord result;
+ switch (aSize) {
+ case ExtremumLength::MaxContent:
+ result = intrinsicSizeFromAspectRatio ? *intrinsicSizeFromAspectRatio
+ : GetPrefISize(aRenderingContext);
+ NS_ASSERTION(result >= 0, "inline-size less than zero");
+ return {result, intrinsicSizeFromAspectRatio
+ ? AspectRatioUsage::ToComputeISize
+ : AspectRatioUsage::None};
+ case ExtremumLength::MinContent:
+ result = intrinsicSizeFromAspectRatio ? *intrinsicSizeFromAspectRatio
+ : GetMinISize(aRenderingContext);
+ NS_ASSERTION(result >= 0, "inline-size less than zero");
+ if (MOZ_UNLIKELY(
+ aFlags.contains(ComputeSizeFlag::IClampMarginBoxMinSize))) {
+ auto available =
+ aContainingBlockSize.ISize(aWM) -
+ (aBoxSizingToMarginEdge + aContentEdgeToBoxSizing.ISize(aWM));
+ result = std::min(available, result);
+ }
+ return {result, intrinsicSizeFromAspectRatio
+ ? AspectRatioUsage::ToComputeISize
+ : AspectRatioUsage::None};
+ case ExtremumLength::FitContentFunction:
+ case ExtremumLength::FitContent: {
+ nscoord pref = NS_UNCONSTRAINEDSIZE;
+ nscoord min = 0;
+ if (intrinsicSizeFromAspectRatio) {
+ // The min-content and max-content size are identical and equal to the
+ // size computed from the block size and the aspect ratio.
+ pref = min = *intrinsicSizeFromAspectRatio;
+ } else {
+ pref = GetPrefISize(aRenderingContext);
+ min = GetMinISize(aRenderingContext);
+ }
+
+ nscoord fill = aAvailableISizeOverride
+ ? *aAvailableISizeOverride
+ : aContainingBlockSize.ISize(aWM) -
+ (aBoxSizingToMarginEdge +
+ aContentEdgeToBoxSizing.ISize(aWM));
+
+ if (MOZ_UNLIKELY(
+ aFlags.contains(ComputeSizeFlag::IClampMarginBoxMinSize))) {
+ min = std::min(min, fill);
+ }
+ result = std::max(min, std::min(pref, fill));
+ NS_ASSERTION(result >= 0, "inline-size less than zero");
+ return {result};
+ }
+ case ExtremumLength::MozAvailable:
+ return {aContainingBlockSize.ISize(aWM) -
+ (aBoxSizingToMarginEdge + aContentEdgeToBoxSizing.ISize(aWM))};
+ }
+ MOZ_ASSERT_UNREACHABLE("Unknown extremum length?");
+ return {};
+}
+
+nscoord nsIFrame::ComputeISizeValue(const WritingMode aWM,
+ const LogicalSize& aContainingBlockSize,
+ const LogicalSize& aContentEdgeToBoxSizing,
+ const LengthPercentage& aSize) {
+ LAYOUT_WARN_IF_FALSE(
+ aContainingBlockSize.ISize(aWM) != NS_UNCONSTRAINEDSIZE,
+ "have unconstrained inline-size; this should only result from "
+ "very large sizes, not attempts at intrinsic inline-size "
+ "calculation");
+ NS_ASSERTION(aContainingBlockSize.ISize(aWM) >= 0,
+ "inline-size less than zero");
+
+ nscoord result = aSize.Resolve(aContainingBlockSize.ISize(aWM));
+ // The result of a calc() expression might be less than 0; we
+ // should clamp at runtime (below). (Percentages and coords that
+ // are less than 0 have already been dropped by the parser.)
+ result -= aContentEdgeToBoxSizing.ISize(aWM);
+ return std::max(0, result);
+}
+
+void nsIFrame::DidReflow(nsPresContext* aPresContext,
+ const ReflowInput* aReflowInput) {
+ NS_FRAME_TRACE(NS_FRAME_TRACE_CALLS, ("nsIFrame::DidReflow"));
+
+ if (IsHiddenByContentVisibilityOfInFlowParentForLayout()) {
+ RemoveStateBits(NS_FRAME_IN_REFLOW);
+ return;
+ }
+
+ SVGObserverUtils::InvalidateDirectRenderingObservers(
+ this, SVGObserverUtils::INVALIDATE_REFLOW);
+
+ RemoveStateBits(NS_FRAME_IN_REFLOW | NS_FRAME_FIRST_REFLOW |
+ NS_FRAME_IS_DIRTY | NS_FRAME_HAS_DIRTY_CHILDREN);
+
+ // Clear bits that were used in ReflowInput::InitResizeFlags (see
+ // comment there for why we can't clear it there).
+ SetHasBSizeChange(false);
+ SetHasPaddingChange(false);
+
+ // Notify the percent bsize observer if there is a percent bsize.
+ // The observer may be able to initiate another reflow with a computed
+ // bsize. This happens in the case where a table cell has no computed
+ // bsize but can fabricate one when the cell bsize is known.
+ if (aReflowInput && aReflowInput->mPercentBSizeObserver && !GetPrevInFlow()) {
+ const auto& bsize =
+ aReflowInput->mStylePosition->BSize(aReflowInput->GetWritingMode());
+ if (bsize.HasPercent()) {
+ aReflowInput->mPercentBSizeObserver->NotifyPercentBSize(*aReflowInput);
+ }
+ }
+
+ aPresContext->ReflowedFrame();
+}
+
+void nsIFrame::FinishReflowWithAbsoluteFrames(nsPresContext* aPresContext,
+ ReflowOutput& aDesiredSize,
+ const ReflowInput& aReflowInput,
+ nsReflowStatus& aStatus,
+ bool aConstrainBSize) {
+ ReflowAbsoluteFrames(aPresContext, aDesiredSize, aReflowInput, aStatus,
+ aConstrainBSize);
+
+ FinishAndStoreOverflow(&aDesiredSize, aReflowInput.mStyleDisplay);
+}
+
+void nsIFrame::ReflowAbsoluteFrames(nsPresContext* aPresContext,
+ ReflowOutput& aDesiredSize,
+ const ReflowInput& aReflowInput,
+ nsReflowStatus& aStatus,
+ bool aConstrainBSize) {
+ if (HasAbsolutelyPositionedChildren()) {
+ nsAbsoluteContainingBlock* absoluteContainer = GetAbsoluteContainingBlock();
+
+ // Let the absolutely positioned container reflow any absolutely positioned
+ // child frames that need to be reflowed
+
+ // The containing block for the abs pos kids is formed by our padding edge.
+ nsMargin usedBorder = GetUsedBorder();
+ nscoord containingBlockWidth =
+ std::max(0, aDesiredSize.Width() - usedBorder.LeftRight());
+ nscoord containingBlockHeight =
+ std::max(0, aDesiredSize.Height() - usedBorder.TopBottom());
+ nsContainerFrame* container = do_QueryFrame(this);
+ NS_ASSERTION(container,
+ "Abs-pos children only supported on container frames for now");
+
+ nsRect containingBlock(0, 0, containingBlockWidth, containingBlockHeight);
+ AbsPosReflowFlags flags =
+ AbsPosReflowFlags::CBWidthAndHeightChanged; // XXX could be optimized
+ if (aConstrainBSize) {
+ flags |= AbsPosReflowFlags::ConstrainHeight;
+ }
+ absoluteContainer->Reflow(container, aPresContext, aReflowInput, aStatus,
+ containingBlock, flags,
+ &aDesiredSize.mOverflowAreas);
+ }
+}
+
+/* virtual */
+bool nsIFrame::CanContinueTextRun() const {
+ // By default, a frame will *not* allow a text run to be continued
+ // through it.
+ return false;
+}
+
+void nsIFrame::Reflow(nsPresContext* aPresContext, ReflowOutput& aDesiredSize,
+ const ReflowInput& aReflowInput,
+ nsReflowStatus& aStatus) {
+ MarkInReflow();
+ DO_GLOBAL_REFLOW_COUNT("nsFrame");
+ MOZ_ASSERT(aStatus.IsEmpty(), "Caller should pass a fresh reflow status!");
+ aDesiredSize.ClearSize();
+}
+
+bool nsIFrame::IsContentDisabled() const {
+ // FIXME(emilio): Doing this via CSS means callers must ensure the style is up
+ // to date, and they don't!
+ if (StyleUI()->UserInput() == StyleUserInput::None) {
+ return true;
+ }
+
+ auto* element = nsGenericHTMLElement::FromNodeOrNull(GetContent());
+ return element && element->IsDisabled();
+}
+
+bool nsIFrame::IsContentRelevant() const {
+ MOZ_ASSERT(StyleDisplay()->ContentVisibility(*this) ==
+ StyleContentVisibility::Auto);
+
+ auto* element = Element::FromNodeOrNull(GetContent());
+ MOZ_ASSERT(element);
+
+ Maybe<ContentRelevancy> relevancy = element->GetContentRelevancy();
+ return relevancy.isSome() && !relevancy->isEmpty();
+}
+
+bool nsIFrame::HidesContent(
+ const EnumSet<IncludeContentVisibility>& aInclude) const {
+ auto effectiveContentVisibility = StyleDisplay()->ContentVisibility(*this);
+ if (aInclude.contains(IncludeContentVisibility::Hidden) &&
+ effectiveContentVisibility == StyleContentVisibility::Hidden) {
+ return true;
+ }
+
+ if (aInclude.contains(IncludeContentVisibility::Auto) &&
+ effectiveContentVisibility == StyleContentVisibility::Auto) {
+ return !IsContentRelevant();
+ }
+
+ return false;
+}
+
+bool nsIFrame::HidesContentForLayout() const {
+ return HidesContent() && !PresShell()->IsForcingLayoutForHiddenContent(this);
+}
+
+bool nsIFrame::IsHiddenByContentVisibilityOfInFlowParentForLayout() const {
+ const auto* parent = GetInFlowParent();
+ // The anonymous children owned by parent are important for properly sizing
+ // their parents.
+ return parent && parent->HidesContentForLayout() &&
+ !(parent->HasAnyStateBits(NS_FRAME_OWNS_ANON_BOXES) &&
+ Style()->IsAnonBox());
+}
+
+nsIFrame* nsIFrame::GetClosestContentVisibilityAncestor(
+ const EnumSet<IncludeContentVisibility>& aInclude) const {
+ if (!StaticPrefs::layout_css_content_visibility_enabled()) {
+ return nullptr;
+ }
+
+ auto* parent = GetInFlowParent();
+ bool isAnonymousBlock = Style()->IsAnonBox() && parent &&
+ parent->HasAnyStateBits(NS_FRAME_OWNS_ANON_BOXES);
+ for (nsIFrame* cur = parent; cur; cur = cur->GetInFlowParent()) {
+ if (!isAnonymousBlock && cur->HidesContent(aInclude)) {
+ return cur;
+ }
+
+ // Anonymous boxes are not hidden by the content-visibility of their first
+ // non-anonymous ancestor, but can be hidden by ancestors further up the
+ // tree.
+ isAnonymousBlock = false;
+ }
+
+ return nullptr;
+}
+
+bool nsIFrame::IsHiddenByContentVisibilityOnAnyAncestor(
+ const EnumSet<IncludeContentVisibility>& aInclude) const {
+ return !!GetClosestContentVisibilityAncestor(aInclude);
+}
+
+bool nsIFrame::HasSelectionInSubtree() {
+ if (IsSelected()) {
+ return true;
+ }
+
+ RefPtr<nsFrameSelection> frameSelection = GetFrameSelection();
+ if (!frameSelection) {
+ return false;
+ }
+
+ const Selection* selection =
+ frameSelection->GetSelection(SelectionType::eNormal);
+ if (!selection) {
+ return false;
+ }
+
+ for (uint32_t i = 0; i < selection->RangeCount(); i++) {
+ auto* range = selection->GetRangeAt(i);
+ MOZ_ASSERT(range);
+
+ const auto* commonAncestorNode =
+ range->GetRegisteredClosestCommonInclusiveAncestor();
+ if (commonAncestorNode &&
+ commonAncestorNode->IsInclusiveDescendantOf(GetContent())) {
+ return true;
+ }
+ }
+
+ return false;
+}
+
+bool nsIFrame::UpdateIsRelevantContent(
+ const ContentRelevancy& aRelevancyToUpdate) {
+ MOZ_ASSERT(StyleDisplay()->ContentVisibility(*this) ==
+ StyleContentVisibility::Auto);
+
+ auto* element = Element::FromNodeOrNull(GetContent());
+ MOZ_ASSERT(element);
+
+ ContentRelevancy newRelevancy;
+ Maybe<ContentRelevancy> oldRelevancy = element->GetContentRelevancy();
+ if (oldRelevancy.isSome()) {
+ newRelevancy = *oldRelevancy;
+ }
+
+ auto setRelevancyValue = [&](ContentRelevancyReason reason, bool value) {
+ if (value) {
+ newRelevancy += reason;
+ } else {
+ newRelevancy -= reason;
+ }
+ };
+
+ if (!oldRelevancy ||
+ aRelevancyToUpdate.contains(ContentRelevancyReason::Visible)) {
+ Maybe<bool> visible = element->GetVisibleForContentVisibility();
+ if (visible.isSome()) {
+ setRelevancyValue(ContentRelevancyReason::Visible, *visible);
+ }
+ }
+
+ if (!oldRelevancy ||
+ aRelevancyToUpdate.contains(ContentRelevancyReason::FocusInSubtree)) {
+ setRelevancyValue(ContentRelevancyReason::FocusInSubtree,
+ element->State().HasAtLeastOneOfStates(
+ ElementState::FOCUS_WITHIN | ElementState::FOCUS));
+ }
+
+ if (!oldRelevancy ||
+ aRelevancyToUpdate.contains(ContentRelevancyReason::Selected)) {
+ setRelevancyValue(ContentRelevancyReason::Selected,
+ HasSelectionInSubtree());
+ }
+
+ // If the proximity to the viewport has not been determined yet,
+ // and neither the element nor its contents are focused or selected,
+ // we should wait for the determination of the proximity. Otherwise,
+ // there might be a redundant contentvisibilityautostatechange event.
+ // See https://github.com/w3c/csswg-drafts/issues/9803
+ bool isProximityToViewportDetermined =
+ oldRelevancy ? true : element->GetVisibleForContentVisibility().isSome();
+ if (!isProximityToViewportDetermined && newRelevancy.isEmpty()) {
+ return false;
+ }
+
+ bool overallRelevancyChanged =
+ !oldRelevancy || oldRelevancy->isEmpty() != newRelevancy.isEmpty();
+ if (!oldRelevancy || *oldRelevancy != newRelevancy) {
+ element->SetContentRelevancy(newRelevancy);
+ }
+
+ if (!overallRelevancyChanged) {
+ return false;
+ }
+
+ HandleLastRememberedSize();
+ PresContext()->SetNeedsToUpdateHiddenByContentVisibilityForAnimations();
+ PresShell()->FrameNeedsReflow(
+ this, IntrinsicDirty::FrameAncestorsAndDescendants, NS_FRAME_IS_DIRTY);
+ InvalidateFrame();
+
+ ContentVisibilityAutoStateChangeEventInit init;
+ init.mSkipped = newRelevancy.isEmpty();
+ RefPtr<ContentVisibilityAutoStateChangeEvent> event =
+ ContentVisibilityAutoStateChangeEvent::Constructor(
+ element, u"contentvisibilityautostatechange"_ns, init);
+
+ // Per
+ // https://drafts.csswg.org/css-contain/#content-visibility-auto-state-changed
+ // "This event is dispatched by posting a task at the time when the state
+ // change occurs."
+ RefPtr<AsyncEventDispatcher> asyncDispatcher =
+ new AsyncEventDispatcher(element, event.forget());
+ DebugOnly<nsresult> rv = asyncDispatcher->PostDOMEvent();
+ NS_ASSERTION(NS_SUCCEEDED(rv), "AsyncEventDispatcher failed to dispatch");
+ return true;
+}
+
+nsresult nsIFrame::CharacterDataChanged(const CharacterDataChangeInfo&) {
+ MOZ_ASSERT_UNREACHABLE("should only be called for text frames");
+ return NS_OK;
+}
+
+nsresult nsIFrame::AttributeChanged(int32_t aNameSpaceID, nsAtom* aAttribute,
+ int32_t aModType) {
+ return NS_OK;
+}
+
+// Flow member functions
+
+nsIFrame* nsIFrame::GetPrevContinuation() const { return nullptr; }
+
+void nsIFrame::SetPrevContinuation(nsIFrame* aPrevContinuation) {
+ MOZ_ASSERT(false, "not splittable");
+}
+
+nsIFrame* nsIFrame::GetNextContinuation() const { return nullptr; }
+
+void nsIFrame::SetNextContinuation(nsIFrame*) {
+ MOZ_ASSERT(false, "not splittable");
+}
+
+nsIFrame* nsIFrame::GetPrevInFlow() const { return nullptr; }
+
+void nsIFrame::SetPrevInFlow(nsIFrame* aPrevInFlow) {
+ MOZ_ASSERT(false, "not splittable");
+}
+
+nsIFrame* nsIFrame::GetNextInFlow() const { return nullptr; }
+
+void nsIFrame::SetNextInFlow(nsIFrame*) { MOZ_ASSERT(false, "not splittable"); }
+
+nsIFrame* nsIFrame::GetTailContinuation() {
+ nsIFrame* frame = this;
+ while (frame->HasAnyStateBits(NS_FRAME_IS_OVERFLOW_CONTAINER)) {
+ frame = frame->GetPrevContinuation();
+ NS_ASSERTION(frame, "first continuation can't be overflow container");
+ }
+ for (nsIFrame* next = frame->GetNextContinuation();
+ next && !next->HasAnyStateBits(NS_FRAME_IS_OVERFLOW_CONTAINER);
+ next = frame->GetNextContinuation()) {
+ frame = next;
+ }
+
+ MOZ_ASSERT(frame, "illegal state in continuation chain.");
+ return frame;
+}
+
+// Associated view object
+void nsIFrame::SetView(nsView* aView) {
+ if (aView) {
+ aView->SetFrame(this);
+
+#ifdef DEBUG
+ LayoutFrameType frameType = Type();
+ NS_ASSERTION(frameType == LayoutFrameType::SubDocument ||
+ frameType == LayoutFrameType::ListControl ||
+ frameType == LayoutFrameType::Viewport ||
+ frameType == LayoutFrameType::MenuPopup,
+ "Only specific frame types can have an nsView");
+#endif
+
+ // Store the view on the frame.
+ SetViewInternal(aView);
+
+ // Set the frame state bit that says the frame has a view
+ AddStateBits(NS_FRAME_HAS_VIEW);
+
+ // Let all of the ancestors know they have a descendant with a view.
+ for (nsIFrame* f = GetParent();
+ f && !f->HasAnyStateBits(NS_FRAME_HAS_CHILD_WITH_VIEW);
+ f = f->GetParent())
+ f->AddStateBits(NS_FRAME_HAS_CHILD_WITH_VIEW);
+ } else {
+ MOZ_ASSERT_UNREACHABLE("Destroying a view while the frame is alive?");
+ RemoveStateBits(NS_FRAME_HAS_VIEW);
+ SetViewInternal(nullptr);
+ }
+}
+
+// Find the first geometric parent that has a view
+nsIFrame* nsIFrame::GetAncestorWithView() const {
+ for (nsIFrame* f = GetParent(); nullptr != f; f = f->GetParent()) {
+ if (f->HasView()) {
+ return f;
+ }
+ }
+ return nullptr;
+}
+
+template <nsPoint (nsIFrame::*PositionGetter)() const>
+static nsPoint OffsetCalculator(const nsIFrame* aThis, const nsIFrame* aOther) {
+ MOZ_ASSERT(aOther, "Must have frame for destination coordinate system!");
+
+ NS_ASSERTION(aThis->PresContext() == aOther->PresContext(),
+ "GetOffsetTo called on frames in different documents");
+
+ nsPoint offset(0, 0);
+ const nsIFrame* f;
+ for (f = aThis; f != aOther && f; f = f->GetParent()) {
+ offset += (f->*PositionGetter)();
+ }
+
+ if (f != aOther) {
+ // Looks like aOther wasn't an ancestor of |this|. So now we have
+ // the root-frame-relative position of |this| in |offset|. Convert back
+ // to the coordinates of aOther
+ while (aOther) {
+ offset -= (aOther->*PositionGetter)();
+ aOther = aOther->GetParent();
+ }
+ }
+
+ return offset;
+}
+
+nsPoint nsIFrame::GetOffsetTo(const nsIFrame* aOther) const {
+ return OffsetCalculator<&nsIFrame::GetPosition>(this, aOther);
+}
+
+nsPoint nsIFrame::GetOffsetToIgnoringScrolling(const nsIFrame* aOther) const {
+ return OffsetCalculator<&nsIFrame::GetPositionIgnoringScrolling>(this,
+ aOther);
+}
+
+nsPoint nsIFrame::GetOffsetToCrossDoc(const nsIFrame* aOther) const {
+ return GetOffsetToCrossDoc(aOther, PresContext()->AppUnitsPerDevPixel());
+}
+
+nsPoint nsIFrame::GetOffsetToCrossDoc(const nsIFrame* aOther,
+ const int32_t aAPD) const {
+ MOZ_ASSERT(aOther, "Must have frame for destination coordinate system!");
+ NS_ASSERTION(PresContext()->GetRootPresContext() ==
+ aOther->PresContext()->GetRootPresContext(),
+ "trying to get the offset between frames in different document "
+ "hierarchies?");
+ if (PresContext()->GetRootPresContext() !=
+ aOther->PresContext()->GetRootPresContext()) {
+ // crash right away, we are almost certainly going to crash anyway.
+ MOZ_CRASH(
+ "trying to get the offset between frames in different "
+ "document hierarchies?");
+ }
+
+ const nsIFrame* root = nullptr;
+ // offset will hold the final offset
+ // docOffset holds the currently accumulated offset at the current APD, it
+ // will be converted and added to offset when the current APD changes.
+ nsPoint offset(0, 0), docOffset(0, 0);
+ const nsIFrame* f = this;
+ int32_t currAPD = PresContext()->AppUnitsPerDevPixel();
+ while (f && f != aOther) {
+ docOffset += f->GetPosition();
+ nsIFrame* parent = f->GetParent();
+ if (parent) {
+ f = parent;
+ } else {
+ nsPoint newOffset(0, 0);
+ root = f;
+ f = nsLayoutUtils::GetCrossDocParentFrameInProcess(f, &newOffset);
+ int32_t newAPD = f ? f->PresContext()->AppUnitsPerDevPixel() : 0;
+ if (!f || newAPD != currAPD) {
+ // Convert docOffset to the right APD and add it to offset.
+ offset += docOffset.ScaleToOtherAppUnits(currAPD, aAPD);
+ docOffset.x = docOffset.y = 0;
+ }
+ currAPD = newAPD;
+ docOffset += newOffset;
+ }
+ }
+ if (f == aOther) {
+ offset += docOffset.ScaleToOtherAppUnits(currAPD, aAPD);
+ } else {
+ // Looks like aOther wasn't an ancestor of |this|. So now we have
+ // the root-document-relative position of |this| in |offset|. Subtract the
+ // root-document-relative position of |aOther| from |offset|.
+ // This call won't try to recurse again because root is an ancestor of
+ // aOther.
+ nsPoint negOffset = aOther->GetOffsetToCrossDoc(root, aAPD);
+ offset -= negOffset;
+ }
+
+ return offset;
+}
+
+CSSIntRect nsIFrame::GetScreenRect() const {
+ return CSSIntRect::FromAppUnitsToNearest(GetScreenRectInAppUnits());
+}
+
+nsRect nsIFrame::GetScreenRectInAppUnits() const {
+ nsPresContext* presContext = PresContext();
+ nsIFrame* rootFrame = presContext->PresShell()->GetRootFrame();
+ nsPoint rootScreenPos(0, 0);
+ nsPoint rootFrameOffsetInParent(0, 0);
+ nsIFrame* rootFrameParent = nsLayoutUtils::GetCrossDocParentFrameInProcess(
+ rootFrame, &rootFrameOffsetInParent);
+ if (rootFrameParent) {
+ nsRect parentScreenRectAppUnits =
+ rootFrameParent->GetScreenRectInAppUnits();
+ nsPresContext* parentPresContext = rootFrameParent->PresContext();
+ double parentScale = double(presContext->AppUnitsPerDevPixel()) /
+ parentPresContext->AppUnitsPerDevPixel();
+ nsPoint rootPt =
+ parentScreenRectAppUnits.TopLeft() + rootFrameOffsetInParent;
+ rootScreenPos.x = NS_round(parentScale * rootPt.x);
+ rootScreenPos.y = NS_round(parentScale * rootPt.y);
+ } else {
+ nsCOMPtr<nsIWidget> rootWidget =
+ presContext->PresShell()->GetViewManager()->GetRootWidget();
+ if (rootWidget) {
+ LayoutDeviceIntPoint rootDevPx = rootWidget->WidgetToScreenOffset();
+ rootScreenPos.x = presContext->DevPixelsToAppUnits(rootDevPx.x);
+ rootScreenPos.y = presContext->DevPixelsToAppUnits(rootDevPx.y);
+ }
+ }
+
+ return nsRect(rootScreenPos + GetOffsetTo(rootFrame), GetSize());
+}
+
+// Returns the offset from this frame to the closest geometric parent that
+// has a view. Also returns the containing view or null in case of error
+void nsIFrame::GetOffsetFromView(nsPoint& aOffset, nsView** aView) const {
+ MOZ_ASSERT(nullptr != aView, "null OUT parameter pointer");
+ nsIFrame* frame = const_cast<nsIFrame*>(this);
+
+ *aView = nullptr;
+ aOffset.MoveTo(0, 0);
+ do {
+ aOffset += frame->GetPosition();
+ frame = frame->GetParent();
+ } while (frame && !frame->HasView());
+
+ if (frame) {
+ *aView = frame->GetView();
+ }
+}
+
+nsIWidget* nsIFrame::GetNearestWidget() const {
+ return GetClosestView()->GetNearestWidget(nullptr);
+}
+
+nsIWidget* nsIFrame::GetNearestWidget(nsPoint& aOffset) const {
+ nsPoint offsetToView;
+ nsPoint offsetToWidget;
+ nsIWidget* widget =
+ GetClosestView(&offsetToView)->GetNearestWidget(&offsetToWidget);
+ aOffset = offsetToView + offsetToWidget;
+ return widget;
+}
+
+Matrix4x4Flagged nsIFrame::GetTransformMatrix(ViewportType aViewportType,
+ RelativeTo aStopAtAncestor,
+ nsIFrame** aOutAncestor,
+ uint32_t aFlags) const {
+ MOZ_ASSERT(aOutAncestor, "Need a place to put the ancestor!");
+
+ /* If we're transformed, we want to hand back the combination
+ * transform/translate matrix that will apply our current transform, then
+ * shift us to our parent.
+ */
+ const bool isTransformed = IsTransformed();
+ const nsIFrame* zoomedContentRoot = nullptr;
+ if (aStopAtAncestor.mViewportType == ViewportType::Visual) {
+ zoomedContentRoot = ViewportUtils::IsZoomedContentRoot(this);
+ if (zoomedContentRoot) {
+ MOZ_ASSERT(aViewportType != ViewportType::Visual);
+ }
+ }
+
+ if (isTransformed || zoomedContentRoot) {
+ Matrix4x4 result;
+ int32_t scaleFactor =
+ ((aFlags & IN_CSS_UNITS) ? AppUnitsPerCSSPixel()
+ : PresContext()->AppUnitsPerDevPixel());
+
+ /* Compute the delta to the parent, which we need because we are converting
+ * coordinates to our parent.
+ */
+ if (isTransformed) {
+ NS_ASSERTION(nsLayoutUtils::GetCrossDocParentFrameInProcess(this),
+ "Cannot transform the viewport frame!");
+
+ result = result * nsDisplayTransform::GetResultingTransformMatrix(
+ this, nsPoint(0, 0), scaleFactor,
+ nsDisplayTransform::INCLUDE_PERSPECTIVE |
+ nsDisplayTransform::OFFSET_BY_ORIGIN);
+ }
+
+ // The offset from a zoomed content root to its parent (e.g. from
+ // a canvas frame to a scroll frame) is in layout coordinates, so
+ // apply it before applying any layout-to-visual transform.
+ *aOutAncestor = nsLayoutUtils::GetCrossDocParentFrameInProcess(this);
+ nsPoint delta = GetOffsetToCrossDoc(*aOutAncestor);
+ /* Combine the raw transform with a translation to our parent. */
+ result.PostTranslate(NSAppUnitsToFloatPixels(delta.x, scaleFactor),
+ NSAppUnitsToFloatPixels(delta.y, scaleFactor), 0.0f);
+
+ if (zoomedContentRoot) {
+ Matrix4x4 layoutToVisual;
+ ScrollableLayerGuid::ViewID targetScrollId =
+ nsLayoutUtils::FindOrCreateIDFor(zoomedContentRoot->GetContent());
+ if (aFlags & nsIFrame::IN_CSS_UNITS) {
+ layoutToVisual =
+ ViewportUtils::GetVisualToLayoutTransform(targetScrollId)
+ .Inverse()
+ .ToUnknownMatrix();
+ } else {
+ layoutToVisual =
+ ViewportUtils::GetVisualToLayoutTransform<LayoutDevicePixel>(
+ targetScrollId)
+ .Inverse()
+ .ToUnknownMatrix();
+ }
+ result = result * layoutToVisual;
+ }
+
+ return result;
+ }
+
+ *aOutAncestor = nsLayoutUtils::GetCrossDocParentFrameInProcess(this);
+
+ /* Otherwise, we're not transformed. In that case, we'll walk up the frame
+ * tree until we either hit the root frame or something that may be
+ * transformed. We'll then change coordinates into that frame, since we're
+ * guaranteed that nothing in-between can be transformed. First, however,
+ * we have to check to see if we have a parent. If not, we'll set the
+ * outparam to null (indicating that there's nothing left) and will hand back
+ * the identity matrix.
+ */
+ if (!*aOutAncestor) return Matrix4x4();
+
+ /* Keep iterating while the frame can't possibly be transformed. */
+ const nsIFrame* current = this;
+ auto shouldStopAt = [](const nsIFrame* aCurrent, nsIFrame* aAncestor,
+ uint32_t aFlags) {
+ return aAncestor->IsTransformed() || nsLayoutUtils::IsPopup(aAncestor) ||
+ ViewportUtils::IsZoomedContentRoot(aAncestor) ||
+ ((aFlags & STOP_AT_STACKING_CONTEXT_AND_DISPLAY_PORT) &&
+ (aAncestor->IsStackingContext() ||
+ DisplayPortUtils::FrameHasDisplayPort(aAncestor, aCurrent)));
+ };
+ while (*aOutAncestor != aStopAtAncestor.mFrame &&
+ !shouldStopAt(current, *aOutAncestor, aFlags)) {
+ /* If no parent, stop iterating. Otherwise, update the ancestor. */
+ nsIFrame* parent =
+ nsLayoutUtils::GetCrossDocParentFrameInProcess(*aOutAncestor);
+ if (!parent) break;
+
+ current = *aOutAncestor;
+ *aOutAncestor = parent;
+ }
+
+ NS_ASSERTION(*aOutAncestor, "Somehow ended up with a null ancestor...?");
+
+ /* Translate from this frame to our ancestor, if it exists. That's the
+ * entire transform, so we're done.
+ */
+ nsPoint delta = GetOffsetToCrossDoc(*aOutAncestor);
+ int32_t scaleFactor =
+ ((aFlags & IN_CSS_UNITS) ? AppUnitsPerCSSPixel()
+ : PresContext()->AppUnitsPerDevPixel());
+ return Matrix4x4::Translation(NSAppUnitsToFloatPixels(delta.x, scaleFactor),
+ NSAppUnitsToFloatPixels(delta.y, scaleFactor),
+ 0.0f);
+}
+
+static void InvalidateRenderingObservers(nsIFrame* aDisplayRoot,
+ nsIFrame* aFrame,
+ bool aFrameChanged = true) {
+ MOZ_ASSERT(aDisplayRoot == nsLayoutUtils::GetDisplayRootFrame(aFrame));
+ SVGObserverUtils::InvalidateDirectRenderingObservers(aFrame);
+ nsIFrame* parent = aFrame;
+ while (parent != aDisplayRoot &&
+ (parent = nsLayoutUtils::GetCrossDocParentFrameInProcess(parent)) &&
+ !parent->HasAnyStateBits(NS_FRAME_DESCENDANT_NEEDS_PAINT)) {
+ SVGObserverUtils::InvalidateDirectRenderingObservers(parent);
+ }
+
+ if (!aFrameChanged) {
+ return;
+ }
+
+ aFrame->MarkNeedsDisplayItemRebuild();
+}
+
+static void SchedulePaintInternal(
+ nsIFrame* aDisplayRoot, nsIFrame* aFrame,
+ nsIFrame::PaintType aType = nsIFrame::PAINT_DEFAULT) {
+ MOZ_ASSERT(aDisplayRoot == nsLayoutUtils::GetDisplayRootFrame(aFrame));
+ nsPresContext* pres = aDisplayRoot->PresContext()->GetRootPresContext();
+
+ // No need to schedule a paint for an external document since they aren't
+ // painted directly.
+ if (!pres || (pres->Document() && pres->Document()->IsResourceDoc())) {
+ return;
+ }
+ if (!pres->GetContainerWeak()) {
+ NS_WARNING("Shouldn't call SchedulePaint in a detached pres context");
+ return;
+ }
+
+ pres->PresShell()->ScheduleViewManagerFlush();
+
+ if (aType == nsIFrame::PAINT_DEFAULT) {
+ aDisplayRoot->AddStateBits(NS_FRAME_UPDATE_LAYER_TREE);
+ }
+}
+
+static void InvalidateFrameInternal(nsIFrame* aFrame, bool aHasDisplayItem,
+ bool aRebuildDisplayItems) {
+ if (aHasDisplayItem) {
+ aFrame->AddStateBits(NS_FRAME_NEEDS_PAINT);
+ }
+
+ if (aRebuildDisplayItems) {
+ aFrame->MarkNeedsDisplayItemRebuild();
+ }
+ SVGObserverUtils::InvalidateDirectRenderingObservers(aFrame);
+ bool needsSchedulePaint = false;
+ if (nsLayoutUtils::IsPopup(aFrame)) {
+ needsSchedulePaint = true;
+ } else {
+ nsIFrame* parent = nsLayoutUtils::GetCrossDocParentFrameInProcess(aFrame);
+ while (parent &&
+ !parent->HasAnyStateBits(NS_FRAME_DESCENDANT_NEEDS_PAINT)) {
+ if (aHasDisplayItem && !parent->HasAnyStateBits(NS_FRAME_IS_NONDISPLAY)) {
+ parent->AddStateBits(NS_FRAME_DESCENDANT_NEEDS_PAINT);
+ }
+ SVGObserverUtils::InvalidateDirectRenderingObservers(parent);
+
+ // If we're inside a popup, then we need to make sure that we
+ // call schedule paint so that the NS_FRAME_UPDATE_LAYER_TREE
+ // flag gets added to the popup display root frame.
+ if (nsLayoutUtils::IsPopup(parent)) {
+ needsSchedulePaint = true;
+ break;
+ }
+ parent = nsLayoutUtils::GetCrossDocParentFrameInProcess(parent);
+ }
+ if (!parent) {
+ needsSchedulePaint = true;
+ }
+ }
+ if (!aHasDisplayItem) {
+ return;
+ }
+ if (needsSchedulePaint) {
+ nsIFrame* displayRoot = nsLayoutUtils::GetDisplayRootFrame(aFrame);
+ SchedulePaintInternal(displayRoot, aFrame);
+ }
+ if (aFrame->HasAnyStateBits(NS_FRAME_HAS_INVALID_RECT)) {
+ aFrame->RemoveProperty(nsIFrame::InvalidationRect());
+ aFrame->RemoveStateBits(NS_FRAME_HAS_INVALID_RECT);
+ }
+}
+
+void nsIFrame::InvalidateFrameSubtree(bool aRebuildDisplayItems /* = true */) {
+ InvalidateFrame(0, aRebuildDisplayItems);
+
+ if (HasAnyStateBits(NS_FRAME_ALL_DESCENDANTS_NEED_PAINT)) {
+ return;
+ }
+
+ AddStateBits(NS_FRAME_ALL_DESCENDANTS_NEED_PAINT);
+
+ for (const auto& childList : CrossDocChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ // Don't explicitly rebuild display items for our descendants,
+ // since we should be marked and it implicitly includes all
+ // descendants.
+ child->InvalidateFrameSubtree(false);
+ }
+ }
+}
+
+void nsIFrame::ClearInvalidationStateBits() {
+ if (HasAnyStateBits(NS_FRAME_DESCENDANT_NEEDS_PAINT)) {
+ for (const auto& childList : CrossDocChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ child->ClearInvalidationStateBits();
+ }
+ }
+ }
+
+ RemoveStateBits(NS_FRAME_NEEDS_PAINT | NS_FRAME_DESCENDANT_NEEDS_PAINT |
+ NS_FRAME_ALL_DESCENDANTS_NEED_PAINT);
+}
+
+bool HasRetainedDataFor(const nsIFrame* aFrame, uint32_t aDisplayItemKey) {
+ if (RefPtr<WebRenderUserData> data =
+ GetWebRenderUserData<WebRenderFallbackData>(aFrame,
+ aDisplayItemKey)) {
+ return true;
+ }
+
+ return false;
+}
+
+void nsIFrame::InvalidateFrame(uint32_t aDisplayItemKey,
+ bool aRebuildDisplayItems /* = true */) {
+ bool hasDisplayItem =
+ !aDisplayItemKey || HasRetainedDataFor(this, aDisplayItemKey);
+ InvalidateFrameInternal(this, hasDisplayItem, aRebuildDisplayItems);
+}
+
+void nsIFrame::InvalidateFrameWithRect(const nsRect& aRect,
+ uint32_t aDisplayItemKey,
+ bool aRebuildDisplayItems /* = true */) {
+ if (aRect.IsEmpty()) {
+ return;
+ }
+ bool hasDisplayItem =
+ !aDisplayItemKey || HasRetainedDataFor(this, aDisplayItemKey);
+ bool alreadyInvalid = false;
+ if (!HasAnyStateBits(NS_FRAME_NEEDS_PAINT)) {
+ InvalidateFrameInternal(this, hasDisplayItem, aRebuildDisplayItems);
+ } else {
+ alreadyInvalid = true;
+ }
+
+ if (!hasDisplayItem) {
+ return;
+ }
+
+ nsRect* rect;
+ if (HasAnyStateBits(NS_FRAME_HAS_INVALID_RECT)) {
+ rect = GetProperty(InvalidationRect());
+ MOZ_ASSERT(rect);
+ } else {
+ if (alreadyInvalid) {
+ return;
+ }
+ rect = new nsRect();
+ AddProperty(InvalidationRect(), rect);
+ AddStateBits(NS_FRAME_HAS_INVALID_RECT);
+ }
+
+ *rect = rect->Union(aRect);
+}
+
+/*static*/
+uint8_t nsIFrame::sLayerIsPrerenderedDataKey;
+
+bool nsIFrame::IsInvalid(nsRect& aRect) {
+ if (!HasAnyStateBits(NS_FRAME_NEEDS_PAINT)) {
+ return false;
+ }
+
+ if (HasAnyStateBits(NS_FRAME_HAS_INVALID_RECT)) {
+ nsRect* rect = GetProperty(InvalidationRect());
+ NS_ASSERTION(
+ rect, "Must have an invalid rect if NS_FRAME_HAS_INVALID_RECT is set!");
+ aRect = *rect;
+ } else {
+ aRect.SetEmpty();
+ }
+ return true;
+}
+
+void nsIFrame::SchedulePaint(PaintType aType, bool aFrameChanged) {
+ if (PresShell()->IsPaintingSuppressed()) {
+ // We can't have any display items yet, and when we unsuppress we will
+ // invalidate the root frame.
+ return;
+ }
+ nsIFrame* displayRoot = nsLayoutUtils::GetDisplayRootFrame(this);
+ InvalidateRenderingObservers(displayRoot, this, aFrameChanged);
+ SchedulePaintInternal(displayRoot, this, aType);
+}
+
+void nsIFrame::SchedulePaintWithoutInvalidatingObservers(PaintType aType) {
+ nsIFrame* displayRoot = nsLayoutUtils::GetDisplayRootFrame(this);
+ SchedulePaintInternal(displayRoot, this, aType);
+}
+
+void nsIFrame::InvalidateLayer(DisplayItemType aDisplayItemKey,
+ const nsIntRect* aDamageRect,
+ const nsRect* aFrameDamageRect,
+ uint32_t aFlags /* = 0 */) {
+ NS_ASSERTION(aDisplayItemKey > DisplayItemType::TYPE_ZERO, "Need a key");
+
+ nsIFrame* displayRoot = nsLayoutUtils::GetDisplayRootFrame(this);
+ InvalidateRenderingObservers(displayRoot, this, false);
+
+ // Check if frame supports WebRender's async update
+ if ((aFlags & UPDATE_IS_ASYNC) &&
+ WebRenderUserData::SupportsAsyncUpdate(this)) {
+ // WebRender does not use layer, then return nullptr.
+ return;
+ }
+
+ if (aFrameDamageRect && aFrameDamageRect->IsEmpty()) {
+ return;
+ }
+
+ // In the bug 930056, dialer app startup but not shown on the
+ // screen because sometimes we don't have any retainned data
+ // for remote type displayitem and thus Repaint event is not
+ // triggered. So, always invalidate in this case.
+ DisplayItemType displayItemKey = aDisplayItemKey;
+ if (aDisplayItemKey == DisplayItemType::TYPE_REMOTE) {
+ displayItemKey = DisplayItemType::TYPE_ZERO;
+ }
+
+ if (aFrameDamageRect) {
+ InvalidateFrameWithRect(*aFrameDamageRect,
+ static_cast<uint32_t>(displayItemKey));
+ } else {
+ InvalidateFrame(static_cast<uint32_t>(displayItemKey));
+ }
+}
+
+static nsRect ComputeEffectsRect(nsIFrame* aFrame, const nsRect& aOverflowRect,
+ const nsSize& aNewSize) {
+ nsRect r = aOverflowRect;
+
+ if (aFrame->HasAnyStateBits(NS_FRAME_SVG_LAYOUT)) {
+ // For SVG frames, we only need to account for filters.
+ // TODO: We could also take account of clipPath and mask to reduce the
+ // ink overflow, but that's not essential.
+ if (aFrame->StyleEffects()->HasFilters()) {
+ SetOrUpdateRectValuedProperty(aFrame, nsIFrame::PreEffectsBBoxProperty(),
+ r);
+ r = SVGUtils::GetPostFilterInkOverflowRect(aFrame, aOverflowRect);
+ }
+ return r;
+ }
+
+ // box-shadow
+ r.UnionRect(r, nsLayoutUtils::GetBoxShadowRectForFrame(aFrame, aNewSize));
+
+ // border-image-outset.
+ // We need to include border-image-outset because it can cause the
+ // border image to be drawn beyond the border box.
+
+ // (1) It's important we not check whether there's a border-image
+ // since the style hint for a change in border image doesn't cause
+ // reflow, and that's probably more important than optimizing the
+ // overflow areas for the silly case of border-image-outset without
+ // border-image
+ // (2) It's important that we not check whether the border-image
+ // is actually loaded, since that would require us to reflow when
+ // the image loads.
+ const nsStyleBorder* styleBorder = aFrame->StyleBorder();
+ nsMargin outsetMargin = styleBorder->GetImageOutset();
+
+ if (outsetMargin != nsMargin(0, 0, 0, 0)) {
+ nsRect outsetRect(nsPoint(0, 0), aNewSize);
+ outsetRect.Inflate(outsetMargin);
+ r.UnionRect(r, outsetRect);
+ }
+
+ // Note that we don't remove the outlineInnerRect if a frame loses outline
+ // style. That would require an extra property lookup for every frame,
+ // or a new frame state bit to track whether a property had been stored,
+ // or something like that. It's not worth doing that here. At most it's
+ // only one heap-allocated rect per frame and it will be cleaned up when
+ // the frame dies.
+
+ if (SVGIntegrationUtils::UsingOverflowAffectingEffects(aFrame)) {
+ SetOrUpdateRectValuedProperty(aFrame, nsIFrame::PreEffectsBBoxProperty(),
+ r);
+ r = SVGIntegrationUtils::ComputePostEffectsInkOverflowRect(aFrame, r);
+ }
+
+ return r;
+}
+
+void nsIFrame::SetPosition(const nsPoint& aPt) {
+ if (mRect.TopLeft() == aPt) {
+ return;
+ }
+ mRect.MoveTo(aPt);
+ MarkNeedsDisplayItemRebuild();
+}
+
+void nsIFrame::MovePositionBy(const nsPoint& aTranslation) {
+ nsPoint position = GetNormalPosition() + aTranslation;
+
+ const nsMargin* computedOffsets = nullptr;
+ if (IsRelativelyOrStickyPositioned()) {
+ computedOffsets = GetProperty(nsIFrame::ComputedOffsetProperty());
+ }
+ ReflowInput::ApplyRelativePositioning(
+ this, computedOffsets ? *computedOffsets : nsMargin(), &position);
+ SetPosition(position);
+}
+
+nsRect nsIFrame::GetNormalRect() const {
+ // It might be faster to first check
+ // StyleDisplay()->IsRelativelyPositionedStyle().
+ bool hasProperty;
+ nsPoint normalPosition = GetProperty(NormalPositionProperty(), &hasProperty);
+ if (hasProperty) {
+ return nsRect(normalPosition, GetSize());
+ }
+ return GetRect();
+}
+
+nsRect nsIFrame::GetBoundingClientRect() {
+ return nsLayoutUtils::GetAllInFlowRectsUnion(
+ this, nsLayoutUtils::GetContainingBlockForClientRect(this),
+ nsLayoutUtils::RECTS_ACCOUNT_FOR_TRANSFORMS);
+}
+
+nsPoint nsIFrame::GetPositionIgnoringScrolling() const {
+ return GetParent() ? GetParent()->GetPositionOfChildIgnoringScrolling(this)
+ : GetPosition();
+}
+
+nsRect nsIFrame::GetOverflowRect(OverflowType aType) const {
+ // Note that in some cases the overflow area might not have been
+ // updated (yet) to reflect any outline set on the frame or the area
+ // of child frames. That's OK because any reflow that updates these
+ // areas will invalidate the appropriate area, so any (mis)uses of
+ // this method will be fixed up.
+
+ if (mOverflow.mType == OverflowStorageType::Large) {
+ // there is an overflow rect, and it's not stored as deltas but as
+ // a separately-allocated rect
+ return GetOverflowAreasProperty()->Overflow(aType);
+ }
+
+ if (aType == OverflowType::Ink &&
+ mOverflow.mType != OverflowStorageType::None) {
+ return InkOverflowFromDeltas();
+ }
+
+ return GetRectRelativeToSelf();
+}
+
+OverflowAreas nsIFrame::GetOverflowAreas() const {
+ if (mOverflow.mType == OverflowStorageType::Large) {
+ // there is an overflow rect, and it's not stored as deltas but as
+ // a separately-allocated rect
+ return *GetOverflowAreasProperty();
+ }
+
+ return OverflowAreas(InkOverflowFromDeltas(),
+ nsRect(nsPoint(0, 0), GetSize()));
+}
+
+OverflowAreas nsIFrame::GetOverflowAreasRelativeToSelf() const {
+ if (IsTransformed()) {
+ if (OverflowAreas* preTransformOverflows =
+ GetProperty(PreTransformOverflowAreasProperty())) {
+ return *preTransformOverflows;
+ }
+ }
+ return GetOverflowAreas();
+}
+
+OverflowAreas nsIFrame::GetOverflowAreasRelativeToParent() const {
+ return GetOverflowAreas() + GetPosition();
+}
+
+OverflowAreas nsIFrame::GetActualAndNormalOverflowAreasRelativeToParent()
+ const {
+ if (MOZ_LIKELY(!IsRelativelyOrStickyPositioned())) {
+ return GetOverflowAreasRelativeToParent();
+ }
+
+ const OverflowAreas overflows = GetOverflowAreas();
+ OverflowAreas actualAndNormalOverflows = overflows + GetPosition();
+ actualAndNormalOverflows.UnionWith(overflows + GetNormalPosition());
+ return actualAndNormalOverflows;
+}
+
+nsRect nsIFrame::ScrollableOverflowRectRelativeToParent() const {
+ return ScrollableOverflowRect() + GetPosition();
+}
+
+nsRect nsIFrame::InkOverflowRectRelativeToParent() const {
+ return InkOverflowRect() + GetPosition();
+}
+
+nsRect nsIFrame::ScrollableOverflowRectRelativeToSelf() const {
+ if (IsTransformed()) {
+ if (OverflowAreas* preTransformOverflows =
+ GetProperty(PreTransformOverflowAreasProperty())) {
+ return preTransformOverflows->ScrollableOverflow();
+ }
+ }
+ return ScrollableOverflowRect();
+}
+
+nsRect nsIFrame::InkOverflowRectRelativeToSelf() const {
+ if (IsTransformed()) {
+ if (OverflowAreas* preTransformOverflows =
+ GetProperty(PreTransformOverflowAreasProperty())) {
+ return preTransformOverflows->InkOverflow();
+ }
+ }
+ return InkOverflowRect();
+}
+
+nsRect nsIFrame::PreEffectsInkOverflowRect() const {
+ nsRect* r = GetProperty(nsIFrame::PreEffectsBBoxProperty());
+ return r ? *r : InkOverflowRectRelativeToSelf();
+}
+
+bool nsIFrame::UpdateOverflow() {
+ MOZ_ASSERT(FrameMaintainsOverflow(),
+ "Non-display SVG do not maintain ink overflow rects");
+
+ nsRect rect(nsPoint(0, 0), GetSize());
+ OverflowAreas overflowAreas(rect, rect);
+
+ if (!ComputeCustomOverflow(overflowAreas)) {
+ // If updating overflow wasn't supported by this frame, then it should
+ // have scheduled any necessary reflows. We can return false to say nothing
+ // changed, and wait for reflow to correct it.
+ return false;
+ }
+
+ UnionChildOverflow(overflowAreas);
+
+ if (FinishAndStoreOverflow(overflowAreas, GetSize())) {
+ if (nsView* view = GetView()) {
+ // Make sure the frame's view is properly sized.
+ nsViewManager* vm = view->GetViewManager();
+ vm->ResizeView(view, overflowAreas.InkOverflow(), true);
+ }
+
+ return true;
+ }
+
+ // Frames that combine their 3d transform with their ancestors
+ // only compute a pre-transform overflow rect, and then contribute
+ // to the normal overflow rect of the preserve-3d root. Always return
+ // true here so that we propagate changes up to the root for final
+ // calculation.
+ return Combines3DTransformWithAncestors();
+}
+
+/* virtual */
+bool nsIFrame::ComputeCustomOverflow(OverflowAreas& aOverflowAreas) {
+ return true;
+}
+
+bool nsIFrame::DoesClipChildrenInBothAxes() const {
+ if (IsScrollContainer()) {
+ return true;
+ }
+ const nsStyleDisplay* display = StyleDisplay();
+ if (display->IsContainPaint() && SupportsContainLayoutAndPaint()) {
+ return true;
+ }
+ return display->mOverflowX == StyleOverflow::Clip &&
+ display->mOverflowY == StyleOverflow::Clip;
+}
+
+/* virtual */
+void nsIFrame::UnionChildOverflow(OverflowAreas& aOverflowAreas) {
+ if (!DoesClipChildrenInBothAxes()) {
+ nsLayoutUtils::UnionChildOverflow(this, aOverflowAreas);
+ }
+}
+
+// Return true if this form control element's preferred size property (but not
+// percentage max size property) contains a percentage value that should be
+// resolved against zero when calculating its min-content contribution in the
+// corresponding axis.
+//
+// For proper replaced elements, the percentage value in both their max size
+// property or preferred size property should be resolved against zero. This is
+// handled in IsPercentageResolvedAgainstZero().
+inline static bool FormControlShrinksForPercentSize(const nsIFrame* aFrame) {
+ if (!aFrame->IsReplaced()) {
+ // Quick test to reject most frames.
+ return false;
+ }
+
+ LayoutFrameType fType = aFrame->Type();
+ if (fType == LayoutFrameType::Meter || fType == LayoutFrameType::Progress ||
+ fType == LayoutFrameType::Range) {
+ // progress, meter and range do have this shrinking behavior
+ // FIXME: Maybe these should be nsIFormControlFrame?
+ return true;
+ }
+
+ if (!static_cast<nsIFormControlFrame*>(do_QueryFrame(aFrame))) {
+ // Not a form control. This includes fieldsets, which do not
+ // shrink.
+ return false;
+ }
+
+ if (fType == LayoutFrameType::GfxButtonControl ||
+ fType == LayoutFrameType::HTMLButtonControl) {
+ // Buttons don't have this shrinking behavior. (Note that color
+ // inputs do, even though they inherit from button, so we can't use
+ // do_QueryFrame here.)
+ return false;
+ }
+
+ return true;
+}
+
+bool nsIFrame::IsPercentageResolvedAgainstZero(
+ const StyleSize& aStyleSize, const StyleMaxSize& aStyleMaxSize) const {
+ const bool sizeHasPercent = aStyleSize.HasPercent();
+ return ((sizeHasPercent || aStyleMaxSize.HasPercent()) &&
+ HasReplacedSizing()) ||
+ (sizeHasPercent && FormControlShrinksForPercentSize(this));
+}
+
+// Summary of the Cyclic-Percentage Intrinsic Size Contribution Rules:
+//
+// Element Type | Replaced | Non-replaced
+// Contribution Type | min-content max-content | min-content max-content
+// ---------------------------------------------------------------------------
+// min size | zero zero | zero zero
+// max & preferred size | zero initial | initial initial
+//
+// https://drafts.csswg.org/css-sizing-3/#cyclic-percentage-contribution
+bool nsIFrame::IsPercentageResolvedAgainstZero(const LengthPercentage& aSize,
+ SizeProperty aProperty) const {
+ // Early return to avoid calling the virtual function, IsFrameOfType().
+ if (aProperty == SizeProperty::MinSize) {
+ return true;
+ }
+
+ const bool hasPercentOnReplaced = aSize.HasPercent() && HasReplacedSizing();
+ if (aProperty == SizeProperty::MaxSize) {
+ return hasPercentOnReplaced;
+ }
+
+ MOZ_ASSERT(aProperty == SizeProperty::Size);
+ return hasPercentOnReplaced ||
+ (aSize.HasPercent() && FormControlShrinksForPercentSize(this));
+}
+
+bool nsIFrame::IsBlockWrapper() const {
+ auto pseudoType = Style()->GetPseudoType();
+ return pseudoType == PseudoStyleType::mozBlockInsideInlineWrapper ||
+ pseudoType == PseudoStyleType::buttonContent ||
+ pseudoType == PseudoStyleType::cellContent ||
+ pseudoType == PseudoStyleType::columnSpanWrapper;
+}
+
+bool nsIFrame::IsBlockFrameOrSubclass() const {
+ const nsBlockFrame* thisAsBlock = do_QueryFrame(this);
+ return !!thisAsBlock;
+}
+
+bool nsIFrame::IsImageFrameOrSubclass() const {
+ const nsImageFrame* asImage = do_QueryFrame(this);
+ return !!asImage;
+}
+
+bool nsIFrame::IsSubgrid() const {
+ return IsGridContainerFrame() &&
+ static_cast<const nsGridContainerFrame*>(this)->IsSubgrid();
+}
+
+static nsIFrame* GetNearestBlockContainer(nsIFrame* frame) {
+ while (!frame->IsBlockContainer()) {
+ frame = frame->GetParent();
+ NS_ASSERTION(
+ frame,
+ "How come we got to the root frame without seeing a containing block?");
+ }
+ return frame;
+}
+
+bool nsIFrame::IsBlockContainer() const {
+ // The block wrappers we use to wrap blocks inside inlines aren't
+ // described in the CSS spec. We need to make them not be containing
+ // blocks.
+ // Since the parent of such a block is either a normal block or
+ // another such pseudo, this shouldn't cause anything bad to happen.
+ // Also the anonymous blocks inside table cells are not containing blocks.
+ //
+ // If we ever start skipping table row groups from being containing blocks,
+ // you need to remove the StickyScrollContainer hack referencing bug 1421660.
+ return !IsLineParticipant() && !IsBlockWrapper() && !IsSubgrid() &&
+ // Table rows are not containing blocks either
+ !IsTableRowFrame();
+}
+
+nsIFrame* nsIFrame::GetContainingBlock(
+ uint32_t aFlags, const nsStyleDisplay* aStyleDisplay) const {
+ MOZ_ASSERT(aStyleDisplay == StyleDisplay());
+
+ // Keep this in sync with MightBeContainingBlockFor in ReflowInput.cpp.
+
+ if (!GetParent()) {
+ return nullptr;
+ }
+ // MathML frames might have absolute positioning style, but they would
+ // still be in-flow. So we have to check to make sure that the frame
+ // is really out-of-flow too.
+ nsIFrame* f;
+ if (IsAbsolutelyPositioned(aStyleDisplay)) {
+ f = GetParent(); // the parent is always the containing block
+ } else {
+ f = GetNearestBlockContainer(GetParent());
+ }
+
+ if (aFlags & SKIP_SCROLLED_FRAME && f &&
+ f->Style()->GetPseudoType() == PseudoStyleType::scrolledContent) {
+ f = f->GetParent();
+ }
+ return f;
+}
+
+#ifdef DEBUG_FRAME_DUMP
+
+Maybe<uint32_t> nsIFrame::ContentIndexInContainer(const nsIFrame* aFrame) {
+ if (nsIContent* content = aFrame->GetContent()) {
+ return content->ComputeIndexInParentContent();
+ }
+ return Nothing();
+}
+
+nsAutoCString nsIFrame::ListTag() const {
+ nsAutoString tmp;
+ GetFrameName(tmp);
+
+ nsAutoCString tag;
+ tag += NS_ConvertUTF16toUTF8(tmp);
+ tag += nsPrintfCString("@%p", static_cast<const void*>(this));
+ return tag;
+}
+
+std::string nsIFrame::ConvertToString(const LogicalRect& aRect,
+ const WritingMode aWM, ListFlags aFlags) {
+ if (aFlags.contains(ListFlag::DisplayInCSSPixels)) {
+ // Abuse CSSRect to store all LogicalRect's dimensions in CSS pixels.
+ return ToString(mozilla::CSSRect(CSSPixel::FromAppUnits(aRect.IStart(aWM)),
+ CSSPixel::FromAppUnits(aRect.BStart(aWM)),
+ CSSPixel::FromAppUnits(aRect.ISize(aWM)),
+ CSSPixel::FromAppUnits(aRect.BSize(aWM))));
+ }
+ return ToString(aRect);
+}
+
+std::string nsIFrame::ConvertToString(const LogicalSize& aSize,
+ const WritingMode aWM, ListFlags aFlags) {
+ if (aFlags.contains(ListFlag::DisplayInCSSPixels)) {
+ // Abuse CSSSize to store all LogicalSize's dimensions in CSS pixels.
+ return ToString(CSSSize(CSSPixel::FromAppUnits(aSize.ISize(aWM)),
+ CSSPixel::FromAppUnits(aSize.BSize(aWM))));
+ }
+ return ToString(aSize);
+}
+
+// Debugging
+void nsIFrame::ListGeneric(nsACString& aTo, const char* aPrefix,
+ ListFlags aFlags) const {
+ aTo += aPrefix;
+ aTo += ListTag();
+ if (HasView()) {
+ aTo += nsPrintfCString(" [view=%p]", static_cast<void*>(GetView()));
+ }
+ if (GetParent()) {
+ aTo += nsPrintfCString(" parent=%p", static_cast<void*>(GetParent()));
+ }
+ if (GetNextSibling()) {
+ aTo += nsPrintfCString(" next=%p", static_cast<void*>(GetNextSibling()));
+ }
+ if (GetPrevContinuation()) {
+ bool fluid = GetPrevInFlow() == GetPrevContinuation();
+ aTo += nsPrintfCString(" prev-%s=%p", fluid ? "in-flow" : "continuation",
+ static_cast<void*>(GetPrevContinuation()));
+ }
+ if (GetNextContinuation()) {
+ bool fluid = GetNextInFlow() == GetNextContinuation();
+ aTo += nsPrintfCString(" next-%s=%p", fluid ? "in-flow" : "continuation",
+ static_cast<void*>(GetNextContinuation()));
+ }
+ if (const nsAtom* const autoPageValue =
+ GetProperty(AutoPageValueProperty())) {
+ aTo += " AutoPage=";
+ aTo += nsAtomCString(autoPageValue);
+ }
+ if (const nsIFrame::PageValues* const pageValues =
+ GetProperty(PageValuesProperty())) {
+ aTo += " PageValues={";
+ if (pageValues->mStartPageValue) {
+ aTo += nsAtomCString(pageValues->mStartPageValue);
+ } else {
+ aTo += "<null>";
+ }
+ aTo += ", ";
+ if (pageValues->mEndPageValue) {
+ aTo += nsAtomCString(pageValues->mEndPageValue);
+ } else {
+ aTo += "<null>";
+ }
+ aTo += "}";
+ }
+ void* IBsibling = GetProperty(IBSplitSibling());
+ if (IBsibling) {
+ aTo += nsPrintfCString(" IBSplitSibling=%p", IBsibling);
+ }
+ void* IBprevsibling = GetProperty(IBSplitPrevSibling());
+ if (IBprevsibling) {
+ aTo += nsPrintfCString(" IBSplitPrevSibling=%p", IBprevsibling);
+ }
+ if (nsLayoutUtils::FontSizeInflationEnabled(PresContext())) {
+ if (HasAnyStateBits(NS_FRAME_FONT_INFLATION_FLOW_ROOT)) {
+ aTo += nsPrintfCString(" FFR");
+ if (nsFontInflationData* data =
+ nsFontInflationData::FindFontInflationDataFor(this)) {
+ aTo += nsPrintfCString(
+ ",enabled=%s,UIS=%s", data->InflationEnabled() ? "yes" : "no",
+ ConvertToString(data->UsableISize(), aFlags).c_str());
+ }
+ }
+ if (HasAnyStateBits(NS_FRAME_FONT_INFLATION_CONTAINER)) {
+ aTo += nsPrintfCString(" FIC");
+ }
+ aTo += nsPrintfCString(" FI=%f", nsLayoutUtils::FontSizeInflationFor(this));
+ }
+ aTo += nsPrintfCString(" %s", ConvertToString(mRect, aFlags).c_str());
+
+ mozilla::WritingMode wm = GetWritingMode();
+ if (wm.IsVertical() || wm.IsBidiRTL()) {
+ aTo +=
+ nsPrintfCString(" wm=%s logical-size=(%s)", ToString(wm).c_str(),
+ ConvertToString(GetLogicalSize(), wm, aFlags).c_str());
+ }
+
+ nsIFrame* parent = GetParent();
+ if (parent) {
+ WritingMode pWM = parent->GetWritingMode();
+ if (pWM.IsVertical() || pWM.IsBidiRTL()) {
+ nsSize containerSize = parent->mRect.Size();
+ LogicalRect lr(pWM, mRect, containerSize);
+ aTo += nsPrintfCString(" parent-wm=%s cs=(%s) logical-rect=%s",
+ ToString(pWM).c_str(),
+ ConvertToString(containerSize, aFlags).c_str(),
+ ConvertToString(lr, pWM, aFlags).c_str());
+ }
+ }
+ nsIFrame* f = const_cast<nsIFrame*>(this);
+ if (f->HasOverflowAreas()) {
+ nsRect io = f->InkOverflowRect();
+ if (!io.IsEqualEdges(mRect)) {
+ aTo += nsPrintfCString(" ink-overflow=%s",
+ ConvertToString(io, aFlags).c_str());
+ }
+ nsRect so = f->ScrollableOverflowRect();
+ if (!so.IsEqualEdges(mRect)) {
+ aTo += nsPrintfCString(" scr-overflow=%s",
+ ConvertToString(so, aFlags).c_str());
+ }
+ }
+ if (OverflowAreas* preTransformOverflows =
+ f->GetProperty(PreTransformOverflowAreasProperty())) {
+ nsRect io = preTransformOverflows->InkOverflow();
+ if (!io.IsEqualEdges(mRect) &&
+ (!f->HasOverflowAreas() || !io.IsEqualEdges(f->InkOverflowRect()))) {
+ aTo += nsPrintfCString(" pre-transform-ink-overflow=%s",
+ ConvertToString(io, aFlags).c_str());
+ }
+ nsRect so = preTransformOverflows->ScrollableOverflow();
+ if (!so.IsEqualEdges(mRect) &&
+ (!f->HasOverflowAreas() ||
+ !so.IsEqualEdges(f->ScrollableOverflowRect()))) {
+ aTo += nsPrintfCString(" pre-transform-scr-overflow=%s",
+ ConvertToString(so, aFlags).c_str());
+ }
+ }
+ bool hasNormalPosition;
+ nsPoint normalPosition = GetNormalPosition(&hasNormalPosition);
+ if (hasNormalPosition) {
+ aTo += nsPrintfCString(" normal-position=%s",
+ ConvertToString(normalPosition, aFlags).c_str());
+ }
+ if (HasProperty(BidiDataProperty())) {
+ FrameBidiData bidi = GetBidiData();
+ aTo += nsPrintfCString(" bidi(%d,%d,%d)", bidi.baseLevel.Value(),
+ bidi.embeddingLevel.Value(),
+ bidi.precedingControl.Value());
+ }
+ if (IsTransformed()) {
+ aTo += nsPrintfCString(" transformed");
+ }
+ if (ChildrenHavePerspective()) {
+ aTo += nsPrintfCString(" perspective");
+ }
+ if (Extend3DContext()) {
+ aTo += nsPrintfCString(" extend-3d");
+ }
+ if (Combines3DTransformWithAncestors()) {
+ aTo += nsPrintfCString(" combines-3d-transform-with-ancestors");
+ }
+ if (mContent) {
+ aTo += nsPrintfCString(" [content=%p]", static_cast<void*>(mContent));
+ }
+ aTo += nsPrintfCString(" [cs=%p", static_cast<void*>(mComputedStyle));
+ if (mComputedStyle) {
+ auto pseudoType = mComputedStyle->GetPseudoType();
+ aTo += ToString(pseudoType).c_str();
+ }
+ aTo += "]";
+
+ auto contentVisibility = StyleDisplay()->ContentVisibility(*this);
+ if (contentVisibility != StyleContentVisibility::Visible) {
+ aTo += nsPrintfCString(" [content-visibility=");
+ if (contentVisibility == StyleContentVisibility::Auto) {
+ aTo += "auto, "_ns;
+ } else if (contentVisibility == StyleContentVisibility::Hidden) {
+ aTo += "hiden, "_ns;
+ }
+
+ if (HidesContent()) {
+ aTo += "HidesContent=hidden"_ns;
+ } else {
+ aTo += "HidesContent=visibile"_ns;
+ }
+ aTo += "]";
+ }
+
+ if (IsFrameModified()) {
+ aTo += nsPrintfCString(" modified");
+ }
+
+ if (HasModifiedDescendants()) {
+ aTo += nsPrintfCString(" has-modified-descendants");
+ }
+}
+
+void nsIFrame::List(FILE* out, const char* aPrefix, ListFlags aFlags) const {
+ nsCString str;
+ ListGeneric(str, aPrefix, aFlags);
+ fprintf_stderr(out, "%s\n", str.get());
+}
+
+void nsIFrame::ListTextRuns(FILE* out) const {
+ nsTHashSet<const void*> seen;
+ ListTextRuns(out, seen);
+}
+
+void nsIFrame::ListTextRuns(FILE* out, nsTHashSet<const void*>& aSeen) const {
+ for (const auto& childList : ChildLists()) {
+ for (const nsIFrame* kid : childList.mList) {
+ kid->ListTextRuns(out, aSeen);
+ }
+ }
+}
+
+void nsIFrame::ListMatchedRules(FILE* out, const char* aPrefix) const {
+ nsTArray<const StyleLockedStyleRule*> rawRuleList;
+ Servo_ComputedValues_GetStyleRuleList(mComputedStyle, &rawRuleList);
+ for (const StyleLockedStyleRule* rawRule : rawRuleList) {
+ nsAutoCString ruleText;
+ Servo_StyleRule_GetCssText(rawRule, &ruleText);
+ fprintf_stderr(out, "%s%s\n", aPrefix, ruleText.get());
+ }
+}
+
+void nsIFrame::ListWithMatchedRules(FILE* out, const char* aPrefix) const {
+ fprintf_stderr(out, "%s%s\n", aPrefix, ListTag().get());
+
+ nsCString rulePrefix;
+ rulePrefix += aPrefix;
+ rulePrefix += " ";
+ ListMatchedRules(out, rulePrefix.get());
+}
+
+nsresult nsIFrame::GetFrameName(nsAString& aResult) const {
+ return MakeFrameName(u"Frame"_ns, aResult);
+}
+
+nsresult nsIFrame::MakeFrameName(const nsAString& aType,
+ nsAString& aResult) const {
+ aResult = aType;
+ if (mContent && !mContent->IsText()) {
+ nsAutoString buf;
+ mContent->NodeInfo()->NameAtom()->ToString(buf);
+ if (nsAtom* id = mContent->GetID()) {
+ buf.AppendLiteral(" id=");
+ buf.Append(nsDependentAtomString(id));
+ }
+ if (IsSubDocumentFrame()) {
+ nsAutoString src;
+ mContent->AsElement()->GetAttr(nsGkAtoms::src, src);
+ buf.AppendLiteral(" src=");
+ buf.Append(src);
+ }
+ aResult.Append('(');
+ aResult.Append(buf);
+ aResult.Append(')');
+ }
+ aResult.Append('(');
+ Maybe<uint32_t> index = ContentIndexInContainer(this);
+ if (index.isSome()) {
+ aResult.AppendInt(*index);
+ } else {
+ aResult.AppendInt(-1);
+ }
+ aResult.Append(')');
+ return NS_OK;
+}
+
+void nsIFrame::DumpFrameTree() const {
+ PresShell()->GetRootFrame()->List(stderr);
+}
+
+void nsIFrame::DumpFrameTreeInCSSPixels() const {
+ PresShell()->GetRootFrame()->List(stderr, "", ListFlag::DisplayInCSSPixels);
+}
+
+void nsIFrame::DumpFrameTreeLimited() const { List(stderr); }
+void nsIFrame::DumpFrameTreeLimitedInCSSPixels() const {
+ List(stderr, "", ListFlag::DisplayInCSSPixels);
+}
+
+#endif
+
+bool nsIFrame::IsVisibleForPainting() const {
+ return StyleVisibility()->IsVisible();
+}
+
+bool nsIFrame::IsVisibleOrCollapsedForPainting() const {
+ return StyleVisibility()->IsVisibleOrCollapsed();
+}
+
+/* virtual */
+bool nsIFrame::IsEmpty() {
+ return IsHiddenByContentVisibilityOfInFlowParentForLayout();
+}
+
+bool nsIFrame::CachedIsEmpty() {
+ MOZ_ASSERT(!HasAnyStateBits(NS_FRAME_IS_DIRTY) ||
+ IsHiddenByContentVisibilityOfInFlowParentForLayout(),
+ "Must only be called on reflowed lines or those hidden by "
+ "content-visibility.");
+ return IsEmpty();
+}
+
+/* virtual */
+bool nsIFrame::IsSelfEmpty() {
+ return IsHiddenByContentVisibilityOfInFlowParentForLayout();
+}
+
+nsresult nsIFrame::GetSelectionController(nsPresContext* aPresContext,
+ nsISelectionController** aSelCon) {
+ if (!aPresContext || !aSelCon) return NS_ERROR_INVALID_ARG;
+
+ nsIFrame* frame = this;
+ while (frame && frame->HasAnyStateBits(NS_FRAME_INDEPENDENT_SELECTION)) {
+ nsITextControlFrame* tcf = do_QueryFrame(frame);
+ if (tcf) {
+ return tcf->GetOwnedSelectionController(aSelCon);
+ }
+ frame = frame->GetParent();
+ }
+
+ *aSelCon = do_AddRef(aPresContext->PresShell()).take();
+ return NS_OK;
+}
+
+already_AddRefed<nsFrameSelection> nsIFrame::GetFrameSelection() {
+ RefPtr<nsFrameSelection> fs =
+ const_cast<nsFrameSelection*>(GetConstFrameSelection());
+ return fs.forget();
+}
+
+const nsFrameSelection* nsIFrame::GetConstFrameSelection() const {
+ nsIFrame* frame = const_cast<nsIFrame*>(this);
+ while (frame && frame->HasAnyStateBits(NS_FRAME_INDEPENDENT_SELECTION)) {
+ nsITextControlFrame* tcf = do_QueryFrame(frame);
+ if (tcf) {
+ return tcf->GetOwnedFrameSelection();
+ }
+ frame = frame->GetParent();
+ }
+
+ return PresShell()->ConstFrameSelection();
+}
+
+bool nsIFrame::IsFrameSelected() const {
+ NS_ASSERTION(!GetContent() || GetContent()->IsMaybeSelected(),
+ "use the public IsSelected() instead");
+ return GetContent()->IsSelected(0, GetContent()->GetChildCount());
+}
+
+nsresult nsIFrame::GetPointFromOffset(int32_t inOffset, nsPoint* outPoint) {
+ MOZ_ASSERT(outPoint != nullptr, "Null parameter");
+ nsRect contentRect = GetContentRectRelativeToSelf();
+ nsPoint pt = contentRect.TopLeft();
+ if (mContent) {
+ nsIContent* newContent = mContent->GetParent();
+ if (newContent) {
+ const int32_t newOffset = newContent->ComputeIndexOf_Deprecated(mContent);
+
+ // Find the direction of the frame from the EmbeddingLevelProperty,
+ // which is the resolved bidi level set in
+ // nsBidiPresUtils::ResolveParagraph (odd levels = right-to-left).
+ // If the embedding level isn't set, just use the CSS direction
+ // property.
+ bool hasBidiData;
+ FrameBidiData bidiData = GetProperty(BidiDataProperty(), &hasBidiData);
+ bool isRTL = hasBidiData
+ ? bidiData.embeddingLevel.IsRTL()
+ : StyleVisibility()->mDirection == StyleDirection::Rtl;
+ if ((!isRTL && inOffset > newOffset) ||
+ (isRTL && inOffset <= newOffset)) {
+ pt = contentRect.TopRight();
+ }
+ }
+ }
+ *outPoint = pt;
+ return NS_OK;
+}
+
+nsresult nsIFrame::GetCharacterRectsInRange(int32_t aInOffset, int32_t aLength,
+ nsTArray<nsRect>& aOutRect) {
+ /* no text */
+ return NS_ERROR_FAILURE;
+}
+
+nsresult nsIFrame::GetChildFrameContainingOffset(int32_t inContentOffset,
+ bool inHint,
+ int32_t* outFrameContentOffset,
+ nsIFrame** outChildFrame) {
+ MOZ_ASSERT(outChildFrame && outFrameContentOffset, "Null parameter");
+ *outFrameContentOffset = (int32_t)inHint;
+ // the best frame to reflect any given offset would be a visible frame if
+ // possible i.e. we are looking for a valid frame to place the blinking caret
+ nsRect rect = GetRect();
+ if (!rect.width || !rect.height) {
+ // if we have a 0 width or height then lets look for another frame that
+ // possibly has the same content. If we have no frames in flow then just
+ // let us return 'this' frame
+ nsIFrame* nextFlow = GetNextInFlow();
+ if (nextFlow)
+ return nextFlow->GetChildFrameContainingOffset(
+ inContentOffset, inHint, outFrameContentOffset, outChildFrame);
+ }
+ *outChildFrame = this;
+ return NS_OK;
+}
+
+//
+// What I've pieced together about this routine:
+// Starting with a block frame (from which a line frame can be gotten)
+// and a line number, drill down and get the first/last selectable
+// frame on that line, depending on aPos->mDirection.
+// aOutSideLimit != 0 means ignore aLineStart, instead work from
+// the end (if > 0) or beginning (if < 0).
+//
+static nsresult GetNextPrevLineFromBlockFrame(PeekOffsetStruct* aPos,
+ nsIFrame* aBlockFrame,
+ int32_t aLineStart,
+ int8_t aOutSideLimit) {
+ MOZ_ASSERT(aPos);
+ MOZ_ASSERT(aBlockFrame);
+
+ nsPresContext* pc = aBlockFrame->PresContext();
+
+ // magic numbers: aLineStart will be -1 for end of block, 0 will be start of
+ // block.
+
+ aPos->mResultFrame = nullptr;
+ aPos->mResultContent = nullptr;
+ aPos->mAttach = aPos->mDirection == eDirNext ? CaretAssociationHint::After
+ : CaretAssociationHint::Before;
+
+ AutoAssertNoDomMutations guard;
+ nsILineIterator* it = aBlockFrame->GetLineIterator();
+ if (!it) {
+ return NS_ERROR_FAILURE;
+ }
+ int32_t searchingLine = aLineStart;
+ int32_t countLines = it->GetNumLines();
+ if (aOutSideLimit > 0) { // start at end
+ searchingLine = countLines;
+ } else if (aOutSideLimit < 0) { // start at beginning
+ searchingLine = -1; //"next" will be 0
+ } else if ((aPos->mDirection == eDirPrevious && searchingLine == 0) ||
+ (aPos->mDirection == eDirNext &&
+ searchingLine >= (countLines - 1))) {
+ // Not found.
+ return NS_ERROR_FAILURE;
+ }
+ nsIFrame* resultFrame = nullptr;
+ nsIFrame* farStoppingFrame = nullptr; // we keep searching until we find a
+ // "this" frame then we go to next line
+ nsIFrame* nearStoppingFrame = nullptr; // if we are backing up from edge,
+ // stop here
+ nsIFrame* firstFrame;
+ nsIFrame* lastFrame;
+ bool isBeforeFirstFrame, isAfterLastFrame;
+ bool found = false;
+
+ while (!found) {
+ if (aPos->mDirection == eDirPrevious)
+ searchingLine--;
+ else
+ searchingLine++;
+ if ((aPos->mDirection == eDirPrevious && searchingLine < 0) ||
+ (aPos->mDirection == eDirNext && searchingLine >= countLines)) {
+ // we need to jump to new block frame.
+ return NS_ERROR_FAILURE;
+ }
+ auto line = it->GetLine(searchingLine).unwrap();
+ if (!line.mNumFramesOnLine) {
+ continue;
+ }
+ lastFrame = firstFrame = line.mFirstFrameOnLine;
+ for (int32_t lineFrameCount = line.mNumFramesOnLine; lineFrameCount > 1;
+ lineFrameCount--) {
+ lastFrame = lastFrame->GetNextSibling();
+ if (!lastFrame) {
+ NS_ERROR("GetLine promised more frames than could be found");
+ return NS_ERROR_FAILURE;
+ }
+ }
+ nsIFrame::GetLastLeaf(&lastFrame);
+
+ if (aPos->mDirection == eDirNext) {
+ nearStoppingFrame = firstFrame;
+ farStoppingFrame = lastFrame;
+ } else {
+ nearStoppingFrame = lastFrame;
+ farStoppingFrame = firstFrame;
+ }
+ nsPoint offset;
+ nsView* view; // used for call of get offset from view
+ aBlockFrame->GetOffsetFromView(offset, &view);
+ nsPoint newDesiredPos =
+ aPos->mDesiredCaretPos -
+ offset; // get desired position into blockframe coords
+ nsresult rv = it->FindFrameAt(searchingLine, newDesiredPos, &resultFrame,
+ &isBeforeFirstFrame, &isAfterLastFrame);
+ if (NS_FAILED(rv)) {
+ continue;
+ }
+
+ if (resultFrame) {
+ // check to see if this is ANOTHER blockframe inside the other one if so
+ // then call into its lines
+ if (resultFrame->CanProvideLineIterator()) {
+ aPos->mResultFrame = resultFrame;
+ return NS_OK;
+ }
+ // resultFrame is not a block frame
+ Maybe<nsFrameIterator> frameIterator;
+ frameIterator.emplace(
+ pc, resultFrame, nsFrameIterator::Type::PostOrder,
+ false, // aVisual
+ aPos->mOptions.contains(PeekOffsetOption::StopAtScroller),
+ false, // aFollowOOFs
+ false // aSkipPopupChecks
+ );
+
+ auto FoundValidFrame = [aPos](const nsIFrame::ContentOffsets& aOffsets,
+ const nsIFrame* aFrame) {
+ if (!aOffsets.content) {
+ return false;
+ }
+ if (!aFrame->IsSelectable(nullptr)) {
+ return false;
+ }
+ if (aPos->mOptions.contains(PeekOffsetOption::ForceEditableRegion) &&
+ !aOffsets.content->IsEditable()) {
+ return false;
+ }
+ return true;
+ };
+
+ nsIFrame* storeOldResultFrame = resultFrame;
+ while (!found) {
+ nsPoint point;
+ nsRect tempRect = resultFrame->GetRect();
+ nsPoint offset;
+ nsView* view; // used for call of get offset from view
+ resultFrame->GetOffsetFromView(offset, &view);
+ if (!view) {
+ return NS_ERROR_FAILURE;
+ }
+ if (resultFrame->GetWritingMode().IsVertical()) {
+ point.y = aPos->mDesiredCaretPos.y;
+ point.x = tempRect.width + offset.x;
+ } else {
+ point.y = tempRect.height + offset.y;
+ point.x = aPos->mDesiredCaretPos.x;
+ }
+
+ if (!resultFrame->HasView()) {
+ nsView* view;
+ nsPoint offset;
+ resultFrame->GetOffsetFromView(offset, &view);
+ nsIFrame::ContentOffsets offsets =
+ resultFrame->GetContentOffsetsFromPoint(
+ point - offset, nsIFrame::IGNORE_NATIVE_ANONYMOUS_SUBTREE);
+ aPos->mResultContent = offsets.content;
+ aPos->mContentOffset = offsets.offset;
+ aPos->mAttach = offsets.associate;
+ if (FoundValidFrame(offsets, resultFrame)) {
+ found = true;
+ break;
+ }
+ }
+
+ if (aPos->mDirection == eDirPrevious &&
+ resultFrame == farStoppingFrame) {
+ break;
+ }
+ if (aPos->mDirection == eDirNext && resultFrame == nearStoppingFrame) {
+ break;
+ }
+ // always try previous on THAT line if that fails go the other way
+ resultFrame = frameIterator->Traverse(/* aForward = */ false);
+ if (!resultFrame) {
+ return NS_ERROR_FAILURE;
+ }
+ }
+
+ if (!found) {
+ resultFrame = storeOldResultFrame;
+ frameIterator.reset();
+ frameIterator.emplace(
+ pc, resultFrame, nsFrameIterator::Type::Leaf,
+ false, // aVisual
+ aPos->mOptions.contains(PeekOffsetOption::StopAtScroller),
+ false, // aFollowOOFs
+ false // aSkipPopupChecks
+ );
+ MOZ_ASSERT(frameIterator);
+ }
+ while (!found) {
+ nsPoint point = aPos->mDesiredCaretPos;
+ nsView* view;
+ nsPoint offset;
+ resultFrame->GetOffsetFromView(offset, &view);
+ nsIFrame::ContentOffsets offsets =
+ resultFrame->GetContentOffsetsFromPoint(
+ point - offset, nsIFrame::IGNORE_NATIVE_ANONYMOUS_SUBTREE);
+ aPos->mResultContent = offsets.content;
+ aPos->mContentOffset = offsets.offset;
+ aPos->mAttach = offsets.associate;
+ if (FoundValidFrame(offsets, resultFrame)) {
+ found = true;
+ aPos->mAttach = resultFrame == farStoppingFrame
+ ? CaretAssociationHint::Before
+ : CaretAssociationHint::After;
+ break;
+ }
+ if (aPos->mDirection == eDirPrevious &&
+ (resultFrame == nearStoppingFrame))
+ break;
+ if (aPos->mDirection == eDirNext && (resultFrame == farStoppingFrame))
+ break;
+ // previous didnt work now we try "next"
+ nsIFrame* tempFrame = frameIterator->Traverse(/* aForward = */ true);
+ if (!tempFrame) break;
+ resultFrame = tempFrame;
+ }
+ aPos->mResultFrame = resultFrame;
+ } else {
+ // we need to jump to new block frame.
+ aPos->mAmount = eSelectLine;
+ aPos->mStartOffset = 0;
+ aPos->mAttach = aPos->mDirection == eDirNext
+ ? CaretAssociationHint::Before
+ : CaretAssociationHint::After;
+ if (aPos->mDirection == eDirPrevious)
+ aPos->mStartOffset = -1; // start from end
+ return aBlockFrame->PeekOffset(aPos);
+ }
+ }
+ return NS_OK;
+}
+
+nsIFrame::CaretPosition nsIFrame::GetExtremeCaretPosition(bool aStart) {
+ CaretPosition result;
+
+ FrameTarget targetFrame = DrillDownToSelectionFrame(this, !aStart, 0);
+ FrameContentRange range = GetRangeForFrame(targetFrame.frame);
+ result.mResultContent = range.content;
+ result.mContentOffset = aStart ? range.start : range.end;
+ return result;
+}
+
+// If this is a preformatted text frame, see if it ends with a newline
+static nsContentAndOffset FindLineBreakInText(nsIFrame* aFrame,
+ nsDirection aDirection) {
+ nsContentAndOffset result;
+
+ if (aFrame->IsGeneratedContentFrame() ||
+ !aFrame->HasSignificantTerminalNewline()) {
+ return result;
+ }
+
+ int32_t endOffset = aFrame->GetOffsets().second;
+ result.mContent = aFrame->GetContent();
+ result.mOffset = endOffset - (aDirection == eDirPrevious ? 0 : 1);
+ return result;
+}
+
+// Find the first (or last) descendant of the given frame
+// which is either a block-level frame or a BRFrame, or some other kind of break
+// which stops the line.
+static nsContentAndOffset FindLineBreakingFrame(nsIFrame* aFrame,
+ nsDirection aDirection) {
+ nsContentAndOffset result;
+
+ if (aFrame->IsGeneratedContentFrame()) {
+ return result;
+ }
+
+ // Treat form controls as inline leaves
+ // XXX we really need a way to determine whether a frame is inline-level
+ if (static_cast<nsIFormControlFrame*>(do_QueryFrame(aFrame))) {
+ return result;
+ }
+
+ // Check the frame itself
+ // Fall through block-in-inline split frames because their mContent is
+ // the content of the inline frames they were created from. The
+ // first/last child of such frames is the real block frame we're
+ // looking for.
+ if ((aFrame->IsBlockOutside() &&
+ !aFrame->HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT)) ||
+ aFrame->IsBrFrame()) {
+ nsIContent* content = aFrame->GetContent();
+ result.mContent = content->GetParent();
+ // In some cases (bug 310589, bug 370174) we end up here with a null
+ // content. This probably shouldn't ever happen, but since it sometimes
+ // does, we want to avoid crashing here.
+ NS_ASSERTION(result.mContent, "Unexpected orphan content");
+ if (result.mContent) {
+ result.mOffset = result.mContent->ComputeIndexOf_Deprecated(content) +
+ (aDirection == eDirPrevious ? 1 : 0);
+ }
+ return result;
+ }
+
+ result = FindLineBreakInText(aFrame, aDirection);
+ if (result.mContent) {
+ return result;
+ }
+
+ // Iterate over children and call ourselves recursively
+ if (aDirection == eDirPrevious) {
+ nsIFrame* child = aFrame->PrincipalChildList().LastChild();
+ while (child && !result.mContent) {
+ result = FindLineBreakingFrame(child, aDirection);
+ child = child->GetPrevSibling();
+ }
+ } else { // eDirNext
+ nsIFrame* child = aFrame->PrincipalChildList().FirstChild();
+ while (child && !result.mContent) {
+ result = FindLineBreakingFrame(child, aDirection);
+ child = child->GetNextSibling();
+ }
+ }
+ return result;
+}
+
+nsresult nsIFrame::PeekOffsetForParagraph(PeekOffsetStruct* aPos) {
+ nsIFrame* frame = this;
+ nsContentAndOffset blockFrameOrBR;
+ blockFrameOrBR.mContent = nullptr;
+ bool reachedLimit = frame->IsBlockOutside() || IsEditingHost(frame);
+
+ auto traverse = [&aPos](nsIFrame* current) {
+ return aPos->mDirection == eDirPrevious ? current->GetPrevSibling()
+ : current->GetNextSibling();
+ };
+
+ // Go through containing frames until reaching a block frame.
+ // In each step, search the previous (or next) siblings for the closest
+ // "stop frame" (a block frame or a BRFrame).
+ // If found, set it to be the selection boundary and abort.
+ while (!reachedLimit) {
+ nsIFrame* parent = frame->GetParent();
+ // Treat a frame associated with the root content as if it were a block
+ // frame.
+ if (!frame->mContent || !frame->mContent->GetParent()) {
+ reachedLimit = true;
+ break;
+ }
+
+ if (aPos->mDirection == eDirNext) {
+ // Try to find our own line-break before looking at our siblings.
+ blockFrameOrBR = FindLineBreakInText(frame, eDirNext);
+ }
+
+ nsIFrame* sibling = traverse(frame);
+ while (sibling && !blockFrameOrBR.mContent) {
+ blockFrameOrBR = FindLineBreakingFrame(sibling, aPos->mDirection);
+ sibling = traverse(sibling);
+ }
+ if (blockFrameOrBR.mContent) {
+ aPos->mResultContent = blockFrameOrBR.mContent;
+ aPos->mContentOffset = blockFrameOrBR.mOffset;
+ break;
+ }
+ frame = parent;
+ reachedLimit = frame && (frame->IsBlockOutside() || IsEditingHost(frame));
+ }
+
+ if (reachedLimit) { // no "stop frame" found
+ aPos->mResultContent = frame->GetContent();
+ if (aPos->mDirection == eDirPrevious) {
+ aPos->mContentOffset = 0;
+ } else if (aPos->mResultContent) {
+ aPos->mContentOffset = aPos->mResultContent->GetChildCount();
+ }
+ }
+ return NS_OK;
+}
+
+// Determine movement direction relative to frame
+static bool IsMovingInFrameDirection(const nsIFrame* frame,
+ nsDirection aDirection, bool aVisual) {
+ bool isReverseDirection =
+ aVisual && nsBidiPresUtils::IsReversedDirectionFrame(frame);
+ return aDirection == (isReverseDirection ? eDirPrevious : eDirNext);
+}
+
+// Determines "are we looking for a boundary between whitespace and
+// non-whitespace (in the direction we're moving in)". It is true when moving
+// forward and looking for a beginning of a word, or when moving backwards and
+// looking for an end of a word.
+static bool ShouldWordSelectionEatSpace(const PeekOffsetStruct& aPos) {
+ if (aPos.mWordMovementType != eDefaultBehavior) {
+ // aPos->mWordMovementType possible values:
+ // eEndWord: eat the space if we're moving backwards
+ // eStartWord: eat the space if we're moving forwards
+ return (aPos.mWordMovementType == eEndWord) ==
+ (aPos.mDirection == eDirPrevious);
+ }
+ // Use the hidden preference which is based on operating system
+ // behavior. This pref only affects whether moving forward by word
+ // should go to the end of this word or start of the next word. When
+ // going backwards, the start of the word is always used, on every
+ // operating system.
+ return aPos.mDirection == eDirNext &&
+ StaticPrefs::layout_word_select_eat_space_to_next_word();
+}
+
+enum class OffsetIsAtLineEdge : bool { No, Yes };
+
+static void SetPeekResultFromFrame(PeekOffsetStruct& aPos, nsIFrame* aFrame,
+ int32_t aOffset,
+ OffsetIsAtLineEdge aAtLineEdge) {
+ FrameContentRange range = GetRangeForFrame(aFrame);
+ aPos.mResultFrame = aFrame;
+ aPos.mResultContent = range.content;
+ // Output offset is relative to content, not frame
+ aPos.mContentOffset =
+ aOffset < 0 ? range.end + aOffset + 1 : range.start + aOffset;
+ if (aAtLineEdge == OffsetIsAtLineEdge::Yes) {
+ aPos.mAttach = aPos.mContentOffset == range.start
+ ? CaretAssociationHint::After
+ : CaretAssociationHint::Before;
+ }
+}
+
+void nsIFrame::SelectablePeekReport::TransferTo(PeekOffsetStruct& aPos) const {
+ return SetPeekResultFromFrame(aPos, mFrame, mOffset, OffsetIsAtLineEdge::No);
+}
+
+nsIFrame::SelectablePeekReport::SelectablePeekReport(
+ const mozilla::GenericErrorResult<nsresult>&& aErr) {
+ MOZ_ASSERT(NS_FAILED(aErr.operator nsresult()));
+ // Return an empty report
+}
+
+nsresult nsIFrame::PeekOffsetForCharacter(PeekOffsetStruct* aPos,
+ int32_t aOffset) {
+ SelectablePeekReport current{this, aOffset};
+
+ nsIFrame::FrameSearchResult peekSearchState = CONTINUE;
+
+ while (peekSearchState != FOUND) {
+ const bool movingInFrameDirection = IsMovingInFrameDirection(
+ current.mFrame, aPos->mDirection,
+ aPos->mOptions.contains(PeekOffsetOption::Visual));
+
+ if (current.mJumpedLine) {
+ // If we jumped lines, it's as if we found a character, but we still need
+ // to eat non-renderable content on the new line.
+ peekSearchState = current.PeekOffsetNoAmount(movingInFrameDirection);
+ } else {
+ PeekOffsetCharacterOptions options;
+ options.mRespectClusters = aPos->mAmount == eSelectCluster;
+ peekSearchState =
+ current.PeekOffsetCharacter(movingInFrameDirection, options);
+ }
+
+ current.mMovedOverNonSelectableText |=
+ peekSearchState == CONTINUE_UNSELECTABLE;
+
+ if (peekSearchState != FOUND) {
+ SelectablePeekReport next = current.mFrame->GetFrameFromDirection(*aPos);
+ if (next.Failed()) {
+ return NS_ERROR_FAILURE;
+ }
+ next.mJumpedLine |= current.mJumpedLine;
+ next.mMovedOverNonSelectableText |= current.mMovedOverNonSelectableText;
+ next.mHasSelectableFrame |= current.mHasSelectableFrame;
+ current = next;
+ }
+
+ // Found frame, but because we moved over non selectable text we want
+ // the offset to be at the frame edge. Note that if we are extending the
+ // selection, this doesn't matter.
+ if (peekSearchState == FOUND && current.mMovedOverNonSelectableText &&
+ (!aPos->mOptions.contains(PeekOffsetOption::Extend) ||
+ current.mHasSelectableFrame)) {
+ auto [start, end] = current.mFrame->GetOffsets();
+ current.mOffset = aPos->mDirection == eDirNext ? 0 : end - start;
+ }
+ }
+
+ // Set outputs
+ current.TransferTo(*aPos);
+ // If we're dealing with a text frame and moving backward positions us at
+ // the end of that line, decrease the offset by one to make sure that
+ // we're placed before the linefeed character on the previous line.
+ if (current.mOffset < 0 && current.mJumpedLine &&
+ aPos->mDirection == eDirPrevious &&
+ current.mFrame->HasSignificantTerminalNewline() &&
+ !current.mIgnoredBrFrame) {
+ --aPos->mContentOffset;
+ }
+ return NS_OK;
+}
+
+nsresult nsIFrame::PeekOffsetForWord(PeekOffsetStruct* aPos, int32_t aOffset) {
+ SelectablePeekReport current{this, aOffset};
+ bool shouldStopAtHardBreak =
+ aPos->mWordMovementType == eDefaultBehavior &&
+ StaticPrefs::layout_word_select_eat_space_to_next_word();
+ bool wordSelectEatSpace = ShouldWordSelectionEatSpace(*aPos);
+
+ PeekWordState state;
+ while (true) {
+ bool movingInFrameDirection = IsMovingInFrameDirection(
+ current.mFrame, aPos->mDirection,
+ aPos->mOptions.contains(PeekOffsetOption::Visual));
+
+ FrameSearchResult searchResult = current.mFrame->PeekOffsetWord(
+ movingInFrameDirection, wordSelectEatSpace,
+ aPos->mOptions.contains(PeekOffsetOption::IsKeyboardSelect),
+ &current.mOffset, &state,
+ !aPos->mOptions.contains(PeekOffsetOption::PreserveSpaces));
+ if (searchResult == FOUND) {
+ break;
+ }
+
+ SelectablePeekReport next = [&]() {
+ PeekOffsetOptions options = aPos->mOptions;
+ if (state.mSawInlineCharacter) {
+ // If we've already found a character, we don't want to stop at
+ // placeholder frame boundary if there is in the word.
+ options += PeekOffsetOption::StopAtPlaceholder;
+ }
+ return current.mFrame->GetFrameFromDirection(aPos->mDirection, options);
+ }();
+ if (next.Failed()) {
+ // If we've crossed the line boundary, check to make sure that we
+ // have not consumed a trailing newline as whitespace if it's
+ // significant.
+ if (next.mJumpedLine && wordSelectEatSpace &&
+ current.mFrame->HasSignificantTerminalNewline() &&
+ current.mFrame->StyleText()->mWhiteSpaceCollapse !=
+ StyleWhiteSpaceCollapse::PreserveBreaks) {
+ current.mOffset -= 1;
+ }
+ break;
+ }
+
+ if ((next.mJumpedLine || next.mFoundPlaceholder) && !wordSelectEatSpace &&
+ state.mSawBeforeType) {
+ // We can't jump lines if we're looking for whitespace following
+ // non-whitespace, and we already encountered non-whitespace.
+ break;
+ }
+
+ if (shouldStopAtHardBreak && next.mJumpedHardBreak) {
+ /**
+ * Prev, always: Jump and stop right there
+ * Next, saw inline: just stop
+ * Next, no inline: Jump and consume whitespaces
+ */
+ if (aPos->mDirection == eDirPrevious) {
+ // Try moving to the previous line if exists
+ current.TransferTo(*aPos);
+ current.mFrame->PeekOffsetForCharacter(aPos, current.mOffset);
+ return NS_OK;
+ }
+ if (state.mSawInlineCharacter || current.mJumpedHardBreak) {
+ if (current.mFrame->HasSignificantTerminalNewline()) {
+ current.mOffset -= 1;
+ }
+ current.TransferTo(*aPos);
+ return NS_OK;
+ }
+ // Mark the state as whitespace and continue
+ state.Update(false, true);
+ }
+
+ if (next.mJumpedLine) {
+ state.mContext.Truncate();
+ }
+ current = next;
+ // Jumping a line is equivalent to encountering whitespace
+ // This affects only when it already met an actual character
+ if (wordSelectEatSpace && next.mJumpedLine) {
+ state.SetSawBeforeType();
+ }
+ }
+
+ // Set outputs
+ current.TransferTo(*aPos);
+ return NS_OK;
+}
+
+static nsIFrame* GetFirstSelectableDescendantWithLineIterator(
+ nsIFrame* aParentFrame, bool aForceEditableRegion) {
+ auto FoundValidFrame = [aForceEditableRegion](const nsIFrame* aFrame) {
+ if (!aFrame->IsSelectable(nullptr)) {
+ return false;
+ }
+ if (aForceEditableRegion && !aFrame->GetContent()->IsEditable()) {
+ return false;
+ }
+ return true;
+ };
+
+ for (nsIFrame* child : aParentFrame->PrincipalChildList()) {
+ // some children may not be selectable, e.g. :before / :after pseudoelements
+ // content with user-select: none, or contenteditable="false"
+ // we need to skip them
+ if (child->CanProvideLineIterator() && FoundValidFrame(child)) {
+ return child;
+ }
+ if (nsIFrame* nested = GetFirstSelectableDescendantWithLineIterator(
+ child, aForceEditableRegion)) {
+ return nested;
+ }
+ }
+ return nullptr;
+}
+
+nsresult nsIFrame::PeekOffsetForLine(PeekOffsetStruct* aPos) {
+ nsIFrame* blockFrame = this;
+ nsresult result = NS_ERROR_FAILURE;
+
+ // outer loop
+ // moving to a next block when no more blocks are available in a subtree
+ AutoAssertNoDomMutations guard;
+ while (NS_FAILED(result)) {
+ auto [newBlock, lineFrame] = blockFrame->GetContainingBlockForLine(
+ aPos->mOptions.contains(PeekOffsetOption::StopAtScroller));
+ if (!newBlock) {
+ return NS_ERROR_FAILURE;
+ }
+ blockFrame = newBlock;
+ nsILineIterator* iter = blockFrame->GetLineIterator();
+ int32_t thisLine = iter->FindLineContaining(lineFrame);
+ if (NS_WARN_IF(thisLine < 0)) {
+ return NS_ERROR_FAILURE;
+ }
+
+ int8_t edgeCase = 0; // no edge case. This should look at thisLine
+
+ // this part will find a frame or a block frame. If it's a block frame
+ // it will "drill down" to find a viable frame or it will return an
+ // error.
+ nsIFrame* lastFrame = this;
+
+ // inner loop - crawling the frames within a specific block subtree
+ while (true) {
+ result =
+ GetNextPrevLineFromBlockFrame(aPos, blockFrame, thisLine, edgeCase);
+ // we came back to same spot! keep going
+ if (NS_SUCCEEDED(result) &&
+ (!aPos->mResultFrame || aPos->mResultFrame == lastFrame)) {
+ aPos->mResultFrame = nullptr;
+ lastFrame = nullptr;
+ if (aPos->mDirection == eDirPrevious) {
+ thisLine--;
+ } else {
+ thisLine++;
+ }
+ continue;
+ }
+
+ if (NS_FAILED(result)) {
+ break;
+ }
+
+ lastFrame = aPos->mResultFrame; // set last frame
+ /* SPECIAL CHECK FOR NAVIGATION INTO TABLES
+ * when we hit a frame which doesn't have line iterator, we need to
+ * drill down and find a child with the line iterator to prevent the
+ * crawling process to prematurely finish. Note that this is only sound if
+ * we're guaranteed to not have multiple children implementing
+ * LineIterator.
+ *
+ * So far known cases are:
+ * 1) table wrapper (drill down into table row group)
+ * 2) table cell (drill down into its only anon child)
+ */
+ const bool shouldDrillIntoChildren =
+ aPos->mResultFrame->IsTableWrapperFrame() ||
+ aPos->mResultFrame->IsTableCellFrame();
+
+ if (shouldDrillIntoChildren) {
+ nsIFrame* child = GetFirstSelectableDescendantWithLineIterator(
+ aPos->mResultFrame,
+ aPos->mOptions.contains(PeekOffsetOption::ForceEditableRegion));
+ if (child) {
+ aPos->mResultFrame = child;
+ }
+ }
+
+ if (!aPos->mResultFrame->CanProvideLineIterator()) {
+ // no more selectable content at this level
+ break;
+ }
+
+ if (aPos->mResultFrame == blockFrame) {
+ // Make sure block element is not the same as the one we had before.
+ break;
+ }
+
+ // we've struck another block element with selectable content!
+ if (aPos->mDirection == eDirPrevious) {
+ edgeCase = 1; // far edge, search from end backwards
+ } else {
+ edgeCase = -1; // near edge search from beginning onwards
+ }
+ thisLine = 0; // this line means nothing now.
+ // everything else means something so keep looking "inside" the
+ // block
+ blockFrame = aPos->mResultFrame;
+ }
+ }
+ return result;
+}
+
+nsresult nsIFrame::PeekOffsetForLineEdge(PeekOffsetStruct* aPos) {
+ // Adjusted so that the caret can't get confused when content changes
+ nsIFrame* frame = AdjustFrameForSelectionStyles(this);
+ Element* editingHost = frame->GetContent()->GetEditingHost();
+
+ auto [blockFrame, lineFrame] = frame->GetContainingBlockForLine(
+ aPos->mOptions.contains(PeekOffsetOption::StopAtScroller));
+ if (!blockFrame) {
+ return NS_ERROR_FAILURE;
+ }
+ AutoAssertNoDomMutations guard;
+ nsILineIterator* it = blockFrame->GetLineIterator();
+ int32_t thisLine = it->FindLineContaining(lineFrame);
+ if (thisLine < 0) {
+ return NS_ERROR_FAILURE;
+ }
+
+ nsIFrame* baseFrame = nullptr;
+ bool endOfLine = eSelectEndLine == aPos->mAmount;
+
+ if (aPos->mOptions.contains(PeekOffsetOption::Visual) &&
+ PresContext()->BidiEnabled()) {
+ nsIFrame* firstFrame;
+ bool isReordered;
+ nsIFrame* lastFrame;
+ MOZ_TRY(
+ it->CheckLineOrder(thisLine, &isReordered, &firstFrame, &lastFrame));
+ baseFrame = endOfLine ? lastFrame : firstFrame;
+ } else {
+ auto line = it->GetLine(thisLine).unwrap();
+
+ nsIFrame* frame = line.mFirstFrameOnLine;
+ bool lastFrameWasEditable = false;
+ for (int32_t count = line.mNumFramesOnLine; count;
+ --count, frame = frame->GetNextSibling()) {
+ if (frame->IsGeneratedContentFrame()) {
+ continue;
+ }
+ // When jumping to the end of the line with the "end" key,
+ // try to skip over brFrames
+ if (endOfLine && line.mNumFramesOnLine > 1 && frame->IsBrFrame() &&
+ lastFrameWasEditable == frame->GetContent()->IsEditable()) {
+ continue;
+ }
+ lastFrameWasEditable =
+ frame->GetContent() && frame->GetContent()->IsEditable();
+ baseFrame = frame;
+ if (!endOfLine) {
+ break;
+ }
+ }
+ }
+ if (!baseFrame) {
+ return NS_ERROR_FAILURE;
+ }
+ // Make sure we are not leaving our inline editing host if exists
+ if (editingHost) {
+ if (nsIFrame* frame = editingHost->GetPrimaryFrame()) {
+ if (frame->IsInlineOutside() &&
+ !editingHost->Contains(baseFrame->GetContent())) {
+ baseFrame = frame;
+ if (endOfLine) {
+ baseFrame = baseFrame->LastContinuation();
+ }
+ }
+ }
+ }
+ FrameTarget targetFrame = DrillDownToSelectionFrame(baseFrame, endOfLine, 0);
+ SetPeekResultFromFrame(*aPos, targetFrame.frame, endOfLine ? -1 : 0,
+ OffsetIsAtLineEdge::Yes);
+ if (endOfLine && targetFrame.frame->HasSignificantTerminalNewline()) {
+ // Do not position the caret after the terminating newline if we're
+ // trying to move to the end of line (see bug 596506)
+ --aPos->mContentOffset;
+ }
+ if (!aPos->mResultContent) {
+ return NS_ERROR_FAILURE;
+ }
+ return NS_OK;
+}
+
+nsresult nsIFrame::PeekOffset(PeekOffsetStruct* aPos) {
+ MOZ_ASSERT(aPos);
+
+ if (NS_WARN_IF(HasAnyStateBits(NS_FRAME_IS_DIRTY))) {
+ // FIXME(Bug 1654362): <caption> currently can remain dirty.
+ return NS_ERROR_UNEXPECTED;
+ }
+
+ // Translate content offset to be relative to frame
+ int32_t offset = aPos->mStartOffset - GetRangeForFrame(this).start;
+
+ switch (aPos->mAmount) {
+ case eSelectCharacter:
+ case eSelectCluster:
+ return PeekOffsetForCharacter(aPos, offset);
+ case eSelectWordNoSpace:
+ // eSelectWordNoSpace means that we should not be eating any whitespace
+ // when moving to the adjacent word. This means that we should set aPos->
+ // mWordMovementType to eEndWord if we're moving forwards, and to
+ // eStartWord if we're moving backwards.
+ if (aPos->mDirection == eDirPrevious) {
+ aPos->mWordMovementType = eStartWord;
+ } else {
+ aPos->mWordMovementType = eEndWord;
+ }
+ // Intentionally fall through the eSelectWord case.
+ [[fallthrough]];
+ case eSelectWord:
+ return PeekOffsetForWord(aPos, offset);
+ case eSelectLine:
+ return PeekOffsetForLine(aPos);
+ case eSelectBeginLine:
+ case eSelectEndLine:
+ return PeekOffsetForLineEdge(aPos);
+ case eSelectParagraph:
+ return PeekOffsetForParagraph(aPos);
+ default: {
+ NS_ASSERTION(false, "Invalid amount");
+ return NS_ERROR_FAILURE;
+ }
+ }
+}
+
+nsIFrame::FrameSearchResult nsIFrame::PeekOffsetNoAmount(bool aForward,
+ int32_t* aOffset) {
+ NS_ASSERTION(aOffset && *aOffset <= 1, "aOffset out of range");
+ // Sure, we can stop right here.
+ return FOUND;
+}
+
+nsIFrame::FrameSearchResult nsIFrame::PeekOffsetCharacter(
+ bool aForward, int32_t* aOffset, PeekOffsetCharacterOptions aOptions) {
+ NS_ASSERTION(aOffset && *aOffset <= 1, "aOffset out of range");
+ int32_t startOffset = *aOffset;
+ // A negative offset means "end of frame", which in our case means offset 1.
+ if (startOffset < 0) startOffset = 1;
+ if (aForward == (startOffset == 0)) {
+ // We're before the frame and moving forward, or after it and moving
+ // backwards: skip to the other side and we're done.
+ *aOffset = 1 - startOffset;
+ return FOUND;
+ }
+ return CONTINUE;
+}
+
+nsIFrame::FrameSearchResult nsIFrame::PeekOffsetWord(
+ bool aForward, bool aWordSelectEatSpace, bool aIsKeyboardSelect,
+ int32_t* aOffset, PeekWordState* aState, bool /*aTrimSpaces*/) {
+ NS_ASSERTION(aOffset && *aOffset <= 1, "aOffset out of range");
+ int32_t startOffset = *aOffset;
+ // This isn't text, so truncate the context
+ aState->mContext.Truncate();
+ if (startOffset < 0) startOffset = 1;
+ if (aForward == (startOffset == 0)) {
+ // We're before the frame and moving forward, or after it and moving
+ // backwards. If we're looking for non-whitespace, we found it (without
+ // skipping this frame).
+ if (!aState->mAtStart) {
+ if (aState->mLastCharWasPunctuation) {
+ // We're not punctuation, so this is a punctuation boundary.
+ if (BreakWordBetweenPunctuation(aState, aForward, false, false,
+ aIsKeyboardSelect))
+ return FOUND;
+ } else {
+ // This is not a punctuation boundary.
+ if (aWordSelectEatSpace && aState->mSawBeforeType) return FOUND;
+ }
+ }
+ // Otherwise skip to the other side and note that we encountered
+ // non-whitespace.
+ *aOffset = 1 - startOffset;
+ aState->Update(false, // not punctuation
+ false // not whitespace
+ );
+ if (!aWordSelectEatSpace) aState->SetSawBeforeType();
+ }
+ return CONTINUE;
+}
+
+// static
+bool nsIFrame::BreakWordBetweenPunctuation(const PeekWordState* aState,
+ bool aForward, bool aPunctAfter,
+ bool aWhitespaceAfter,
+ bool aIsKeyboardSelect) {
+ NS_ASSERTION(aPunctAfter != aState->mLastCharWasPunctuation,
+ "Call this only at punctuation boundaries");
+ if (aState->mLastCharWasWhitespace) {
+ // We always stop between whitespace and punctuation
+ return true;
+ }
+ if (!StaticPrefs::layout_word_select_stop_at_punctuation()) {
+ // When this pref is false, we never stop at a punctuation boundary unless
+ // it's followed by whitespace (in the relevant direction).
+ return aWhitespaceAfter;
+ }
+ if (!aIsKeyboardSelect) {
+ // mouse caret movement (e.g. word selection) always stops at every
+ // punctuation boundary
+ return true;
+ }
+ bool afterPunct = aForward ? aState->mLastCharWasPunctuation : aPunctAfter;
+ if (!afterPunct) {
+ // keyboard caret movement only stops after punctuation (in content order)
+ return false;
+ }
+ // Stop only if we've seen some non-punctuation since the last whitespace;
+ // don't stop after punctuation that follows whitespace.
+ return aState->mSeenNonPunctuationSinceWhitespace;
+}
+
+std::pair<nsIFrame*, nsIFrame*> nsIFrame::GetContainingBlockForLine(
+ bool aLockScroll) const {
+ const nsIFrame* parentFrame = this;
+ const nsIFrame* frame;
+ while (parentFrame) {
+ frame = parentFrame;
+ if (frame->HasAnyStateBits(NS_FRAME_OUT_OF_FLOW)) {
+ // if we are searching for a frame that is not in flow we will not find
+ // it. we must instead look for its placeholder
+ if (frame->HasAnyStateBits(NS_FRAME_IS_OVERFLOW_CONTAINER)) {
+ // abspos continuations don't have placeholders, get the fif
+ frame = frame->FirstInFlow();
+ }
+ frame = frame->GetPlaceholderFrame();
+ if (!frame) {
+ return std::pair(nullptr, nullptr);
+ }
+ }
+ parentFrame = frame->GetParent();
+ if (parentFrame) {
+ if (aLockScroll && parentFrame->IsScrollFrame()) {
+ return std::pair(nullptr, nullptr);
+ }
+ if (parentFrame->CanProvideLineIterator()) {
+ return std::pair(const_cast<nsIFrame*>(parentFrame),
+ const_cast<nsIFrame*>(frame));
+ }
+ }
+ }
+ return std::pair(nullptr, nullptr);
+}
+
+Result<bool, nsresult> nsIFrame::IsVisuallyAtLineEdge(
+ nsILineIterator* aLineIterator, int32_t aLine, nsDirection aDirection) {
+ auto line = aLineIterator->GetLine(aLine).unwrap();
+
+ const bool lineIsRTL = aLineIterator->IsLineIteratorFlowRTL();
+
+ nsIFrame *firstFrame = nullptr, *lastFrame = nullptr;
+ bool isReordered = false;
+ MOZ_TRY(aLineIterator->CheckLineOrder(aLine, &isReordered, &firstFrame,
+ &lastFrame));
+ if (!firstFrame || !lastFrame) {
+ return true; // XXX: Why true? We check whether `this` is at the edge...
+ }
+
+ nsIFrame* leftmostFrame = lineIsRTL ? lastFrame : firstFrame;
+ nsIFrame* rightmostFrame = lineIsRTL ? firstFrame : lastFrame;
+ auto FrameIsRTL = [](nsIFrame* aFrame) {
+ return nsBidiPresUtils::FrameDirection(aFrame) ==
+ mozilla::intl::BidiDirection::RTL;
+ };
+ if (!lineIsRTL == (aDirection == eDirPrevious)) {
+ nsIFrame* maybeLeftmostFrame = leftmostFrame;
+ for ([[maybe_unused]] int32_t i : IntegerRange(line.mNumFramesOnLine)) {
+ if (maybeLeftmostFrame == this) {
+ return true;
+ }
+ // If left edge of the line starts with placeholder frames, we can ignore
+ // them and should keep checking the following frames.
+ if (!maybeLeftmostFrame->IsPlaceholderFrame()) {
+ if ((FrameIsRTL(maybeLeftmostFrame) == lineIsRTL) ==
+ (aDirection == eDirPrevious)) {
+ nsIFrame::GetFirstLeaf(&maybeLeftmostFrame);
+ } else {
+ nsIFrame::GetLastLeaf(&maybeLeftmostFrame);
+ }
+ return maybeLeftmostFrame == this;
+ }
+ maybeLeftmostFrame = nsBidiPresUtils::GetFrameToRightOf(
+ maybeLeftmostFrame, line.mFirstFrameOnLine, line.mNumFramesOnLine);
+ if (!maybeLeftmostFrame) {
+ return false;
+ }
+ }
+ return false;
+ }
+
+ nsIFrame* maybeRightmostFrame = rightmostFrame;
+ for ([[maybe_unused]] int32_t i : IntegerRange(line.mNumFramesOnLine)) {
+ if (maybeRightmostFrame == this) {
+ return true;
+ }
+ // If the line ends with placehlder frames, we can ignore them and should
+ // keep checking the preceding frames.
+ if (!maybeRightmostFrame->IsPlaceholderFrame()) {
+ if ((FrameIsRTL(maybeRightmostFrame) == lineIsRTL) ==
+ (aDirection == eDirPrevious)) {
+ nsIFrame::GetFirstLeaf(&maybeRightmostFrame);
+ } else {
+ nsIFrame::GetLastLeaf(&maybeRightmostFrame);
+ }
+ return maybeRightmostFrame == this;
+ }
+ maybeRightmostFrame = nsBidiPresUtils::GetFrameToLeftOf(
+ maybeRightmostFrame, line.mFirstFrameOnLine, line.mNumFramesOnLine);
+ if (!maybeRightmostFrame) {
+ return false;
+ }
+ }
+ return false;
+}
+
+Result<bool, nsresult> nsIFrame::IsLogicallyAtLineEdge(
+ nsILineIterator* aLineIterator, int32_t aLine, nsDirection aDirection) {
+ auto line = aLineIterator->GetLine(aLine).unwrap();
+ if (!line.mNumFramesOnLine) {
+ return false;
+ }
+ MOZ_ASSERT(line.mFirstFrameOnLine);
+
+ if (aDirection == eDirPrevious) {
+ nsIFrame* maybeFirstFrame = line.mFirstFrameOnLine;
+ for ([[maybe_unused]] int32_t i : IntegerRange(line.mNumFramesOnLine)) {
+ if (maybeFirstFrame == this) {
+ return true;
+ }
+ // If the line starts with placeholder frames, we can ignore them and
+ // should keep checking the following frames.
+ if (!maybeFirstFrame->IsPlaceholderFrame()) {
+ nsIFrame::GetFirstLeaf(&maybeFirstFrame);
+ return maybeFirstFrame == this;
+ }
+ maybeFirstFrame = maybeFirstFrame->GetNextSibling();
+ if (!maybeFirstFrame) {
+ return false;
+ }
+ }
+ return false;
+ }
+
+ // eDirNext
+ nsIFrame* maybeLastFrame = line.GetLastFrameOnLine();
+ for ([[maybe_unused]] int32_t i : IntegerRange(line.mNumFramesOnLine)) {
+ if (maybeLastFrame == this) {
+ return true;
+ }
+ // If the line ends with placehlder frames, we can ignore them and should
+ // keep checking the preceding frames.
+ if (!maybeLastFrame->IsPlaceholderFrame()) {
+ nsIFrame::GetLastLeaf(&maybeLastFrame);
+ return maybeLastFrame == this;
+ }
+ maybeLastFrame = maybeLastFrame->GetPrevSibling();
+ }
+ return false;
+}
+
+nsIFrame::SelectablePeekReport nsIFrame::GetFrameFromDirection(
+ nsDirection aDirection, const PeekOffsetOptions& aOptions) {
+ SelectablePeekReport result;
+
+ nsPresContext* presContext = PresContext();
+ const bool needsVisualTraversal =
+ aOptions.contains(PeekOffsetOption::Visual) && presContext->BidiEnabled();
+ const bool followOofs =
+ !aOptions.contains(PeekOffsetOption::StopAtPlaceholder);
+ nsFrameIterator frameIterator(
+ presContext, this, nsFrameIterator::Type::Leaf, needsVisualTraversal,
+ aOptions.contains(PeekOffsetOption::StopAtScroller), followOofs,
+ false // aSkipPopupChecks
+ );
+
+ // Find the prev/next selectable frame
+ bool selectable = false;
+ nsIFrame* traversedFrame = this;
+ AutoAssertNoDomMutations guard;
+ const nsIContent* const nativeAnonymousSubtreeContent =
+ GetClosestNativeAnonymousSubtreeRoot();
+ while (!selectable) {
+ auto [blockFrame, lineFrame] = traversedFrame->GetContainingBlockForLine(
+ aOptions.contains(PeekOffsetOption::StopAtScroller));
+ if (!blockFrame) {
+ return result;
+ }
+
+ nsILineIterator* it = blockFrame->GetLineIterator();
+ int32_t thisLine = it->FindLineContaining(lineFrame);
+ if (thisLine < 0) {
+ return result;
+ }
+
+ bool atLineEdge;
+ MOZ_TRY_VAR(
+ atLineEdge,
+ needsVisualTraversal
+ ? traversedFrame->IsVisuallyAtLineEdge(it, thisLine, aDirection)
+ : traversedFrame->IsLogicallyAtLineEdge(it, thisLine, aDirection));
+ if (atLineEdge) {
+ result.mJumpedLine = true;
+ if (!aOptions.contains(PeekOffsetOption::JumpLines)) {
+ return result; // we are done. cannot jump lines
+ }
+ int32_t lineToCheckWrap =
+ aDirection == eDirPrevious ? thisLine - 1 : thisLine;
+ if (lineToCheckWrap < 0 ||
+ !it->GetLine(lineToCheckWrap).unwrap().mIsWrapped) {
+ result.mJumpedHardBreak = true;
+ }
+ }
+
+ traversedFrame = frameIterator.Traverse(aDirection == eDirNext);
+ if (!traversedFrame) {
+ return result;
+ }
+
+ if (aOptions.contains(PeekOffsetOption::StopAtPlaceholder) &&
+ traversedFrame->IsPlaceholderFrame()) {
+ // XXX If the placeholder frame does not have meaningful content, the user
+ // may want to select as a word around the out-of-flow cotent. However,
+ // non-text frame resets context in nsIFrame::PeekOffsetWord(). Therefore,
+ // next text frame considers the new word starts from its edge. So, it's
+ // not enough to implement such behavior with adding a check here whether
+ // the real frame may change the word with its contents if it were not
+ // out-of-flow.
+ result.mFoundPlaceholder = true;
+ return result;
+ }
+
+ auto IsSelectable =
+ [aOptions, nativeAnonymousSubtreeContent](const nsIFrame* aFrame) {
+ if (!aFrame->IsSelectable(nullptr)) {
+ return false;
+ }
+ // If the new frame is in a native anonymous subtree, we should treat
+ // it as not selectable unless the frame and found frame are in same
+ // subtree.
+ if (aFrame->GetClosestNativeAnonymousSubtreeRoot() !=
+ nativeAnonymousSubtreeContent) {
+ return false;
+ }
+ return !aOptions.contains(PeekOffsetOption::ForceEditableRegion) ||
+ aFrame->GetContent()->IsEditable();
+ };
+
+ // Skip br frames, but only if we can select something before hitting the
+ // end of the line or a non-selectable region.
+ if (atLineEdge && aDirection == eDirPrevious &&
+ traversedFrame->IsBrFrame()) {
+ for (nsIFrame* current = traversedFrame->GetPrevSibling(); current;
+ current = current->GetPrevSibling()) {
+ if (!current->IsBlockOutside() && IsSelectable(current)) {
+ if (!current->IsBrFrame()) {
+ result.mIgnoredBrFrame = true;
+ }
+ break;
+ }
+ }
+ if (result.mIgnoredBrFrame) {
+ continue;
+ }
+ }
+
+ selectable = IsSelectable(traversedFrame);
+ if (!selectable) {
+ if (traversedFrame->IsSelectable(nullptr)) {
+ result.mHasSelectableFrame = true;
+ }
+ result.mMovedOverNonSelectableText = true;
+ }
+ } // while (!selectable)
+
+ result.mOffset = (aDirection == eDirNext) ? 0 : -1;
+
+ if (aOptions.contains(PeekOffsetOption::Visual) &&
+ nsBidiPresUtils::IsReversedDirectionFrame(traversedFrame)) {
+ // The new frame is reverse-direction, go to the other end
+ result.mOffset = -1 - result.mOffset;
+ }
+ result.mFrame = traversedFrame;
+ return result;
+}
+
+nsIFrame::SelectablePeekReport nsIFrame::GetFrameFromDirection(
+ const PeekOffsetStruct& aPos) {
+ return GetFrameFromDirection(aPos.mDirection, aPos.mOptions);
+}
+
+nsView* nsIFrame::GetClosestView(nsPoint* aOffset) const {
+ nsPoint offset(0, 0);
+ for (const nsIFrame* f = this; f; f = f->GetParent()) {
+ if (f->HasView()) {
+ if (aOffset) *aOffset = offset;
+ return f->GetView();
+ }
+ offset += f->GetPosition();
+ }
+
+ MOZ_ASSERT_UNREACHABLE("No view on any parent? How did that happen?");
+ return nullptr;
+}
+
+/* virtual */
+void nsIFrame::ChildIsDirty(nsIFrame* aChild) {
+ MOZ_ASSERT_UNREACHABLE(
+ "should never be called on a frame that doesn't "
+ "inherit from nsContainerFrame");
+}
+
+#ifdef ACCESSIBILITY
+a11y::AccType nsIFrame::AccessibleType() {
+ if (IsTableCaption() && !GetRect().IsEmpty()) {
+ return a11y::eHTMLCaptionType;
+ }
+ return a11y::eNoType;
+}
+#endif
+
+bool nsIFrame::ClearOverflowRects() {
+ if (mOverflow.mType == OverflowStorageType::None) {
+ return false;
+ }
+ if (mOverflow.mType == OverflowStorageType::Large) {
+ RemoveProperty(OverflowAreasProperty());
+ }
+ mOverflow.mType = OverflowStorageType::None;
+ return true;
+}
+
+bool nsIFrame::SetOverflowAreas(const OverflowAreas& aOverflowAreas) {
+ if (mOverflow.mType == OverflowStorageType::Large) {
+ OverflowAreas* overflow = GetOverflowAreasProperty();
+ bool changed = *overflow != aOverflowAreas;
+ *overflow = aOverflowAreas;
+
+ // Don't bother with converting to the deltas form if we already
+ // have a property.
+ return changed;
+ }
+
+ const nsRect& vis = aOverflowAreas.InkOverflow();
+ uint32_t l = -vis.x, // left edge: positive delta is leftwards
+ t = -vis.y, // top: positive is upwards
+ r = vis.XMost() - mRect.width, // right: positive is rightwards
+ b = vis.YMost() - mRect.height; // bottom: positive is downwards
+ if (aOverflowAreas.ScrollableOverflow().IsEqualEdges(
+ nsRect(nsPoint(0, 0), GetSize())) &&
+ l <= InkOverflowDeltas::kMax && t <= InkOverflowDeltas::kMax &&
+ r <= InkOverflowDeltas::kMax && b <= InkOverflowDeltas::kMax &&
+ // we have to check these against zero because we *never* want to
+ // set a frame as having no overflow in this function. This is
+ // because FinishAndStoreOverflow calls this function prior to
+ // SetRect based on whether the overflow areas match aNewSize.
+ // In the case where the overflow areas exactly match mRect but
+ // do not match aNewSize, we need to store overflow in a property
+ // so that our eventual SetRect/SetSize will know that it has to
+ // reset our overflow areas.
+ (l | t | r | b) != 0) {
+ InkOverflowDeltas oldDeltas = mOverflow.mInkOverflowDeltas;
+ // It's a "small" overflow area so we store the deltas for each edge
+ // directly in the frame, rather than allocating a separate rect.
+ // If they're all zero, that's fine; we're setting things to
+ // no-overflow.
+ mOverflow.mInkOverflowDeltas.mLeft = l;
+ mOverflow.mInkOverflowDeltas.mTop = t;
+ mOverflow.mInkOverflowDeltas.mRight = r;
+ mOverflow.mInkOverflowDeltas.mBottom = b;
+ // There was no scrollable overflow before, and there isn't now.
+ return oldDeltas != mOverflow.mInkOverflowDeltas;
+ } else {
+ bool changed =
+ !aOverflowAreas.ScrollableOverflow().IsEqualEdges(
+ nsRect(nsPoint(0, 0), GetSize())) ||
+ !aOverflowAreas.InkOverflow().IsEqualEdges(InkOverflowFromDeltas());
+
+ // it's a large overflow area that we need to store as a property
+ mOverflow.mType = OverflowStorageType::Large;
+ AddProperty(OverflowAreasProperty(), new OverflowAreas(aOverflowAreas));
+ return changed;
+ }
+}
+
+enum class ApplyTransform : bool { No, Yes };
+
+/**
+ * Compute the outline inner rect (so without outline-width and outline-offset)
+ * of aFrame, maybe iterating over its descendants, in aFrame's coordinate space
+ * or its post-transform coordinate space (depending on aApplyTransform).
+ */
+static nsRect ComputeOutlineInnerRect(
+ nsIFrame* aFrame, ApplyTransform aApplyTransform, bool& aOutValid,
+ const nsSize* aSizeOverride = nullptr,
+ const OverflowAreas* aOverflowOverride = nullptr) {
+ const nsRect bounds(nsPoint(0, 0),
+ aSizeOverride ? *aSizeOverride : aFrame->GetSize());
+
+ // The SVG container frames besides SVGTextFrame do not maintain
+ // an accurate mRect. It will make the outline be larger than
+ // we expect, we need to make them narrow to their children's outline.
+ // aOutValid is set to false if the returned nsRect is not valid
+ // and should not be included in the outline rectangle.
+ aOutValid = !aFrame->HasAnyStateBits(NS_FRAME_SVG_LAYOUT) ||
+ !aFrame->IsSVGContainerFrame() || aFrame->IsSVGTextFrame();
+
+ nsRect u;
+
+ if (!aFrame->FrameMaintainsOverflow()) {
+ return u;
+ }
+
+ // Start from our border-box, transformed. See comment below about
+ // transform of children.
+ bool doTransform =
+ aApplyTransform == ApplyTransform::Yes && aFrame->IsTransformed();
+ TransformReferenceBox boundsRefBox(nullptr, bounds);
+ if (doTransform) {
+ u = nsDisplayTransform::TransformRect(bounds, aFrame, boundsRefBox);
+ } else {
+ u = bounds;
+ }
+
+ if (aOutValid && !StaticPrefs::layout_outline_include_overflow()) {
+ return u;
+ }
+
+ // Only iterate through the children if the overflow areas suggest
+ // that we might need to, and if the frame doesn't clip its overflow
+ // anyway.
+ if (aOverflowOverride) {
+ if (!doTransform && bounds.IsEqualEdges(aOverflowOverride->InkOverflow()) &&
+ bounds.IsEqualEdges(aOverflowOverride->ScrollableOverflow())) {
+ return u;
+ }
+ } else {
+ if (!doTransform && bounds.IsEqualEdges(aFrame->InkOverflowRect()) &&
+ bounds.IsEqualEdges(aFrame->ScrollableOverflowRect())) {
+ return u;
+ }
+ }
+ const nsStyleDisplay* disp = aFrame->StyleDisplay();
+ LayoutFrameType fType = aFrame->Type();
+ if (fType == LayoutFrameType::Scroll ||
+ fType == LayoutFrameType::ListControl ||
+ fType == LayoutFrameType::SVGOuterSVG) {
+ return u;
+ }
+
+ auto overflowClipAxes = aFrame->ShouldApplyOverflowClipping(disp);
+ auto overflowClipMargin = aFrame->OverflowClipMargin(overflowClipAxes);
+ if (overflowClipAxes == nsIFrame::PhysicalAxes::Both &&
+ overflowClipMargin == nsSize()) {
+ return u;
+ }
+
+ const nsStyleEffects* effects = aFrame->StyleEffects();
+ Maybe<nsRect> clipPropClipRect =
+ aFrame->GetClipPropClipRect(disp, effects, bounds.Size());
+
+ // Iterate over all children except pop-up, absolutely-positioned,
+ // float, and overflow ones.
+ const FrameChildListIDs skip = {
+ FrameChildListID::Popup, FrameChildListID::Absolute,
+ FrameChildListID::Fixed, FrameChildListID::Float,
+ FrameChildListID::Overflow};
+ for (const auto& [list, listID] : aFrame->ChildLists()) {
+ if (skip.contains(listID)) {
+ continue;
+ }
+
+ for (nsIFrame* child : list) {
+ if (child->IsPlaceholderFrame()) {
+ continue;
+ }
+
+ // Note that passing ApplyTransform::Yes when
+ // child->Combines3DTransformWithAncestors() returns true is incorrect if
+ // our aApplyTransform is No... but the opposite would be as well.
+ // This is because elements within a preserve-3d scene are always
+ // transformed up to the top of the scene. This means we don't have a
+ // mechanism for getting a transform up to an intermediate point within
+ // the scene. We choose to over-transform rather than under-transform
+ // because this is consistent with other overflow areas.
+ bool validRect = true;
+ nsRect childRect =
+ ComputeOutlineInnerRect(child, ApplyTransform::Yes, validRect) +
+ child->GetPosition();
+
+ if (!validRect) {
+ continue;
+ }
+
+ if (clipPropClipRect) {
+ // Intersect with the clip before transforming.
+ childRect.IntersectRect(childRect, *clipPropClipRect);
+ }
+
+ // Note that we transform each child separately according to
+ // aFrame's transform, and then union, which gives a different
+ // (smaller) result from unioning and then transforming the
+ // union. This doesn't match the way we handle overflow areas
+ // with 2-D transforms, though it does match the way we handle
+ // overflow areas in preserve-3d 3-D scenes.
+ if (doTransform && !child->Combines3DTransformWithAncestors()) {
+ childRect =
+ nsDisplayTransform::TransformRect(childRect, aFrame, boundsRefBox);
+ }
+
+ // If a SVGContainer has a non-SVGContainer child, we assign
+ // its child's outline to this SVGContainer directly.
+ if (!aOutValid && validRect) {
+ u = childRect;
+ aOutValid = true;
+ } else {
+ u = u.UnionEdges(childRect);
+ }
+ }
+ }
+
+ if (overflowClipAxes != nsIFrame::PhysicalAxes::None) {
+ OverflowAreas::ApplyOverflowClippingOnRect(u, bounds, overflowClipAxes,
+ overflowClipMargin);
+ }
+ return u;
+}
+
+static void ComputeAndIncludeOutlineArea(nsIFrame* aFrame,
+ OverflowAreas& aOverflowAreas,
+ const nsSize& aNewSize) {
+ const nsStyleOutline* outline = aFrame->StyleOutline();
+ if (!outline->ShouldPaintOutline()) {
+ return;
+ }
+
+ // When the outline property is set on a :-moz-block-inside-inline-wrapper
+ // pseudo-element, it inherited that outline from the inline that was broken
+ // because it contained a block. In that case, we don't want a really wide
+ // outline if the block inside the inline is narrow, so union the actual
+ // contents of the anonymous blocks.
+ nsIFrame* frameForArea = aFrame;
+ do {
+ PseudoStyleType pseudoType = frameForArea->Style()->GetPseudoType();
+ if (pseudoType != PseudoStyleType::mozBlockInsideInlineWrapper) break;
+ // If we're done, we really want it and all its later siblings.
+ frameForArea = frameForArea->PrincipalChildList().FirstChild();
+ NS_ASSERTION(frameForArea, "anonymous block with no children?");
+ } while (frameForArea);
+
+ // Find the union of the border boxes of all descendants, or in
+ // the block-in-inline case, all descendants we care about.
+ //
+ // Note that the interesting perspective-related cases are taken
+ // care of by the code that handles those issues for overflow
+ // calling FinishAndStoreOverflow again, which in turn calls this
+ // function again. We still need to deal with preserve-3d a bit.
+ nsRect innerRect;
+ bool validRect = false;
+ if (frameForArea == aFrame) {
+ innerRect = ComputeOutlineInnerRect(aFrame, ApplyTransform::No, validRect,
+ &aNewSize, &aOverflowAreas);
+ } else {
+ for (; frameForArea; frameForArea = frameForArea->GetNextSibling()) {
+ nsRect r =
+ ComputeOutlineInnerRect(frameForArea, ApplyTransform::Yes, validRect);
+
+ // Adjust for offsets transforms up to aFrame's pre-transform
+ // (i.e., normal) coordinate space; see comments in
+ // UnionBorderBoxes for some of the subtlety here.
+ for (nsIFrame *f = frameForArea, *parent = f->GetParent();
+ /* see middle of loop */; f = parent, parent = f->GetParent()) {
+ r += f->GetPosition();
+ if (parent == aFrame) {
+ break;
+ }
+ if (parent->IsTransformed() && !f->Combines3DTransformWithAncestors()) {
+ TransformReferenceBox refBox(parent);
+ r = nsDisplayTransform::TransformRect(r, parent, refBox);
+ }
+ }
+
+ innerRect.UnionRect(innerRect, r);
+ }
+ }
+
+ // Keep this code in sync with nsDisplayOutline::GetInnerRect.
+ if (innerRect == aFrame->GetRectRelativeToSelf()) {
+ aFrame->RemoveProperty(nsIFrame::OutlineInnerRectProperty());
+ } else {
+ SetOrUpdateRectValuedProperty(aFrame, nsIFrame::OutlineInnerRectProperty(),
+ innerRect);
+ }
+
+ nsRect outerRect(innerRect);
+ outerRect.Inflate(outline->EffectiveOffsetFor(outerRect));
+
+ if (outline->mOutlineStyle.IsAuto()) {
+ nsPresContext* pc = aFrame->PresContext();
+
+ pc->Theme()->GetWidgetOverflow(pc->DeviceContext(), aFrame,
+ StyleAppearance::FocusOutline, &outerRect);
+ } else {
+ const nscoord width = outline->GetOutlineWidth();
+ outerRect.Inflate(width);
+ }
+
+ nsRect& vo = aOverflowAreas.InkOverflow();
+ vo = vo.UnionEdges(innerRect.Union(outerRect));
+}
+
+bool nsIFrame::FinishAndStoreOverflow(OverflowAreas& aOverflowAreas,
+ nsSize aNewSize, nsSize* aOldSize,
+ const nsStyleDisplay* aStyleDisplay) {
+ MOZ_ASSERT(FrameMaintainsOverflow(),
+ "Don't call - overflow rects not maintained on these SVG frames");
+
+ const nsStyleDisplay* disp = StyleDisplayWithOptionalParam(aStyleDisplay);
+ bool hasTransform = IsTransformed();
+
+ nsRect bounds(nsPoint(0, 0), aNewSize);
+ // Store the passed in overflow area if we are a preserve-3d frame or we have
+ // a transform, and it's not just the frame bounds.
+ if (hasTransform || Combines3DTransformWithAncestors()) {
+ if (!aOverflowAreas.InkOverflow().IsEqualEdges(bounds) ||
+ !aOverflowAreas.ScrollableOverflow().IsEqualEdges(bounds)) {
+ OverflowAreas* initial = GetProperty(nsIFrame::InitialOverflowProperty());
+ if (!initial) {
+ AddProperty(nsIFrame::InitialOverflowProperty(),
+ new OverflowAreas(aOverflowAreas));
+ } else if (initial != &aOverflowAreas) {
+ *initial = aOverflowAreas;
+ }
+ } else {
+ RemoveProperty(nsIFrame::InitialOverflowProperty());
+ }
+#ifdef DEBUG
+ SetProperty(nsIFrame::DebugInitialOverflowPropertyApplied(), true);
+#endif
+ } else {
+#ifdef DEBUG
+ RemoveProperty(nsIFrame::DebugInitialOverflowPropertyApplied());
+#endif
+ }
+
+ nsSize oldSize = mRect.Size();
+ bool sizeChanged = ((aOldSize ? *aOldSize : oldSize) != aNewSize);
+
+ // Our frame size may not have been computed and set yet, but code under
+ // functions such as ComputeEffectsRect (which we're about to call) use the
+ // values that are stored in our frame rect to compute their results. We
+ // need the results from those functions to be based on the frame size that
+ // we *will* have, so we temporarily set our frame size here before calling
+ // those functions.
+ //
+ // XXX Someone should document here why we revert the frame size before we
+ // return rather than just leaving it set.
+ //
+ // We pass false here to avoid invalidating display items for this temporary
+ // change. We sometimes reflow frames multiple times, with the final size
+ // being the same as the initial. The single call to SetSize after reflow is
+ // done will take care of invalidating display items if the size has actually
+ // changed.
+ SetSize(aNewSize, false);
+
+ const auto overflowClipAxes = ShouldApplyOverflowClipping(disp);
+
+ if (ChildrenHavePerspective(disp) && sizeChanged) {
+ RecomputePerspectiveChildrenOverflow(this);
+
+ if (overflowClipAxes != PhysicalAxes::Both) {
+ aOverflowAreas.SetAllTo(bounds);
+ DebugOnly<bool> ok = ComputeCustomOverflow(aOverflowAreas);
+
+ // ComputeCustomOverflow() should not return false, when
+ // FrameMaintainsOverflow() returns true.
+ MOZ_ASSERT(ok, "FrameMaintainsOverflow() != ComputeCustomOverflow()");
+
+ UnionChildOverflow(aOverflowAreas);
+ }
+ }
+
+ // This is now called FinishAndStoreOverflow() instead of
+ // StoreOverflow() because frame-generic ways of adding overflow
+ // can happen here, e.g. CSS2 outline and native theme.
+ // If the overflow area width or height is nscoord_MAX, then a saturating
+ // union may have encountered an overflow, so the overflow may not contain the
+ // frame border-box. Don't warn in that case.
+ // Don't warn for SVG either, since SVG doesn't need the overflow area
+ // to contain the frame bounds.
+#ifdef DEBUG
+ for (const auto otype : AllOverflowTypes()) {
+ const nsRect& r = aOverflowAreas.Overflow(otype);
+ NS_ASSERTION(aNewSize.width == 0 || aNewSize.height == 0 ||
+ r.width == nscoord_MAX || r.height == nscoord_MAX ||
+ HasAnyStateBits(NS_FRAME_SVG_LAYOUT) ||
+ r.Contains(nsRect(nsPoint(), aNewSize)),
+ "Computed overflow area must contain frame bounds");
+ }
+#endif
+
+ // Overflow area must always include the frame's top-left and bottom-right,
+ // even if the frame rect is empty (so we can scroll to those positions).
+ const bool shouldIncludeBounds = [&] {
+ if (aNewSize.width == 0 && IsInlineFrame()) {
+ // Pending a real fix for bug 426879, don't do this for inline frames with
+ // zero width.
+ return false;
+ }
+ if (HasAnyStateBits(NS_FRAME_SVG_LAYOUT)) {
+ // Do not do this for SVG either, since it will usually massively increase
+ // the area unnecessarily (except for SVG that applies clipping, since
+ // that's the pre-existing behavior, and breaks pre-rendering otherwise).
+ // FIXME(bug 1770704): This check most likely wants to be removed or check
+ // for specific frame types at least.
+ return overflowClipAxes != PhysicalAxes::None;
+ }
+ return true;
+ }();
+
+ if (shouldIncludeBounds) {
+ for (const auto otype : AllOverflowTypes()) {
+ nsRect& o = aOverflowAreas.Overflow(otype);
+ o = o.UnionEdges(bounds);
+ }
+ }
+
+ // If we clip our children, clear accumulated overflow area in the affected
+ // dimension(s). The children are actually clipped to the padding-box, but
+ // since the overflow area should include the entire border-box, just set it
+ // to the border-box size here.
+ if (overflowClipAxes != PhysicalAxes::None) {
+ aOverflowAreas.ApplyClipping(bounds, overflowClipAxes,
+ OverflowClipMargin(overflowClipAxes));
+ }
+
+ ComputeAndIncludeOutlineArea(this, aOverflowAreas, aNewSize);
+
+ // Nothing in here should affect scrollable overflow.
+ aOverflowAreas.InkOverflow() =
+ ComputeEffectsRect(this, aOverflowAreas.InkOverflow(), aNewSize);
+
+ // Absolute position clipping
+ const nsStyleEffects* effects = StyleEffects();
+ Maybe<nsRect> clipPropClipRect = GetClipPropClipRect(disp, effects, aNewSize);
+ if (clipPropClipRect) {
+ for (const auto otype : AllOverflowTypes()) {
+ nsRect& o = aOverflowAreas.Overflow(otype);
+ o.IntersectRect(o, *clipPropClipRect);
+ }
+ }
+
+ /* If we're transformed, transform the overflow rect by the current
+ * transformation. */
+ if (hasTransform) {
+ SetProperty(nsIFrame::PreTransformOverflowAreasProperty(),
+ new OverflowAreas(aOverflowAreas));
+
+ if (Combines3DTransformWithAncestors()) {
+ /* If we're a preserve-3d leaf frame, then our pre-transform overflow
+ * should be correct. Our post-transform overflow is empty though, because
+ * we only contribute to the overflow area of the preserve-3d root frame.
+ * If we're an intermediate frame then the pre-transform overflow should
+ * contain all our non-preserve-3d children, which is what we want. Again
+ * we have no post-transform overflow.
+ */
+ aOverflowAreas.SetAllTo(nsRect());
+ } else {
+ TransformReferenceBox refBox(this);
+ for (const auto otype : AllOverflowTypes()) {
+ nsRect& o = aOverflowAreas.Overflow(otype);
+ o = nsDisplayTransform::TransformRect(o, this, refBox);
+ }
+
+ /* If we're the root of the 3d context, then we want to include the
+ * overflow areas of all the participants. This won't have happened yet as
+ * the code above set their overflow area to empty. Manually collect these
+ * overflow areas now.
+ */
+ if (Extend3DContext(disp, effects)) {
+ ComputePreserve3DChildrenOverflow(aOverflowAreas);
+ }
+ }
+ } else {
+ RemoveProperty(nsIFrame::PreTransformOverflowAreasProperty());
+ }
+
+ /* Revert the size change in case some caller is depending on this. */
+ SetSize(oldSize, false);
+
+ bool anyOverflowChanged;
+ if (aOverflowAreas != OverflowAreas(bounds, bounds)) {
+ anyOverflowChanged = SetOverflowAreas(aOverflowAreas);
+ } else {
+ anyOverflowChanged = ClearOverflowRects();
+ }
+
+ if (anyOverflowChanged) {
+ SVGObserverUtils::InvalidateDirectRenderingObservers(this);
+ if (nsBlockFrame* block = do_QueryFrame(this)) {
+ // NOTE(emilio): we need to use BeforeReflow::Yes, because we want to
+ // invalidate in cases where we _used_ to have an overflow marker and no
+ // longer do.
+ if (TextOverflow::CanHaveOverflowMarkers(
+ block, TextOverflow::BeforeReflow::Yes)) {
+ DiscardDisplayItems(this, [](nsDisplayItem* aItem) {
+ return aItem->GetType() == DisplayItemType::TYPE_TEXT_OVERFLOW;
+ });
+ SchedulePaint(PAINT_DEFAULT);
+ }
+ }
+ }
+ return anyOverflowChanged;
+}
+
+void nsIFrame::RecomputePerspectiveChildrenOverflow(
+ const nsIFrame* aStartFrame) {
+ for (const auto& childList : ChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ if (!child->FrameMaintainsOverflow()) {
+ continue; // frame does not maintain overflow rects
+ }
+ if (child->HasPerspective()) {
+ OverflowAreas* overflow =
+ child->GetProperty(nsIFrame::InitialOverflowProperty());
+ nsRect bounds(nsPoint(0, 0), child->GetSize());
+ if (overflow) {
+ OverflowAreas overflowCopy = *overflow;
+ child->FinishAndStoreOverflow(overflowCopy, bounds.Size());
+ } else {
+ OverflowAreas boundsOverflow;
+ boundsOverflow.SetAllTo(bounds);
+ child->FinishAndStoreOverflow(boundsOverflow, bounds.Size());
+ }
+ } else if (child->GetContent() == aStartFrame->GetContent() ||
+ child->GetClosestFlattenedTreeAncestorPrimaryFrame() ==
+ aStartFrame) {
+ // If a frame is using perspective, then the size used to compute
+ // perspective-origin is the size of the frame belonging to its parent
+ // style. We must find any descendant frames using our size
+ // (by recursing into frames that have the same containing block)
+ // to update their overflow rects too.
+ child->RecomputePerspectiveChildrenOverflow(aStartFrame);
+ }
+ }
+ }
+}
+
+void nsIFrame::ComputePreserve3DChildrenOverflow(
+ OverflowAreas& aOverflowAreas) {
+ // Find all descendants that participate in the 3d context, and include their
+ // overflow. These descendants have an empty overflow, so won't have been
+ // included in the normal overflow calculation. Any children that don't
+ // participate have normal overflow, so will have been included already.
+
+ nsRect childVisual;
+ nsRect childScrollable;
+ for (const auto& childList : ChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ // If this child participates in the 3d context, then take the
+ // pre-transform region (which contains all descendants that aren't
+ // participating in the 3d context) and transform it into the 3d context
+ // root coordinate space.
+ if (child->Combines3DTransformWithAncestors()) {
+ OverflowAreas childOverflow = child->GetOverflowAreasRelativeToSelf();
+ TransformReferenceBox refBox(child);
+ for (const auto otype : AllOverflowTypes()) {
+ nsRect& o = childOverflow.Overflow(otype);
+ o = nsDisplayTransform::TransformRect(o, child, refBox);
+ }
+
+ aOverflowAreas.UnionWith(childOverflow);
+
+ // If this child also extends the 3d context, then recurse into it
+ // looking for more participants.
+ if (child->Extend3DContext()) {
+ child->ComputePreserve3DChildrenOverflow(aOverflowAreas);
+ }
+ }
+ }
+ }
+}
+
+bool nsIFrame::ZIndexApplies() const {
+ return StyleDisplay()->IsPositionedStyle() || IsFlexOrGridItem() ||
+ IsMenuPopupFrame();
+}
+
+Maybe<int32_t> nsIFrame::ZIndex() const {
+ if (!ZIndexApplies()) {
+ return Nothing();
+ }
+ const auto& zIndex = StylePosition()->mZIndex;
+ if (zIndex.IsAuto()) {
+ return Nothing();
+ }
+ return Some(zIndex.AsInteger());
+}
+
+bool nsIFrame::IsScrollAnchor(ScrollAnchorContainer** aOutContainer) {
+ if (!mInScrollAnchorChain) {
+ return false;
+ }
+
+ nsIFrame* f = this;
+
+ // FIXME(emilio, bug 1629280): We should find a non-null anchor if we have the
+ // flag set, but bug 1629280 makes it so that we cannot really assert it /
+ // make this just a `while (true)`, and uncomment the below assertion.
+ while (auto* container = ScrollAnchorContainer::FindFor(f)) {
+ // MOZ_ASSERT(f->IsInScrollAnchorChain());
+ if (nsIFrame* anchor = container->AnchorNode()) {
+ if (anchor != this) {
+ return false;
+ }
+ if (aOutContainer) {
+ *aOutContainer = container;
+ }
+ return true;
+ }
+
+ f = container->Frame();
+ }
+
+ return false;
+}
+
+bool nsIFrame::IsInScrollAnchorChain() const { return mInScrollAnchorChain; }
+
+void nsIFrame::SetInScrollAnchorChain(bool aInChain) {
+ mInScrollAnchorChain = aInChain;
+}
+
+uint32_t nsIFrame::GetDepthInFrameTree() const {
+ uint32_t result = 0;
+ for (nsContainerFrame* ancestor = GetParent(); ancestor;
+ ancestor = ancestor->GetParent()) {
+ result++;
+ }
+ return result;
+}
+
+/**
+ * This function takes a frame that is part of a block-in-inline split,
+ * and _if_ that frame is an anonymous block created by an ib split it
+ * returns the block's preceding inline. This is needed because the
+ * split inline's style is the parent of the anonymous block's style.
+ *
+ * If aFrame is not an anonymous block, null is returned.
+ */
+static nsIFrame* GetIBSplitSiblingForAnonymousBlock(const nsIFrame* aFrame) {
+ MOZ_ASSERT(aFrame, "Must have a non-null frame!");
+ NS_ASSERTION(aFrame->HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT),
+ "GetIBSplitSibling should only be called on ib-split frames");
+
+ if (aFrame->Style()->GetPseudoType() !=
+ PseudoStyleType::mozBlockInsideInlineWrapper) {
+ // it's not an anonymous block
+ return nullptr;
+ }
+
+ // Find the first continuation of the frame. (Ugh. This ends up
+ // being O(N^2) when it is called O(N) times.)
+ aFrame = aFrame->FirstContinuation();
+
+ /*
+ * Now look up the nsGkAtoms::IBSplitPrevSibling
+ * property.
+ */
+ nsIFrame* ibSplitSibling =
+ aFrame->GetProperty(nsIFrame::IBSplitPrevSibling());
+ NS_ASSERTION(ibSplitSibling, "Broken frame tree?");
+ return ibSplitSibling;
+}
+
+/**
+ * Get the parent, corrected for the mangled frame tree resulting from
+ * having a block within an inline. The result only differs from the
+ * result of |GetParent| when |GetParent| returns an anonymous block
+ * that was created for an element that was 'display: inline' because
+ * that element contained a block.
+ *
+ * Also skip anonymous scrolled-content parents; inherit directly from the
+ * outer scroll frame.
+ *
+ * Also skip NAC parents if the child frame is NAC.
+ */
+static nsIFrame* GetCorrectedParent(const nsIFrame* aFrame) {
+ nsIFrame* parent = aFrame->GetParent();
+ if (!parent) {
+ return nullptr;
+ }
+
+ // For a table caption we want the _inner_ table frame (unless it's anonymous)
+ // as the style parent.
+ if (aFrame->IsTableCaption()) {
+ nsIFrame* innerTable = parent->PrincipalChildList().FirstChild();
+ if (!innerTable->Style()->IsAnonBox()) {
+ return innerTable;
+ }
+ }
+
+ // Table wrappers are always anon boxes; if we're in here for an outer
+ // table, that actually means its the _inner_ table that wants to
+ // know its parent. So get the pseudo of the inner in that case.
+ auto pseudo = aFrame->Style()->GetPseudoType();
+ if (pseudo == PseudoStyleType::tableWrapper) {
+ pseudo =
+ aFrame->PrincipalChildList().FirstChild()->Style()->GetPseudoType();
+ }
+
+ // Prevent a NAC pseudo-element from inheriting from its NAC parent, and
+ // inherit from the NAC generator element instead.
+ if (pseudo != PseudoStyleType::NotPseudo) {
+ MOZ_ASSERT(aFrame->GetContent());
+ Element* element = Element::FromNode(aFrame->GetContent());
+ // Make sure to avoid doing the fixup for non-element-backed pseudos like
+ // ::first-line and such.
+ if (element && !element->IsRootOfNativeAnonymousSubtree() &&
+ element->GetPseudoElementType() == aFrame->Style()->GetPseudoType()) {
+ while (parent->GetContent() &&
+ !parent->GetContent()->IsRootOfNativeAnonymousSubtree()) {
+ parent = parent->GetInFlowParent();
+ }
+ parent = parent->GetInFlowParent();
+ }
+ }
+
+ return nsIFrame::CorrectStyleParentFrame(parent, pseudo);
+}
+
+/* static */
+nsIFrame* nsIFrame::CorrectStyleParentFrame(nsIFrame* aProspectiveParent,
+ PseudoStyleType aChildPseudo) {
+ MOZ_ASSERT(aProspectiveParent, "Must have a prospective parent");
+
+ if (aChildPseudo != PseudoStyleType::NotPseudo) {
+ // Non-inheriting anon boxes have no style parent frame at all.
+ if (PseudoStyle::IsNonInheritingAnonBox(aChildPseudo)) {
+ return nullptr;
+ }
+
+ // Other anon boxes are parented to their actual parent already, except
+ // for non-elements. Those should not be treated as an anon box.
+ if (PseudoStyle::IsAnonBox(aChildPseudo) &&
+ !nsCSSAnonBoxes::IsNonElement(aChildPseudo)) {
+ NS_ASSERTION(aChildPseudo != PseudoStyleType::mozBlockInsideInlineWrapper,
+ "Should have dealt with kids that have "
+ "NS_FRAME_PART_OF_IBSPLIT elsewhere");
+ return aProspectiveParent;
+ }
+ }
+
+ // Otherwise, walk up out of all anon boxes. For placeholder frames, walk out
+ // of all pseudo-elements as well. Otherwise ReparentComputedStyle could
+ // cause style data to be out of sync with the frame tree.
+ nsIFrame* parent = aProspectiveParent;
+ do {
+ if (parent->HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT)) {
+ nsIFrame* sibling = GetIBSplitSiblingForAnonymousBlock(parent);
+
+ if (sibling) {
+ // |parent| was a block in an {ib} split; use the inline as
+ // |the style parent.
+ parent = sibling;
+ }
+ }
+
+ if (!parent->Style()->IsPseudoOrAnonBox()) {
+ return parent;
+ }
+
+ if (!parent->Style()->IsAnonBox() && aChildPseudo != PseudoStyleType::MAX) {
+ // nsPlaceholderFrame passes in PseudoStyleType::MAX for
+ // aChildPseudo (even though that's not a valid pseudo-type) just to
+ // trigger this behavior of walking up to the nearest non-pseudo
+ // ancestor.
+ return parent;
+ }
+
+ parent = parent->GetInFlowParent();
+ } while (parent);
+
+ if (aProspectiveParent->Style()->GetPseudoType() ==
+ PseudoStyleType::viewportScroll) {
+ // aProspectiveParent is the scrollframe for a viewport
+ // and the kids are the anonymous scrollbars
+ return aProspectiveParent;
+ }
+
+ // We can get here if the root element is absolutely positioned.
+ // We can't test for this very accurately, but it can only happen
+ // when the prospective parent is a canvas frame.
+ NS_ASSERTION(aProspectiveParent->IsCanvasFrame(),
+ "Should have found a parent before this");
+ return nullptr;
+}
+
+ComputedStyle* nsIFrame::DoGetParentComputedStyle(
+ nsIFrame** aProviderFrame) const {
+ *aProviderFrame = nullptr;
+
+ // Handle display:contents and the root frame, when there's no parent frame
+ // to inherit from.
+ if (MOZ_LIKELY(mContent)) {
+ Element* parentElement = mContent->GetFlattenedTreeParentElement();
+ if (MOZ_LIKELY(parentElement)) {
+ auto pseudo = Style()->GetPseudoType();
+ if (pseudo == PseudoStyleType::NotPseudo || !mContent->IsElement() ||
+ (!PseudoStyle::IsAnonBox(pseudo) &&
+ // Ensure that we don't return the display:contents style
+ // of the parent content for pseudos that have the same content
+ // as their primary frame (like -moz-list-bullets do):
+ IsPrimaryFrame()) ||
+ /* if next is true then it's really a request for the table frame's
+ parent context, see nsTable[Outer]Frame::GetParentComputedStyle. */
+ pseudo == PseudoStyleType::tableWrapper) {
+ // In some edge cases involving display: contents, we may end up here
+ // for something that's pending to be reframed. In this case we return
+ // the wrong style from here (because we've already lost track of it!),
+ // but it's not a big deal as we're going to be reframed anyway.
+ if (MOZ_LIKELY(parentElement->HasServoData()) &&
+ Servo_Element_IsDisplayContents(parentElement)) {
+ RefPtr<ComputedStyle> style =
+ ServoStyleSet::ResolveServoStyle(*parentElement);
+ // NOTE(emilio): we return a weak reference because the element also
+ // holds the style context alive. This is a bit silly (we could've
+ // returned a weak ref directly), but it's probably not worth
+ // optimizing, given this function has just one caller which is rare,
+ // and this path is rare itself.
+ return style;
+ }
+ }
+ } else {
+ if (Style()->GetPseudoType() == PseudoStyleType::NotPseudo) {
+ // We're a frame for the root. We have no style parent.
+ return nullptr;
+ }
+ }
+ }
+
+ if (!HasAnyStateBits(NS_FRAME_OUT_OF_FLOW)) {
+ /*
+ * If this frame is an anonymous block created when an inline with a block
+ * inside it got split, then the parent style is on its preceding inline. We
+ * can get to it using GetIBSplitSiblingForAnonymousBlock.
+ */
+ if (HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT)) {
+ nsIFrame* ibSplitSibling = GetIBSplitSiblingForAnonymousBlock(this);
+ if (ibSplitSibling) {
+ return (*aProviderFrame = ibSplitSibling)->Style();
+ }
+ }
+
+ // If this frame is one of the blocks that split an inline, we must
+ // return the "special" inline parent, i.e., the parent that this
+ // frame would have if we didn't mangle the frame structure.
+ *aProviderFrame = GetCorrectedParent(this);
+ return *aProviderFrame ? (*aProviderFrame)->Style() : nullptr;
+ }
+
+ // We're an out-of-flow frame. For out-of-flow frames, we must
+ // resolve underneath the placeholder's parent. The placeholder is
+ // reached from the first-in-flow.
+ nsPlaceholderFrame* placeholder = FirstInFlow()->GetPlaceholderFrame();
+ if (!placeholder) {
+ MOZ_ASSERT_UNREACHABLE("no placeholder frame for out-of-flow frame");
+ *aProviderFrame = GetCorrectedParent(this);
+ return *aProviderFrame ? (*aProviderFrame)->Style() : nullptr;
+ }
+ return placeholder->GetParentComputedStyleForOutOfFlow(aProviderFrame);
+}
+
+void nsIFrame::GetLastLeaf(nsIFrame** aFrame) {
+ if (!aFrame || !*aFrame) return;
+ nsIFrame* child = *aFrame;
+ // if we are a block frame then go for the last line of 'this'
+ while (1) {
+ child = child->PrincipalChildList().FirstChild();
+ if (!child) return; // nothing to do
+ nsIFrame* siblingFrame;
+ nsIContent* content;
+ // ignore anonymous elements, e.g. mozTableAdd* mozTableRemove*
+ // see bug 278197 comment #12 #13 for details
+ while ((siblingFrame = child->GetNextSibling()) &&
+ (content = siblingFrame->GetContent()) &&
+ !content->IsRootOfNativeAnonymousSubtree())
+ child = siblingFrame;
+ *aFrame = child;
+ }
+}
+
+void nsIFrame::GetFirstLeaf(nsIFrame** aFrame) {
+ if (!aFrame || !*aFrame) return;
+ nsIFrame* child = *aFrame;
+ while (1) {
+ child = child->PrincipalChildList().FirstChild();
+ if (!child) return; // nothing to do
+ *aFrame = child;
+ }
+}
+
+bool nsIFrame::IsFocusableDueToScrollFrame() {
+ if (!IsScrollFrame()) {
+ if (nsFieldSetFrame* fieldset = do_QueryFrame(this)) {
+ // TODO: Do we have similar special-cases like this where we can have
+ // anonymous scrollable boxes hanging off a primary frame?
+ if (nsIFrame* inner = fieldset->GetInner()) {
+ return inner->IsFocusableDueToScrollFrame();
+ }
+ }
+ return false;
+ }
+ if (!mContent->IsHTMLElement()) {
+ return false;
+ }
+ if (mContent->IsRootOfNativeAnonymousSubtree()) {
+ return false;
+ }
+ if (!mContent->GetParent()) {
+ return false;
+ }
+ if (mContent->AsElement()->HasAttr(nsGkAtoms::tabindex)) {
+ return false;
+ }
+ // Elements with scrollable view are focusable with script & tabbable
+ // Otherwise you couldn't scroll them with keyboard, which is an accessibility
+ // issue (e.g. Section 508 rules) However, we don't make them to be focusable
+ // with the mouse, because the extra focus outlines are considered
+ // unnecessarily ugly. When clicked on, the selection position within the
+ // element will be enough to make them keyboard scrollable.
+ nsIScrollableFrame* scrollFrame = do_QueryFrame(this);
+ if (!scrollFrame) {
+ return false;
+ }
+ if (scrollFrame->IsForTextControlWithNoScrollbars()) {
+ return false;
+ }
+ if (scrollFrame->GetScrollStyles().IsHiddenInBothDirections()) {
+ return false;
+ }
+ if (scrollFrame->GetScrollRange().IsEqualEdges(nsRect(0, 0, 0, 0))) {
+ return false;
+ }
+ return true;
+}
+
+Focusable nsIFrame::IsFocusable(bool aWithMouse, bool aCheckVisibility) {
+ // cannot focus content in print preview mode. Only the root can be focused,
+ // but that's handled elsewhere.
+ if (PresContext()->Type() == nsPresContext::eContext_PrintPreview) {
+ return {};
+ }
+
+ if (!mContent || !mContent->IsElement()) {
+ return {};
+ }
+
+ if (aCheckVisibility && !IsVisibleConsideringAncestors()) {
+ return {};
+ }
+
+ const StyleUserFocus uf = StyleUI()->UserFocus();
+ if (uf == StyleUserFocus::None) {
+ return {};
+ }
+ MOZ_ASSERT(!StyleUI()->IsInert(), "inert implies -moz-user-focus: none");
+
+ const PseudoStyleType pseudo = Style()->GetPseudoType();
+ if (pseudo == PseudoStyleType::anonymousItem) {
+ return {};
+ }
+
+ Focusable focusable;
+ if (auto* xul = nsXULElement::FromNode(mContent)) {
+ // As a legacy special-case, -moz-user-focus controls focusability and
+ // tabability of XUL elements in some circumstances (which default to
+ // -moz-user-focus: ignore).
+ auto focusability = xul->GetXULFocusability(aWithMouse);
+ focusable.mFocusable =
+ focusability.mForcedFocusable.valueOr(uf == StyleUserFocus::Normal);
+ if (focusable) {
+ focusable.mTabIndex = focusability.mForcedTabIndexIfFocusable.valueOr(0);
+ }
+ } else {
+ focusable = mContent->IsFocusableWithoutStyle(aWithMouse);
+ }
+
+ if (focusable) {
+ return focusable;
+ }
+
+ // If we're focusing with the mouse we never focus scroll areas.
+ if (!aWithMouse && IsFocusableDueToScrollFrame()) {
+ return {true, 0};
+ }
+
+ // FIXME(emilio): some callers rely on somewhat broken return values
+ // (focusable = false, but non-negative tab-index) from
+ // IsFocusableWithoutStyle (for image maps in particular).
+ return focusable;
+}
+
+/**
+ * @return true if this text frame ends with a newline character which is
+ * treated as preformatted. It should return false if this is not a text frame.
+ */
+bool nsIFrame::HasSignificantTerminalNewline() const { return false; }
+
+static StyleVerticalAlignKeyword ConvertSVGDominantBaselineToVerticalAlign(
+ StyleDominantBaseline aDominantBaseline) {
+ // Most of these are approximate mappings.
+ switch (aDominantBaseline) {
+ case StyleDominantBaseline::Hanging:
+ case StyleDominantBaseline::TextBeforeEdge:
+ return StyleVerticalAlignKeyword::TextTop;
+ case StyleDominantBaseline::TextAfterEdge:
+ case StyleDominantBaseline::Ideographic:
+ return StyleVerticalAlignKeyword::TextBottom;
+ case StyleDominantBaseline::Central:
+ case StyleDominantBaseline::Middle:
+ case StyleDominantBaseline::Mathematical:
+ return StyleVerticalAlignKeyword::Middle;
+ case StyleDominantBaseline::Auto:
+ case StyleDominantBaseline::Alphabetic:
+ return StyleVerticalAlignKeyword::Baseline;
+ default:
+ MOZ_ASSERT_UNREACHABLE("unexpected aDominantBaseline value");
+ return StyleVerticalAlignKeyword::Baseline;
+ }
+}
+
+Maybe<StyleVerticalAlignKeyword> nsIFrame::VerticalAlignEnum() const {
+ if (IsInSVGTextSubtree()) {
+ StyleDominantBaseline dominantBaseline = StyleSVG()->mDominantBaseline;
+ return Some(ConvertSVGDominantBaselineToVerticalAlign(dominantBaseline));
+ }
+
+ const auto& verticalAlign = StyleDisplay()->mVerticalAlign;
+ if (verticalAlign.IsKeyword()) {
+ return Some(verticalAlign.AsKeyword());
+ }
+
+ return Nothing();
+}
+
+void nsIFrame::UpdateStyleOfChildAnonBox(nsIFrame* aChildFrame,
+ ServoRestyleState& aRestyleState) {
+#ifdef DEBUG
+ nsIFrame* parent = aChildFrame->GetInFlowParent();
+ if (aChildFrame->IsTableFrame()) {
+ parent = parent->GetParent();
+ }
+ if (parent->IsLineFrame()) {
+ parent = parent->GetParent();
+ }
+ MOZ_ASSERT(nsLayoutUtils::FirstContinuationOrIBSplitSibling(parent) == this,
+ "This should only be used for children!");
+#endif // DEBUG
+ MOZ_ASSERT(!GetContent() || !aChildFrame->GetContent() ||
+ aChildFrame->GetContent() == GetContent(),
+ "What content node is it a frame for?");
+ MOZ_ASSERT(!aChildFrame->GetPrevContinuation(),
+ "Only first continuations should end up here");
+
+ // We could force the caller to pass in the pseudo, since some callers know it
+ // statically... But this API is a bit nicer.
+ auto pseudo = aChildFrame->Style()->GetPseudoType();
+ MOZ_ASSERT(PseudoStyle::IsAnonBox(pseudo), "Child is not an anon box?");
+ MOZ_ASSERT(!PseudoStyle::IsNonInheritingAnonBox(pseudo),
+ "Why did the caller bother calling us?");
+
+ // Anon boxes inherit from their parent; that's us.
+ RefPtr<ComputedStyle> newContext =
+ aRestyleState.StyleSet().ResolveInheritingAnonymousBoxStyle(pseudo,
+ Style());
+
+ nsChangeHint childHint =
+ UpdateStyleOfOwnedChildFrame(aChildFrame, newContext, aRestyleState);
+
+ // Now that we've updated the style on aChildFrame, check whether it itself
+ // has anon boxes to deal with.
+ ServoRestyleState childrenState(*aChildFrame, aRestyleState, childHint,
+ ServoRestyleState::Type::InFlow);
+ aChildFrame->UpdateStyleOfOwnedAnonBoxes(childrenState);
+
+ // Assuming anon boxes don't have ::backdrop associated with them... if that
+ // ever changes, we'd need to handle that here, like we do in
+ // RestyleManager::ProcessPostTraversal
+
+ // We do need to handle block pseudo-elements here, though. Especially list
+ // bullets.
+ if (nsBlockFrame* block = do_QueryFrame(aChildFrame)) {
+ block->UpdatePseudoElementStyles(childrenState);
+ }
+}
+
+/* static */
+nsChangeHint nsIFrame::UpdateStyleOfOwnedChildFrame(
+ nsIFrame* aChildFrame, ComputedStyle* aNewComputedStyle,
+ ServoRestyleState& aRestyleState,
+ const Maybe<ComputedStyle*>& aContinuationComputedStyle) {
+ MOZ_ASSERT(!aChildFrame->GetAdditionalComputedStyle(0),
+ "We don't handle additional styles here");
+
+ // Figure out whether we have an actual change. It's important that we do
+ // this, for several reasons:
+ //
+ // 1) Even if all the child's changes are due to properties it inherits from
+ // us, it's possible that no one ever asked us for those style structs and
+ // hence changes to them aren't reflected in the changes handled at all.
+ //
+ // 2) Content can change stylesheets that change the styles of pseudos, and
+ // extensions can add/remove stylesheets that change the styles of
+ // anonymous boxes directly.
+ uint32_t equalStructs; // Not used, actually.
+ nsChangeHint childHint = aChildFrame->Style()->CalcStyleDifference(
+ *aNewComputedStyle, &equalStructs);
+
+ // If aChildFrame is out of flow, then aRestyleState's "changes handled by the
+ // parent" doesn't apply to it, because it may have some other parent in the
+ // frame tree.
+ if (!aChildFrame->HasAnyStateBits(NS_FRAME_OUT_OF_FLOW)) {
+ childHint = NS_RemoveSubsumedHints(
+ childHint, aRestyleState.ChangesHandledFor(aChildFrame));
+ }
+ if (childHint) {
+ if (childHint & nsChangeHint_ReconstructFrame) {
+ // If we generate a reconstruct here, remove any non-reconstruct hints we
+ // may have already generated for this content.
+ aRestyleState.ChangeList().PopChangesForContent(
+ aChildFrame->GetContent());
+ }
+ aRestyleState.ChangeList().AppendChange(
+ aChildFrame, aChildFrame->GetContent(), childHint);
+ }
+
+ aChildFrame->SetComputedStyle(aNewComputedStyle);
+ ComputedStyle* continuationStyle = aContinuationComputedStyle
+ ? *aContinuationComputedStyle
+ : aNewComputedStyle;
+ for (nsIFrame* kid = aChildFrame->GetNextContinuation(); kid;
+ kid = kid->GetNextContinuation()) {
+ MOZ_ASSERT(!kid->GetAdditionalComputedStyle(0));
+ kid->SetComputedStyle(continuationStyle);
+ }
+
+ return childHint;
+}
+
+/* static */
+void nsIFrame::AddInPopupStateBitToDescendants(nsIFrame* aFrame) {
+ if (!aFrame->HasAnyStateBits(NS_FRAME_IN_POPUP) &&
+ aFrame->TrackingVisibility()) {
+ // Assume all frames in popups are visible.
+ aFrame->IncApproximateVisibleCount();
+ }
+
+ aFrame->AddStateBits(NS_FRAME_IN_POPUP);
+
+ for (const auto& childList : aFrame->CrossDocChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ AddInPopupStateBitToDescendants(child);
+ }
+ }
+}
+
+/* static */
+void nsIFrame::RemoveInPopupStateBitFromDescendants(nsIFrame* aFrame) {
+ if (!aFrame->HasAnyStateBits(NS_FRAME_IN_POPUP) ||
+ nsLayoutUtils::IsPopup(aFrame)) {
+ return;
+ }
+
+ aFrame->RemoveStateBits(NS_FRAME_IN_POPUP);
+
+ if (aFrame->TrackingVisibility()) {
+ // We assume all frames in popups are visible, so this decrement balances
+ // out the increment in AddInPopupStateBitToDescendants above.
+ aFrame->DecApproximateVisibleCount();
+ }
+ for (const auto& childList : aFrame->CrossDocChildLists()) {
+ for (nsIFrame* child : childList.mList) {
+ RemoveInPopupStateBitFromDescendants(child);
+ }
+ }
+}
+
+void nsIFrame::SetParent(nsContainerFrame* aParent) {
+ // If our parent is a wrapper anon box, our new parent should be too. We
+ // _can_ change parent if our parent is a wrapper anon box, because some
+ // wrapper anon boxes can have continuations.
+ MOZ_ASSERT_IF(ParentIsWrapperAnonBox(),
+ aParent->Style()->IsInheritingAnonBox());
+
+ // Note that the current mParent may already be destroyed at this point.
+ mParent = aParent;
+ MOZ_DIAGNOSTIC_ASSERT(!mParent || PresShell() == mParent->PresShell());
+
+ if (HasAnyStateBits(NS_FRAME_HAS_VIEW | NS_FRAME_HAS_CHILD_WITH_VIEW)) {
+ for (nsIFrame* f = aParent;
+ f && !f->HasAnyStateBits(NS_FRAME_HAS_CHILD_WITH_VIEW);
+ f = f->GetParent()) {
+ f->AddStateBits(NS_FRAME_HAS_CHILD_WITH_VIEW);
+ }
+ }
+
+ if (HasAnyStateBits(NS_FRAME_CONTAINS_RELATIVE_BSIZE)) {
+ for (nsIFrame* f = aParent; f; f = f->GetParent()) {
+ if (f->HasAnyStateBits(NS_FRAME_CONTAINS_RELATIVE_BSIZE)) {
+ break;
+ }
+ f->AddStateBits(NS_FRAME_CONTAINS_RELATIVE_BSIZE);
+ }
+ }
+
+ if (HasAnyStateBits(NS_FRAME_DESCENDANT_INTRINSIC_ISIZE_DEPENDS_ON_BSIZE)) {
+ for (nsIFrame* f = aParent; f; f = f->GetParent()) {
+ if (f->HasAnyStateBits(
+ NS_FRAME_DESCENDANT_INTRINSIC_ISIZE_DEPENDS_ON_BSIZE)) {
+ break;
+ }
+ f->AddStateBits(NS_FRAME_DESCENDANT_INTRINSIC_ISIZE_DEPENDS_ON_BSIZE);
+ }
+ }
+
+ if (HasInvalidFrameInSubtree()) {
+ for (nsIFrame* f = aParent;
+ f && !f->HasAnyStateBits(NS_FRAME_DESCENDANT_NEEDS_PAINT |
+ NS_FRAME_IS_NONDISPLAY);
+ f = nsLayoutUtils::GetCrossDocParentFrameInProcess(f)) {
+ f->AddStateBits(NS_FRAME_DESCENDANT_NEEDS_PAINT);
+ }
+ }
+
+ if (aParent->HasAnyStateBits(NS_FRAME_IN_POPUP)) {
+ AddInPopupStateBitToDescendants(this);
+ } else {
+ RemoveInPopupStateBitFromDescendants(this);
+ }
+
+ // If our new parent only has invalid children, then we just invalidate
+ // ourselves too. This is probably faster than clearing the flag all
+ // the way up the frame tree.
+ if (aParent->HasAnyStateBits(NS_FRAME_ALL_DESCENDANTS_NEED_PAINT)) {
+ InvalidateFrame();
+ } else {
+ SchedulePaint();
+ }
+}
+
+bool nsIFrame::IsStackingContext(const nsStyleDisplay* aStyleDisplay,
+ const nsStyleEffects* aStyleEffects) {
+ // Properties that influence the output of this function should be handled in
+ // change_bits_for_longhand as well.
+ if (HasOpacity(aStyleDisplay, aStyleEffects, nullptr)) {
+ return true;
+ }
+ if (IsTransformed()) {
+ return true;
+ }
+ auto willChange = aStyleDisplay->mWillChange.bits;
+ if (aStyleDisplay->IsContainPaint() || aStyleDisplay->IsContainLayout() ||
+ willChange & StyleWillChangeBits::CONTAIN) {
+ if (SupportsContainLayoutAndPaint()) {
+ return true;
+ }
+ }
+ // strictly speaking, 'perspective' doesn't require visual atomicity,
+ // but the spec says it acts like the rest of these
+ if (aStyleDisplay->HasPerspectiveStyle() ||
+ willChange & StyleWillChangeBits::PERSPECTIVE) {
+ if (SupportsCSSTransforms()) {
+ return true;
+ }
+ }
+ if (!StylePosition()->mZIndex.IsAuto() ||
+ willChange & StyleWillChangeBits::Z_INDEX) {
+ if (ZIndexApplies()) {
+ return true;
+ }
+ }
+ return aStyleEffects->mMixBlendMode != StyleBlend::Normal ||
+ SVGIntegrationUtils::UsingEffectsForFrame(this) ||
+ aStyleDisplay->IsPositionForcingStackingContext() ||
+ aStyleDisplay->mIsolation != StyleIsolation::Auto ||
+ willChange & StyleWillChangeBits::STACKING_CONTEXT_UNCONDITIONAL;
+}
+
+bool nsIFrame::IsStackingContext() {
+ return IsStackingContext(StyleDisplay(), StyleEffects());
+}
+
+static bool IsFrameScrolledOutOfView(const nsIFrame* aTarget,
+ const nsRect& aTargetRect,
+ const nsIFrame* aParent) {
+ // The ancestor frame we are checking if it clips out aTargetRect relative to
+ // aTarget.
+ nsIFrame* clipParent = nullptr;
+
+ // find the first scrollable frame or root frame if we are in a fixed pos
+ // subtree
+ for (nsIFrame* f = const_cast<nsIFrame*>(aParent); f;
+ f = nsLayoutUtils::GetCrossDocParentFrameInProcess(f)) {
+ nsIScrollableFrame* scrollableFrame = do_QueryFrame(f);
+ if (scrollableFrame) {
+ clipParent = f;
+ break;
+ }
+ if (f->StyleDisplay()->mPosition == StylePositionProperty::Fixed &&
+ nsLayoutUtils::IsReallyFixedPos(f)) {
+ clipParent = f->GetParent();
+ break;
+ }
+ }
+
+ if (!clipParent) {
+ // Even if we couldn't find the nearest scrollable frame, it might mean we
+ // are in an out-of-process iframe, try to see if |aTarget| frame is
+ // scrolled out of view in an scrollable frame in a cross-process ancestor
+ // document.
+ return nsLayoutUtils::FrameIsScrolledOutOfViewInCrossProcess(aTarget);
+ }
+
+ nsRect clipRect = clipParent->InkOverflowRectRelativeToSelf();
+ // We consider that the target is scrolled out if the scrollable (or root)
+ // frame is empty.
+ if (clipRect.IsEmpty()) {
+ return true;
+ }
+
+ nsRect transformedRect = nsLayoutUtils::TransformFrameRectToAncestor(
+ aTarget, aTargetRect, clipParent);
+
+ if (transformedRect.IsEmpty()) {
+ // If the transformed rect is empty it represents a line or a point that we
+ // should check is outside the the scrollable rect.
+ if (transformedRect.x > clipRect.XMost() ||
+ transformedRect.y > clipRect.YMost() ||
+ clipRect.x > transformedRect.XMost() ||
+ clipRect.y > transformedRect.YMost()) {
+ return true;
+ }
+ } else if (!transformedRect.Intersects(clipRect)) {
+ return true;
+ }
+
+ nsIFrame* parent = clipParent->GetParent();
+ if (!parent) {
+ return false;
+ }
+
+ return IsFrameScrolledOutOfView(aTarget, aTargetRect, parent);
+}
+
+bool nsIFrame::IsScrolledOutOfView() const {
+ nsRect rect = InkOverflowRectRelativeToSelf();
+ return IsFrameScrolledOutOfView(this, rect, this);
+}
+
+gfx::Matrix nsIFrame::ComputeWidgetTransform() const {
+ const nsStyleUIReset* uiReset = StyleUIReset();
+ if (uiReset->mMozWindowTransform.IsNone()) {
+ return gfx::Matrix();
+ }
+
+ TransformReferenceBox refBox(nullptr, nsRect(nsPoint(), GetSize()));
+
+ nsPresContext* presContext = PresContext();
+ int32_t appUnitsPerDevPixel = presContext->AppUnitsPerDevPixel();
+ gfx::Matrix4x4 matrix = nsStyleTransformMatrix::ReadTransforms(
+ uiReset->mMozWindowTransform, refBox, float(appUnitsPerDevPixel));
+
+ // Apply the -moz-window-transform-origin translation to the matrix.
+ const StyleTransformOrigin& origin = uiReset->mWindowTransformOrigin;
+ Point transformOrigin = nsStyleTransformMatrix::Convert2DPosition(
+ origin.horizontal, origin.vertical, refBox, appUnitsPerDevPixel);
+ matrix.ChangeBasis(Point3D(transformOrigin.x, transformOrigin.y, 0));
+
+ gfx::Matrix result2d;
+ if (!matrix.CanDraw2D(&result2d)) {
+ // FIXME: It would be preferable to reject non-2D transforms at parse time.
+ NS_WARNING(
+ "-moz-window-transform does not describe a 2D transform, "
+ "but only 2d transforms are supported");
+ return gfx::Matrix();
+ }
+
+ return result2d;
+}
+
+void nsIFrame::DoUpdateStyleOfOwnedAnonBoxes(ServoRestyleState& aRestyleState) {
+ // As a special case, we check for {ib}-split block frames here, rather
+ // than have an nsInlineFrame::AppendDirectlyOwnedAnonBoxes implementation
+ // that returns them.
+ //
+ // (If we did handle them in AppendDirectlyOwnedAnonBoxes, we would have to
+ // return *all* of the in-flow {ib}-split block frames, not just the first
+ // one. For restyling, we really just need the first in flow, and the other
+ // user of the AppendOwnedAnonBoxes API, AllChildIterator, doesn't need to
+ // know about them at all, since these block frames never create NAC. So we
+ // avoid any unncessary hashtable lookups for the {ib}-split frames by calling
+ // UpdateStyleOfOwnedAnonBoxesForIBSplit directly here.)
+ if (IsInlineFrame()) {
+ if (HasAnyStateBits(NS_FRAME_PART_OF_IBSPLIT)) {
+ static_cast<nsInlineFrame*>(this)->UpdateStyleOfOwnedAnonBoxesForIBSplit(
+ aRestyleState);
+ }
+ return;
+ }
+
+ AutoTArray<OwnedAnonBox, 4> frames;
+ AppendDirectlyOwnedAnonBoxes(frames);
+ for (OwnedAnonBox& box : frames) {
+ if (box.mUpdateStyleFn) {
+ box.mUpdateStyleFn(this, box.mAnonBoxFrame, aRestyleState);
+ } else {
+ UpdateStyleOfChildAnonBox(box.mAnonBoxFrame, aRestyleState);
+ }
+ }
+}
+
+/* virtual */
+void nsIFrame::AppendDirectlyOwnedAnonBoxes(nsTArray<OwnedAnonBox>& aResult) {
+ MOZ_ASSERT(!HasAnyStateBits(NS_FRAME_OWNS_ANON_BOXES));
+ MOZ_ASSERT(false, "Why did this get called?");
+}
+
+void nsIFrame::DoAppendOwnedAnonBoxes(nsTArray<OwnedAnonBox>& aResult) {
+ size_t i = aResult.Length();
+ AppendDirectlyOwnedAnonBoxes(aResult);
+
+ // After appending the directly owned anonymous boxes of this frame to
+ // aResult above, we need to check each of them to see if they own
+ // any anonymous boxes themselves. Note that we keep progressing
+ // through aResult, looking for additional entries in aResult from these
+ // subsequent AppendDirectlyOwnedAnonBoxes calls. (Thus we can't
+ // use a ranged for loop here.)
+
+ while (i < aResult.Length()) {
+ nsIFrame* f = aResult[i].mAnonBoxFrame;
+ if (f->HasAnyStateBits(NS_FRAME_OWNS_ANON_BOXES)) {
+ f->AppendDirectlyOwnedAnonBoxes(aResult);
+ }
+ ++i;
+ }
+}
+
+nsIFrame::CaretPosition::CaretPosition() : mContentOffset(0) {}
+
+nsIFrame::CaretPosition::~CaretPosition() = default;
+
+bool nsIFrame::HasCSSAnimations() {
+ auto* collection = AnimationCollection<CSSAnimation>::Get(this);
+ return collection && !collection->mAnimations.IsEmpty();
+}
+
+bool nsIFrame::HasCSSTransitions() {
+ auto* collection = AnimationCollection<CSSTransition>::Get(this);
+ return collection && !collection->mAnimations.IsEmpty();
+}
+
+void nsIFrame::AddSizeOfExcludingThisForTree(nsWindowSizes& aSizes) const {
+ aSizes.mLayoutFramePropertiesSize +=
+ mProperties.SizeOfExcludingThis(aSizes.mState.mMallocSizeOf);
+
+ // We don't do this for Gecko because this stuff is stored in the nsPresArena
+ // and so measured elsewhere.
+ if (!aSizes.mState.HaveSeenPtr(mComputedStyle)) {
+ mComputedStyle->AddSizeOfIncludingThis(aSizes,
+ &aSizes.mLayoutComputedValuesNonDom);
+ }
+
+ // And our additional styles.
+ int32_t index = 0;
+ while (auto* extra = GetAdditionalComputedStyle(index++)) {
+ if (!aSizes.mState.HaveSeenPtr(extra)) {
+ extra->AddSizeOfIncludingThis(aSizes,
+ &aSizes.mLayoutComputedValuesNonDom);
+ }
+ }
+
+ for (const auto& childList : ChildLists()) {
+ for (const nsIFrame* f : childList.mList) {
+ f->AddSizeOfExcludingThisForTree(aSizes);
+ }
+ }
+}
+
+nsRect nsIFrame::GetCompositorHitTestArea(nsDisplayListBuilder* aBuilder) {
+ nsRect area;
+
+ nsIScrollableFrame* scrollFrame = nsLayoutUtils::GetScrollableFrameFor(this);
+ if (scrollFrame) {
+ // If the frame is content of a scrollframe, then we need to pick up the
+ // area corresponding to the overflow rect as well. Otherwise the parts of
+ // the overflow that are not occupied by descendants get skipped and the
+ // APZ code sends touch events to the content underneath instead.
+ // See https://bugzilla.mozilla.org/show_bug.cgi?id=1127773#c15.
+ area = ScrollableOverflowRect();
+ } else {
+ area = GetRectRelativeToSelf();
+ }
+
+ if (!area.IsEmpty()) {
+ return area + aBuilder->ToReferenceFrame(this);
+ }
+
+ return area;
+}
+
+CompositorHitTestInfo nsIFrame::GetCompositorHitTestInfo(
+ nsDisplayListBuilder* aBuilder) {
+ CompositorHitTestInfo result = CompositorHitTestInvisibleToHit;
+
+ if (aBuilder->IsInsidePointerEventsNoneDoc()) {
+ // Somewhere up the parent document chain is a subdocument with pointer-
+ // events:none set on it.
+ return result;
+ }
+ if (!GetParent()) {
+ MOZ_ASSERT(IsViewportFrame());
+ // Viewport frames are never event targets, other frames, like canvas
+ // frames, are the event targets for any regions viewport frames may cover.
+ return result;
+ }
+ if (Style()->PointerEvents() == StylePointerEvents::None) {
+ return result;
+ }
+ if (!StyleVisibility()->IsVisible()) {
+ return result;
+ }
+
+ // Anything that didn't match the above conditions is visible to hit-testing.
+ result = CompositorHitTestFlags::eVisibleToHitTest;
+ SVGUtils::MaskUsage maskUsage = SVGUtils::DetermineMaskUsage(this, false);
+ if (maskUsage.UsingMaskOrClipPath()) {
+ // If WebRender is enabled, simple clip-paths can be converted into WR
+ // clips that WR knows how to hit-test against, so we don't need to mark
+ // it as an irregular area.
+ if (!maskUsage.IsSimpleClipShape()) {
+ result += CompositorHitTestFlags::eIrregularArea;
+ }
+ }
+
+ if (aBuilder->IsBuildingNonLayerizedScrollbar()) {
+ // Scrollbars may be painted into a layer below the actual layer they will
+ // scroll, and therefore wheel events may be dispatched to the outer frame
+ // instead of the intended scrollframe. To address this, we force a d-t-c
+ // region on scrollbar frames that won't be placed in their own layer. See
+ // bug 1213324 for details.
+ result += CompositorHitTestFlags::eInactiveScrollframe;
+ } else if (aBuilder->GetAncestorHasApzAwareEventHandler()) {
+ result += CompositorHitTestFlags::eApzAwareListeners;
+ } else if (IsRangeFrame()) {
+ // Range frames handle touch events directly without having a touch listener
+ // so we need to let APZ know that this area cares about events.
+ result += CompositorHitTestFlags::eApzAwareListeners;
+ }
+
+ if (aBuilder->IsTouchEventPrefEnabledDoc()) {
+ // Inherit the touch-action flags from the parent, if there is one. We do
+ // this because of how the touch-action on a frame combines the touch-action
+ // from ancestor DOM elements. Refer to the documentation in
+ // TouchActionHelper.cpp for details; this code is meant to be equivalent to
+ // that code, but woven into the top-down recursive display list building
+ // process.
+ CompositorHitTestInfo inheritedTouchAction =
+ aBuilder->GetCompositorHitTestInfo() & CompositorHitTestTouchActionMask;
+
+ nsIFrame* touchActionFrame = this;
+ if (nsIScrollableFrame* scrollFrame =
+ nsLayoutUtils::GetScrollableFrameFor(this)) {
+ ScrollStyles ss = scrollFrame->GetScrollStyles();
+ if (ss.mVertical != StyleOverflow::Hidden ||
+ ss.mHorizontal != StyleOverflow::Hidden) {
+ touchActionFrame = do_QueryFrame(scrollFrame);
+ // On scrollframes, stop inheriting the pan-x and pan-y flags; instead,
+ // reset them back to zero to allow panning on the scrollframe unless we
+ // encounter an element that disables it that's inside the scrollframe.
+ // This is equivalent to the |considerPanning| variable in
+ // TouchActionHelper.cpp, but for a top-down traversal.
+ CompositorHitTestInfo panMask(
+ CompositorHitTestFlags::eTouchActionPanXDisabled,
+ CompositorHitTestFlags::eTouchActionPanYDisabled);
+ inheritedTouchAction -= panMask;
+ }
+ }
+
+ result += inheritedTouchAction;
+
+ const StyleTouchAction touchAction = touchActionFrame->UsedTouchAction();
+ // The CSS allows the syntax auto | none | [pan-x || pan-y] | manipulation
+ // so we can eliminate some combinations of things.
+ if (touchAction == StyleTouchAction::AUTO) {
+ // nothing to do
+ } else if (touchAction & StyleTouchAction::MANIPULATION) {
+ result += CompositorHitTestFlags::eTouchActionAnimatingZoomDisabled;
+ } else {
+ // This path handles the cases none | [pan-x || pan-y || pinch-zoom] so
+ // double-tap is disabled in here.
+ if (!(touchAction & StyleTouchAction::PINCH_ZOOM)) {
+ result += CompositorHitTestFlags::eTouchActionPinchZoomDisabled;
+ }
+
+ result += CompositorHitTestFlags::eTouchActionAnimatingZoomDisabled;
+
+ if (!(touchAction & StyleTouchAction::PAN_X)) {
+ result += CompositorHitTestFlags::eTouchActionPanXDisabled;
+ }
+ if (!(touchAction & StyleTouchAction::PAN_Y)) {
+ result += CompositorHitTestFlags::eTouchActionPanYDisabled;
+ }
+ if (touchAction & StyleTouchAction::NONE) {
+ // all the touch-action disabling flags will already have been set above
+ MOZ_ASSERT(result.contains(CompositorHitTestTouchActionMask));
+ }
+ }
+ }
+
+ const Maybe<ScrollDirection> scrollDirection =
+ aBuilder->GetCurrentScrollbarDirection();
+ if (scrollDirection.isSome()) {
+ if (GetContent()->IsXULElement(nsGkAtoms::thumb)) {
+ const bool thumbGetsLayer = aBuilder->GetCurrentScrollbarTarget() !=
+ layers::ScrollableLayerGuid::NULL_SCROLL_ID;
+ if (thumbGetsLayer) {
+ result += CompositorHitTestFlags::eScrollbarThumb;
+ } else {
+ result += CompositorHitTestFlags::eInactiveScrollframe;
+ }
+ }
+
+ if (*scrollDirection == ScrollDirection::eVertical) {
+ result += CompositorHitTestFlags::eScrollbarVertical;
+ }
+
+ // includes the ScrollbarFrame, SliderFrame, anything else that
+ // might be inside the xul:scrollbar
+ result += CompositorHitTestFlags::eScrollbar;
+ }
+
+ return result;
+}
+
+// Returns true if we can guarantee there is no visible descendants.
+static bool HasNoVisibleDescendants(const nsIFrame* aFrame) {
+ for (const auto& childList : aFrame->ChildLists()) {
+ for (nsIFrame* f : childList.mList) {
+ if (nsPlaceholderFrame::GetRealFrameFor(f)
+ ->IsVisibleOrMayHaveVisibleDescendants()) {
+ return false;
+ }
+ }
+ }
+ return true;
+}
+
+nsIScrollableFrame* nsIFrame::GetAsScrollContainer() const {
+ return do_QueryFrame(this);
+}
+
+void nsIFrame::UpdateVisibleDescendantsState() {
+ if (StyleVisibility()->IsVisible()) {
+ // Notify invisible ancestors that a visible descendant exists now.
+ nsIFrame* ancestor;
+ for (ancestor = GetInFlowParent();
+ ancestor && !ancestor->StyleVisibility()->IsVisible();
+ ancestor = ancestor->GetInFlowParent()) {
+ ancestor->mAllDescendantsAreInvisible = false;
+ }
+ } else {
+ mAllDescendantsAreInvisible = HasNoVisibleDescendants(this);
+ }
+}
+
+nsIFrame::PhysicalAxes nsIFrame::ShouldApplyOverflowClipping(
+ const nsStyleDisplay* aDisp) const {
+ MOZ_ASSERT(aDisp == StyleDisplay(), "Wrong display struct");
+
+ // 'contain:paint', which we handle as 'overflow:clip' here. Except for
+ // scrollframes we don't need contain:paint to add any clipping, because
+ // the scrollable frame will already clip overflowing content, and because
+ // 'contain:paint' should prevent all means of escaping that clipping
+ // (e.g. because it forms a fixed-pos containing block).
+ if (aDisp->IsContainPaint() && !IsScrollFrame() &&
+ SupportsContainLayoutAndPaint()) {
+ return PhysicalAxes::Both;
+ }
+
+ // and overflow:hidden that we should interpret as clip
+ if (aDisp->mOverflowX == StyleOverflow::Hidden &&
+ aDisp->mOverflowY == StyleOverflow::Hidden) {
+ // REVIEW: these are the frame types that set up clipping.
+ LayoutFrameType type = Type();
+ switch (type) {
+ case LayoutFrameType::Table:
+ case LayoutFrameType::TableCell:
+ case LayoutFrameType::SVGOuterSVG:
+ case LayoutFrameType::SVGInnerSVG:
+ case LayoutFrameType::SVGSymbol:
+ case LayoutFrameType::SVGForeignObject:
+ return PhysicalAxes::Both;
+ default:
+ if (IsReplacedWithBlock()) {
+ if (type == mozilla::LayoutFrameType::TextInput) {
+ // It has an anonymous scroll frame that handles any overflow.
+ return PhysicalAxes::None;
+ }
+ return PhysicalAxes::Both;
+ }
+ }
+ }
+
+ // clip overflow:clip, except for nsListControlFrame which is
+ // an nsHTMLScrollFrame sub-class.
+ if (MOZ_UNLIKELY((aDisp->mOverflowX == mozilla::StyleOverflow::Clip ||
+ aDisp->mOverflowY == mozilla::StyleOverflow::Clip) &&
+ !IsListControlFrame())) {
+ // FIXME: we could use GetViewportScrollStylesOverrideElement() here instead
+ // if that worked correctly in a print context. (see bug 1654667)
+ const auto* element = Element::FromNodeOrNull(GetContent());
+ if (!element ||
+ !PresContext()->ElementWouldPropagateScrollStyles(*element)) {
+ uint8_t axes = uint8_t(PhysicalAxes::None);
+ if (aDisp->mOverflowX == mozilla::StyleOverflow::Clip) {
+ axes |= uint8_t(PhysicalAxes::Horizontal);
+ }
+ if (aDisp->mOverflowY == mozilla::StyleOverflow::Clip) {
+ axes |= uint8_t(PhysicalAxes::Vertical);
+ }
+ return PhysicalAxes(axes);
+ }
+ }
+
+ if (HasAnyStateBits(NS_FRAME_SVG_LAYOUT)) {
+ return PhysicalAxes::None;
+ }
+
+ // If we're paginated and a block, and have NS_BLOCK_CLIP_PAGINATED_OVERFLOW
+ // set, then we want to clip our overflow.
+ bool clip = HasAnyStateBits(NS_BLOCK_CLIP_PAGINATED_OVERFLOW) &&
+ PresContext()->IsPaginated() && IsBlockFrame();
+ return clip ? PhysicalAxes::Both : PhysicalAxes::None;
+}
+
+#ifdef DEBUG
+static void GetTagName(nsIFrame* aFrame, nsIContent* aContent, int aResultSize,
+ char* aResult) {
+ if (aContent) {
+ snprintf(aResult, aResultSize, "%s@%p",
+ nsAtomCString(aContent->NodeInfo()->NameAtom()).get(), aFrame);
+ } else {
+ snprintf(aResult, aResultSize, "@%p", aFrame);
+ }
+}
+
+void nsIFrame::Trace(const char* aMethod, bool aEnter) {
+ if (NS_FRAME_LOG_TEST(sFrameLogModule, NS_FRAME_TRACE_CALLS)) {
+ char tagbuf[40];
+ GetTagName(this, mContent, sizeof(tagbuf), tagbuf);
+ printf_stderr("%s: %s %s", tagbuf, aEnter ? "enter" : "exit", aMethod);
+ }
+}
+
+void nsIFrame::Trace(const char* aMethod, bool aEnter,
+ const nsReflowStatus& aStatus) {
+ if (NS_FRAME_LOG_TEST(sFrameLogModule, NS_FRAME_TRACE_CALLS)) {
+ char tagbuf[40];
+ GetTagName(this, mContent, sizeof(tagbuf), tagbuf);
+ printf_stderr("%s: %s %s, status=%scomplete%s", tagbuf,
+ aEnter ? "enter" : "exit", aMethod,
+ aStatus.IsIncomplete() ? "not" : "",
+ (aStatus.NextInFlowNeedsReflow()) ? "+reflow" : "");
+ }
+}
+
+void nsIFrame::TraceMsg(const char* aFormatString, ...) {
+ if (NS_FRAME_LOG_TEST(sFrameLogModule, NS_FRAME_TRACE_CALLS)) {
+ // Format arguments into a buffer
+ char argbuf[200];
+ va_list ap;
+ va_start(ap, aFormatString);
+ VsprintfLiteral(argbuf, aFormatString, ap);
+ va_end(ap);
+
+ char tagbuf[40];
+ GetTagName(this, mContent, sizeof(tagbuf), tagbuf);
+ printf_stderr("%s: %s", tagbuf, argbuf);
+ }
+}
+
+void nsIFrame::VerifyDirtyBitSet(const nsFrameList& aFrameList) {
+ for (nsIFrame* f : aFrameList) {
+ NS_ASSERTION(f->HasAnyStateBits(NS_FRAME_IS_DIRTY), "dirty bit not set");
+ }
+}
+
+// Start Display Reflow
+DR_cookie::DR_cookie(nsPresContext* aPresContext, nsIFrame* aFrame,
+ const ReflowInput& aReflowInput, ReflowOutput& aMetrics,
+ nsReflowStatus& aStatus)
+ : mPresContext(aPresContext),
+ mFrame(aFrame),
+ mReflowInput(aReflowInput),
+ mMetrics(aMetrics),
+ mStatus(aStatus) {
+ MOZ_COUNT_CTOR(DR_cookie);
+ mValue = nsIFrame::DisplayReflowEnter(aPresContext, mFrame, mReflowInput);
+}
+
+DR_cookie::~DR_cookie() {
+ MOZ_COUNT_DTOR(DR_cookie);
+ nsIFrame::DisplayReflowExit(mPresContext, mFrame, mMetrics, mStatus, mValue);
+}
+
+DR_layout_cookie::DR_layout_cookie(nsIFrame* aFrame) : mFrame(aFrame) {
+ MOZ_COUNT_CTOR(DR_layout_cookie);
+ mValue = nsIFrame::DisplayLayoutEnter(mFrame);
+}
+
+DR_layout_cookie::~DR_layout_cookie() {
+ MOZ_COUNT_DTOR(DR_layout_cookie);
+ nsIFrame::DisplayLayoutExit(mFrame, mValue);
+}
+
+DR_intrinsic_inline_size_cookie::DR_intrinsic_inline_size_cookie(
+ nsIFrame* aFrame, const char* aType, nscoord& aResult)
+ : mFrame(aFrame), mType(aType), mResult(aResult) {
+ MOZ_COUNT_CTOR(DR_intrinsic_inline_size_cookie);
+ mValue = nsIFrame::DisplayIntrinsicISizeEnter(mFrame, mType);
+}
+
+DR_intrinsic_inline_size_cookie::~DR_intrinsic_inline_size_cookie() {
+ MOZ_COUNT_DTOR(DR_intrinsic_inline_size_cookie);
+ nsIFrame::DisplayIntrinsicISizeExit(mFrame, mType, mResult, mValue);
+}
+
+DR_intrinsic_size_cookie::DR_intrinsic_size_cookie(nsIFrame* aFrame,
+ const char* aType,
+ nsSize& aResult)
+ : mFrame(aFrame), mType(aType), mResult(aResult) {
+ MOZ_COUNT_CTOR(DR_intrinsic_size_cookie);
+ mValue = nsIFrame::DisplayIntrinsicSizeEnter(mFrame, mType);
+}
+
+DR_intrinsic_size_cookie::~DR_intrinsic_size_cookie() {
+ MOZ_COUNT_DTOR(DR_intrinsic_size_cookie);
+ nsIFrame::DisplayIntrinsicSizeExit(mFrame, mType, mResult, mValue);
+}
+
+DR_init_constraints_cookie::DR_init_constraints_cookie(
+ nsIFrame* aFrame, ReflowInput* aState, nscoord aCBWidth, nscoord aCBHeight,
+ const mozilla::Maybe<mozilla::LogicalMargin> aBorder,
+ const mozilla::Maybe<mozilla::LogicalMargin> aPadding)
+ : mFrame(aFrame), mState(aState) {
+ MOZ_COUNT_CTOR(DR_init_constraints_cookie);
+ nsMargin border;
+ if (aBorder) {
+ border = aBorder->GetPhysicalMargin(aFrame->GetWritingMode());
+ }
+ nsMargin padding;
+ if (aPadding) {
+ padding = aPadding->GetPhysicalMargin(aFrame->GetWritingMode());
+ }
+ mValue = ReflowInput::DisplayInitConstraintsEnter(
+ mFrame, mState, aCBWidth, aCBHeight, aBorder ? &border : nullptr,
+ aPadding ? &padding : nullptr);
+}
+
+DR_init_constraints_cookie::~DR_init_constraints_cookie() {
+ MOZ_COUNT_DTOR(DR_init_constraints_cookie);
+ ReflowInput::DisplayInitConstraintsExit(mFrame, mState, mValue);
+}
+
+DR_init_offsets_cookie::DR_init_offsets_cookie(
+ nsIFrame* aFrame, SizeComputationInput* aState, nscoord aPercentBasis,
+ WritingMode aCBWritingMode,
+ const mozilla::Maybe<mozilla::LogicalMargin> aBorder,
+ const mozilla::Maybe<mozilla::LogicalMargin> aPadding)
+ : mFrame(aFrame), mState(aState) {
+ MOZ_COUNT_CTOR(DR_init_offsets_cookie);
+ nsMargin border;
+ if (aBorder) {
+ border = aBorder->GetPhysicalMargin(aFrame->GetWritingMode());
+ }
+ nsMargin padding;
+ if (aPadding) {
+ padding = aPadding->GetPhysicalMargin(aFrame->GetWritingMode());
+ }
+ mValue = SizeComputationInput::DisplayInitOffsetsEnter(
+ mFrame, mState, aPercentBasis, aCBWritingMode,
+ aBorder ? &border : nullptr, aPadding ? &padding : nullptr);
+}
+
+DR_init_offsets_cookie::~DR_init_offsets_cookie() {
+ MOZ_COUNT_DTOR(DR_init_offsets_cookie);
+ SizeComputationInput::DisplayInitOffsetsExit(mFrame, mState, mValue);
+}
+
+struct DR_Rule;
+
+struct DR_FrameTypeInfo {
+ DR_FrameTypeInfo(LayoutFrameType aFrameType, const char* aFrameNameAbbrev,
+ const char* aFrameName);
+ ~DR_FrameTypeInfo();
+
+ LayoutFrameType mType;
+ char mNameAbbrev[16];
+ char mName[32];
+ nsTArray<DR_Rule*> mRules;
+
+ private:
+ DR_FrameTypeInfo& operator=(const DR_FrameTypeInfo&) = delete;
+};
+
+struct DR_FrameTreeNode;
+struct DR_Rule;
+
+struct DR_State {
+ DR_State();
+ ~DR_State();
+ void Init();
+ void AddFrameTypeInfo(LayoutFrameType aFrameType,
+ const char* aFrameNameAbbrev, const char* aFrameName);
+ DR_FrameTypeInfo* GetFrameTypeInfo(LayoutFrameType aFrameType);
+ DR_FrameTypeInfo* GetFrameTypeInfo(char* aFrameName);
+ void InitFrameTypeTable();
+ DR_FrameTreeNode* CreateTreeNode(nsIFrame* aFrame,
+ const ReflowInput* aReflowInput);
+ void FindMatchingRule(DR_FrameTreeNode& aNode);
+ bool RuleMatches(DR_Rule& aRule, DR_FrameTreeNode& aNode);
+ bool GetToken(FILE* aFile, char* aBuf, size_t aBufSize);
+ DR_Rule* ParseRule(FILE* aFile);
+ void ParseRulesFile();
+ void AddRule(nsTArray<DR_Rule*>& aRules, DR_Rule& aRule);
+ bool IsWhiteSpace(int c);
+ bool GetNumber(char* aBuf, int32_t& aNumber);
+ void PrettyUC(nscoord aSize, char* aBuf, int aBufSize);
+ void PrintMargin(const char* tag, const nsMargin* aMargin);
+ void DisplayFrameTypeInfo(nsIFrame* aFrame, int32_t aIndent);
+ void DeleteTreeNode(DR_FrameTreeNode& aNode);
+
+ bool mInited;
+ bool mActive;
+ int32_t mCount;
+ int32_t mAssert;
+ int32_t mIndent;
+ bool mIndentUndisplayedFrames;
+ bool mDisplayPixelErrors;
+ nsTArray<DR_Rule*> mWildRules;
+ nsTArray<DR_FrameTypeInfo> mFrameTypeTable;
+ // reflow specific state
+ nsTArray<DR_FrameTreeNode*> mFrameTreeLeaves;
+};
+
+static DR_State* DR_state; // the one and only DR_State
+
+struct DR_RulePart {
+ explicit DR_RulePart(LayoutFrameType aFrameType)
+ : mFrameType(aFrameType), mNext(0) {}
+
+ void Destroy();
+
+ LayoutFrameType mFrameType;
+ DR_RulePart* mNext;
+};
+
+void DR_RulePart::Destroy() {
+ if (mNext) {
+ mNext->Destroy();
+ }
+ delete this;
+}
+
+struct DR_Rule {
+ DR_Rule() : mLength(0), mTarget(nullptr), mDisplay(false) {
+ MOZ_COUNT_CTOR(DR_Rule);
+ }
+ ~DR_Rule() {
+ if (mTarget) mTarget->Destroy();
+ MOZ_COUNT_DTOR(DR_Rule);
+ }
+ void AddPart(LayoutFrameType aFrameType);
+
+ uint32_t mLength;
+ DR_RulePart* mTarget;
+ bool mDisplay;
+};
+
+void DR_Rule::AddPart(LayoutFrameType aFrameType) {
+ DR_RulePart* newPart = new DR_RulePart(aFrameType);
+ newPart->mNext = mTarget;
+ mTarget = newPart;
+ mLength++;
+}
+
+DR_FrameTypeInfo::~DR_FrameTypeInfo() {
+ int32_t numElements;
+ numElements = mRules.Length();
+ for (int32_t i = numElements - 1; i >= 0; i--) {
+ delete mRules.ElementAt(i);
+ }
+}
+
+DR_FrameTypeInfo::DR_FrameTypeInfo(LayoutFrameType aFrameType,
+ const char* aFrameNameAbbrev,
+ const char* aFrameName) {
+ mType = aFrameType;
+ PL_strncpyz(mNameAbbrev, aFrameNameAbbrev, sizeof(mNameAbbrev));
+ PL_strncpyz(mName, aFrameName, sizeof(mName));
+}
+
+struct DR_FrameTreeNode {
+ DR_FrameTreeNode(nsIFrame* aFrame, DR_FrameTreeNode* aParent)
+ : mFrame(aFrame), mParent(aParent), mDisplay(0), mIndent(0) {
+ MOZ_COUNT_CTOR(DR_FrameTreeNode);
+ }
+
+ MOZ_COUNTED_DTOR(DR_FrameTreeNode)
+
+ nsIFrame* mFrame;
+ DR_FrameTreeNode* mParent;
+ bool mDisplay;
+ uint32_t mIndent;
+};
+
+// DR_State implementation
+
+DR_State::DR_State()
+ : mInited(false),
+ mActive(false),
+ mCount(0),
+ mAssert(-1),
+ mIndent(0),
+ mIndentUndisplayedFrames(false),
+ mDisplayPixelErrors(false) {
+ MOZ_COUNT_CTOR(DR_State);
+}
+
+void DR_State::Init() {
+ char* env = PR_GetEnv("GECKO_DISPLAY_REFLOW_ASSERT");
+ int32_t num;
+ if (env) {
+ if (GetNumber(env, num))
+ mAssert = num;
+ else
+ printf("GECKO_DISPLAY_REFLOW_ASSERT - invalid value = %s", env);
+ }
+
+ env = PR_GetEnv("GECKO_DISPLAY_REFLOW_INDENT_START");
+ if (env) {
+ if (GetNumber(env, num))
+ mIndent = num;
+ else
+ printf("GECKO_DISPLAY_REFLOW_INDENT_START - invalid value = %s", env);
+ }
+
+ env = PR_GetEnv("GECKO_DISPLAY_REFLOW_INDENT_UNDISPLAYED_FRAMES");
+ if (env) {
+ if (GetNumber(env, num))
+ mIndentUndisplayedFrames = num;
+ else
+ printf(
+ "GECKO_DISPLAY_REFLOW_INDENT_UNDISPLAYED_FRAMES - invalid value = %s",
+ env);
+ }
+
+ env = PR_GetEnv("GECKO_DISPLAY_REFLOW_FLAG_PIXEL_ERRORS");
+ if (env) {
+ if (GetNumber(env, num))
+ mDisplayPixelErrors = num;
+ else
+ printf("GECKO_DISPLAY_REFLOW_FLAG_PIXEL_ERRORS - invalid value = %s",
+ env);
+ }
+
+ InitFrameTypeTable();
+ ParseRulesFile();
+ mInited = true;
+}
+
+DR_State::~DR_State() {
+ MOZ_COUNT_DTOR(DR_State);
+ int32_t numElements, i;
+ numElements = mWildRules.Length();
+ for (i = numElements - 1; i >= 0; i--) {
+ delete mWildRules.ElementAt(i);
+ }
+ numElements = mFrameTreeLeaves.Length();
+ for (i = numElements - 1; i >= 0; i--) {
+ delete mFrameTreeLeaves.ElementAt(i);
+ }
+}
+
+bool DR_State::GetNumber(char* aBuf, int32_t& aNumber) {
+ if (sscanf(aBuf, "%d", &aNumber) > 0)
+ return true;
+ else
+ return false;
+}
+
+bool DR_State::IsWhiteSpace(int c) {
+ return (c == ' ') || (c == '\t') || (c == '\n') || (c == '\r');
+}
+
+bool DR_State::GetToken(FILE* aFile, char* aBuf, size_t aBufSize) {
+ bool haveToken = false;
+ aBuf[0] = 0;
+ // get the 1st non whitespace char
+ int c = -1;
+ for (c = getc(aFile); (c > 0) && IsWhiteSpace(c); c = getc(aFile)) {
+ }
+
+ if (c > 0) {
+ haveToken = true;
+ aBuf[0] = c;
+ // get everything up to the next whitespace char
+ size_t cX;
+ for (cX = 1; cX + 1 < aBufSize; cX++) {
+ c = getc(aFile);
+ if (c < 0) { // EOF
+ ungetc(' ', aFile);
+ break;
+ } else {
+ if (IsWhiteSpace(c)) {
+ break;
+ } else {
+ aBuf[cX] = c;
+ }
+ }
+ }
+ aBuf[cX] = 0;
+ }
+ return haveToken;
+}
+
+DR_Rule* DR_State::ParseRule(FILE* aFile) {
+ char buf[128];
+ int32_t doDisplay;
+ DR_Rule* rule = nullptr;
+ while (GetToken(aFile, buf, sizeof(buf))) {
+ if (GetNumber(buf, doDisplay)) {
+ if (rule) {
+ rule->mDisplay = !!doDisplay;
+ break;
+ } else {
+ printf("unexpected token - %s \n", buf);
+ }
+ } else {
+ if (!rule) {
+ rule = new DR_Rule;
+ }
+ if (strcmp(buf, "*") == 0) {
+ rule->AddPart(LayoutFrameType::None);
+ } else {
+ DR_FrameTypeInfo* info = GetFrameTypeInfo(buf);
+ if (info) {
+ rule->AddPart(info->mType);
+ } else {
+ printf("invalid frame type - %s \n", buf);
+ }
+ }
+ }
+ }
+ return rule;
+}
+
+void DR_State::AddRule(nsTArray<DR_Rule*>& aRules, DR_Rule& aRule) {
+ int32_t numRules = aRules.Length();
+ for (int32_t ruleX = 0; ruleX < numRules; ruleX++) {
+ DR_Rule* rule = aRules.ElementAt(ruleX);
+ NS_ASSERTION(rule, "program error");
+ if (aRule.mLength > rule->mLength) {
+ aRules.InsertElementAt(ruleX, &aRule);
+ return;
+ }
+ }
+ aRules.AppendElement(&aRule);
+}
+
+static Maybe<bool> ShouldLogReflow(const char* processes) {
+ switch (processes[0]) {
+ case 'A':
+ case 'a':
+ return Some(true);
+ case 'P':
+ case 'p':
+ return Some(XRE_IsParentProcess());
+ case 'C':
+ case 'c':
+ return Some(XRE_IsContentProcess());
+ default:
+ return Nothing{};
+ }
+}
+
+void DR_State::ParseRulesFile() {
+ char* processes = PR_GetEnv("GECKO_DISPLAY_REFLOW_PROCESSES");
+ if (processes) {
+ Maybe<bool> enableLog = ShouldLogReflow(processes);
+ if (enableLog.isNothing()) {
+ MOZ_CRASH("GECKO_DISPLAY_REFLOW_PROCESSES: [a]ll [p]arent [c]ontent");
+ } else if (enableLog.value()) {
+ DR_Rule* rule = new DR_Rule;
+ rule->AddPart(LayoutFrameType::None);
+ rule->mDisplay = true;
+ AddRule(mWildRules, *rule);
+ mActive = true;
+ }
+ return;
+ }
+
+ char* path = PR_GetEnv("GECKO_DISPLAY_REFLOW_RULES_FILE");
+ if (path) {
+ FILE* inFile = fopen(path, "r");
+ if (!inFile) {
+ MOZ_CRASH(
+ "Failed to open the specified rules file; Try `--setpref "
+ "security.sandbox.content.level=2` if the sandbox is at cause");
+ }
+ for (DR_Rule* rule = ParseRule(inFile); rule; rule = ParseRule(inFile)) {
+ if (rule->mTarget) {
+ LayoutFrameType fType = rule->mTarget->mFrameType;
+ if (fType != LayoutFrameType::None) {
+ DR_FrameTypeInfo* info = GetFrameTypeInfo(fType);
+ AddRule(info->mRules, *rule);
+ } else {
+ AddRule(mWildRules, *rule);
+ }
+ mActive = true;
+ }
+ }
+
+ fclose(inFile);
+ }
+}
+
+void DR_State::AddFrameTypeInfo(LayoutFrameType aFrameType,
+ const char* aFrameNameAbbrev,
+ const char* aFrameName) {
+ mFrameTypeTable.EmplaceBack(aFrameType, aFrameNameAbbrev, aFrameName);
+}
+
+DR_FrameTypeInfo* DR_State::GetFrameTypeInfo(LayoutFrameType aFrameType) {
+ int32_t numEntries = mFrameTypeTable.Length();
+ NS_ASSERTION(numEntries != 0, "empty FrameTypeTable");
+ for (int32_t i = 0; i < numEntries; i++) {
+ DR_FrameTypeInfo& info = mFrameTypeTable.ElementAt(i);
+ if (info.mType == aFrameType) {
+ return &info;
+ }
+ }
+ return &mFrameTypeTable.ElementAt(numEntries -
+ 1); // return unknown frame type
+}
+
+DR_FrameTypeInfo* DR_State::GetFrameTypeInfo(char* aFrameName) {
+ int32_t numEntries = mFrameTypeTable.Length();
+ NS_ASSERTION(numEntries != 0, "empty FrameTypeTable");
+ for (int32_t i = 0; i < numEntries; i++) {
+ DR_FrameTypeInfo& info = mFrameTypeTable.ElementAt(i);
+ if ((strcmp(aFrameName, info.mName) == 0) ||
+ (strcmp(aFrameName, info.mNameAbbrev) == 0)) {
+ return &info;
+ }
+ }
+ return &mFrameTypeTable.ElementAt(numEntries -
+ 1); // return unknown frame type
+}
+
+void DR_State::InitFrameTypeTable() {
+ AddFrameTypeInfo(LayoutFrameType::Block, "block", "block");
+ AddFrameTypeInfo(LayoutFrameType::Br, "br", "br");
+ AddFrameTypeInfo(LayoutFrameType::ColorControl, "color", "colorControl");
+ AddFrameTypeInfo(LayoutFrameType::GfxButtonControl, "button",
+ "gfxButtonControl");
+ AddFrameTypeInfo(LayoutFrameType::HTMLButtonControl, "HTMLbutton",
+ "HTMLButtonControl");
+ AddFrameTypeInfo(LayoutFrameType::HTMLCanvas, "HTMLCanvas", "HTMLCanvas");
+ AddFrameTypeInfo(LayoutFrameType::SubDocument, "subdoc", "subDocument");
+ AddFrameTypeInfo(LayoutFrameType::Image, "img", "image");
+ AddFrameTypeInfo(LayoutFrameType::Inline, "inline", "inline");
+ AddFrameTypeInfo(LayoutFrameType::Letter, "letter", "letter");
+ AddFrameTypeInfo(LayoutFrameType::Line, "line", "line");
+ AddFrameTypeInfo(LayoutFrameType::ListControl, "select", "select");
+ AddFrameTypeInfo(LayoutFrameType::Page, "page", "page");
+ AddFrameTypeInfo(LayoutFrameType::Placeholder, "place", "placeholder");
+ AddFrameTypeInfo(LayoutFrameType::Canvas, "canvas", "canvas");
+ AddFrameTypeInfo(LayoutFrameType::Scroll, "scroll", "scroll");
+ AddFrameTypeInfo(LayoutFrameType::TableCell, "cell", "tableCell");
+ AddFrameTypeInfo(LayoutFrameType::TableCol, "col", "tableCol");
+ AddFrameTypeInfo(LayoutFrameType::TableColGroup, "colG", "tableColGroup");
+ AddFrameTypeInfo(LayoutFrameType::Table, "tbl", "table");
+ AddFrameTypeInfo(LayoutFrameType::TableWrapper, "tblW", "tableWrapper");
+ AddFrameTypeInfo(LayoutFrameType::TableRowGroup, "rowG", "tableRowGroup");
+ AddFrameTypeInfo(LayoutFrameType::TableRow, "row", "tableRow");
+ AddFrameTypeInfo(LayoutFrameType::TextInput, "textCtl", "textInput");
+ AddFrameTypeInfo(LayoutFrameType::Text, "text", "text");
+ AddFrameTypeInfo(LayoutFrameType::Viewport, "VP", "viewport");
+ AddFrameTypeInfo(LayoutFrameType::Slider, "Slider", "Slider");
+ AddFrameTypeInfo(LayoutFrameType::None, "unknown", "unknown");
+}
+
+void DR_State::DisplayFrameTypeInfo(nsIFrame* aFrame, int32_t aIndent) {
+ DR_FrameTypeInfo* frameTypeInfo = GetFrameTypeInfo(aFrame->Type());
+ if (frameTypeInfo) {
+ for (int32_t i = 0; i < aIndent; i++) {
+ printf(" ");
+ }
+ if (!strcmp(frameTypeInfo->mNameAbbrev, "unknown")) {
+ if (aFrame) {
+ nsAutoString name;
+ aFrame->GetFrameName(name);
+ printf("%s %p ", NS_LossyConvertUTF16toASCII(name).get(),
+ (void*)aFrame);
+ } else {
+ printf("%s %p ", frameTypeInfo->mNameAbbrev, (void*)aFrame);
+ }
+ } else {
+ printf("%s %p ", frameTypeInfo->mNameAbbrev, (void*)aFrame);
+ }
+ }
+}
+
+bool DR_State::RuleMatches(DR_Rule& aRule, DR_FrameTreeNode& aNode) {
+ NS_ASSERTION(aRule.mTarget, "program error");
+
+ DR_RulePart* rulePart;
+ DR_FrameTreeNode* parentNode;
+ for (rulePart = aRule.mTarget->mNext, parentNode = aNode.mParent;
+ rulePart && parentNode;
+ rulePart = rulePart->mNext, parentNode = parentNode->mParent) {
+ if (rulePart->mFrameType != LayoutFrameType::None) {
+ if (parentNode->mFrame) {
+ if (rulePart->mFrameType != parentNode->mFrame->Type()) {
+ return false;
+ }
+ } else
+ NS_ASSERTION(false, "program error");
+ }
+ // else wild card match
+ }
+ return true;
+}
+
+void DR_State::FindMatchingRule(DR_FrameTreeNode& aNode) {
+ if (!aNode.mFrame) {
+ NS_ASSERTION(false, "invalid DR_FrameTreeNode \n");
+ return;
+ }
+
+ bool matchingRule = false;
+
+ DR_FrameTypeInfo* info = GetFrameTypeInfo(aNode.mFrame->Type());
+ NS_ASSERTION(info, "program error");
+ int32_t numRules = info->mRules.Length();
+ for (int32_t ruleX = 0; ruleX < numRules; ruleX++) {
+ DR_Rule* rule = info->mRules.ElementAt(ruleX);
+ if (rule && RuleMatches(*rule, aNode)) {
+ aNode.mDisplay = rule->mDisplay;
+ matchingRule = true;
+ break;
+ }
+ }
+ if (!matchingRule) {
+ int32_t numWildRules = mWildRules.Length();
+ for (int32_t ruleX = 0; ruleX < numWildRules; ruleX++) {
+ DR_Rule* rule = mWildRules.ElementAt(ruleX);
+ if (rule && RuleMatches(*rule, aNode)) {
+ aNode.mDisplay = rule->mDisplay;
+ break;
+ }
+ }
+ }
+}
+
+DR_FrameTreeNode* DR_State::CreateTreeNode(nsIFrame* aFrame,
+ const ReflowInput* aReflowInput) {
+ // find the frame of the parent reflow input (usually just the parent of
+ // aFrame)
+ nsIFrame* parentFrame;
+ if (aReflowInput) {
+ const ReflowInput* parentRI = aReflowInput->mParentReflowInput;
+ parentFrame = (parentRI) ? parentRI->mFrame : nullptr;
+ } else {
+ parentFrame = aFrame->GetParent();
+ }
+
+ // find the parent tree node leaf
+ DR_FrameTreeNode* parentNode = nullptr;
+
+ DR_FrameTreeNode* lastLeaf = nullptr;
+ if (mFrameTreeLeaves.Length())
+ lastLeaf = mFrameTreeLeaves.ElementAt(mFrameTreeLeaves.Length() - 1);
+ if (lastLeaf) {
+ for (parentNode = lastLeaf;
+ parentNode && (parentNode->mFrame != parentFrame);
+ parentNode = parentNode->mParent) {
+ }
+ }
+ DR_FrameTreeNode* newNode = new DR_FrameTreeNode(aFrame, parentNode);
+ FindMatchingRule(*newNode);
+
+ newNode->mIndent = mIndent;
+ if (newNode->mDisplay || mIndentUndisplayedFrames) {
+ ++mIndent;
+ }
+
+ if (lastLeaf && (lastLeaf == parentNode)) {
+ mFrameTreeLeaves.RemoveLastElement();
+ }
+ mFrameTreeLeaves.AppendElement(newNode);
+ mCount++;
+
+ return newNode;
+}
+
+void DR_State::PrettyUC(nscoord aSize, char* aBuf, int aBufSize) {
+ if (NS_UNCONSTRAINEDSIZE == aSize) {
+ strcpy(aBuf, "UC");
+ } else {
+ if ((nscoord)0xdeadbeefU == aSize) {
+ strcpy(aBuf, "deadbeef");
+ } else {
+ snprintf(aBuf, aBufSize, "%d", aSize);
+ }
+ }
+}
+
+void DR_State::PrintMargin(const char* tag, const nsMargin* aMargin) {
+ if (aMargin) {
+ char t[16], r[16], b[16], l[16];
+ PrettyUC(aMargin->top, t, 16);
+ PrettyUC(aMargin->right, r, 16);
+ PrettyUC(aMargin->bottom, b, 16);
+ PrettyUC(aMargin->left, l, 16);
+ printf(" %s=%s,%s,%s,%s", tag, t, r, b, l);
+ } else {
+ // use %p here for consistency with other null-pointer printouts
+ printf(" %s=%p", tag, (void*)aMargin);
+ }
+}
+
+void DR_State::DeleteTreeNode(DR_FrameTreeNode& aNode) {
+ mFrameTreeLeaves.RemoveElement(&aNode);
+ int32_t numLeaves = mFrameTreeLeaves.Length();
+ if ((0 == numLeaves) ||
+ (aNode.mParent != mFrameTreeLeaves.ElementAt(numLeaves - 1))) {
+ mFrameTreeLeaves.AppendElement(aNode.mParent);
+ }
+
+ if (aNode.mDisplay || mIndentUndisplayedFrames) {
+ --mIndent;
+ }
+ // delete the tree node
+ delete &aNode;
+}
+
+static void CheckPixelError(nscoord aSize, int32_t aPixelToTwips) {
+ if (NS_UNCONSTRAINEDSIZE != aSize) {
+ if ((aSize % aPixelToTwips) > 0) {
+ printf("VALUE %d is not a whole pixel \n", aSize);
+ }
+ }
+}
+
+static void DisplayReflowEnterPrint(nsPresContext* aPresContext,
+ nsIFrame* aFrame,
+ const ReflowInput& aReflowInput,
+ DR_FrameTreeNode& aTreeNode,
+ bool aChanged) {
+ if (aTreeNode.mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, aTreeNode.mIndent);
+
+ char width[16];
+ char height[16];
+
+ DR_state->PrettyUC(aReflowInput.AvailableWidth(), width, 16);
+ DR_state->PrettyUC(aReflowInput.AvailableHeight(), height, 16);
+ printf("Reflow a=%s,%s ", width, height);
+
+ DR_state->PrettyUC(aReflowInput.ComputedWidth(), width, 16);
+ DR_state->PrettyUC(aReflowInput.ComputedHeight(), height, 16);
+ printf("c=%s,%s ", width, height);
+
+ if (aFrame->HasAnyStateBits(NS_FRAME_IS_DIRTY)) printf("dirty ");
+
+ if (aFrame->HasAnyStateBits(NS_FRAME_HAS_DIRTY_CHILDREN))
+ printf("dirty-children ");
+
+ if (aReflowInput.mFlags.mSpecialBSizeReflow) printf("special-bsize ");
+
+ if (aReflowInput.IsHResize()) printf("h-resize ");
+
+ if (aReflowInput.IsVResize()) printf("v-resize ");
+
+ nsIFrame* inFlow = aFrame->GetPrevInFlow();
+ if (inFlow) {
+ printf("pif=%p ", (void*)inFlow);
+ }
+ inFlow = aFrame->GetNextInFlow();
+ if (inFlow) {
+ printf("nif=%p ", (void*)inFlow);
+ }
+ if (aChanged)
+ printf("CHANGED \n");
+ else
+ printf("cnt=%d \n", DR_state->mCount);
+ if (DR_state->mDisplayPixelErrors) {
+ int32_t d2a = aPresContext->AppUnitsPerDevPixel();
+ CheckPixelError(aReflowInput.AvailableWidth(), d2a);
+ CheckPixelError(aReflowInput.AvailableHeight(), d2a);
+ CheckPixelError(aReflowInput.ComputedWidth(), d2a);
+ CheckPixelError(aReflowInput.ComputedHeight(), d2a);
+ }
+ }
+}
+
+void* nsIFrame::DisplayReflowEnter(nsPresContext* aPresContext,
+ nsIFrame* aFrame,
+ const ReflowInput& aReflowInput) {
+ if (!DR_state->mInited) DR_state->Init();
+ if (!DR_state->mActive) return nullptr;
+
+ NS_ASSERTION(aFrame, "invalid call");
+
+ DR_FrameTreeNode* treeNode = DR_state->CreateTreeNode(aFrame, &aReflowInput);
+ if (treeNode) {
+ DisplayReflowEnterPrint(aPresContext, aFrame, aReflowInput, *treeNode,
+ false);
+ }
+ return treeNode;
+}
+
+void* nsIFrame::DisplayLayoutEnter(nsIFrame* aFrame) {
+ if (!DR_state->mInited) DR_state->Init();
+ if (!DR_state->mActive) return nullptr;
+
+ NS_ASSERTION(aFrame, "invalid call");
+
+ DR_FrameTreeNode* treeNode = DR_state->CreateTreeNode(aFrame, nullptr);
+ if (treeNode && treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ printf("XULLayout\n");
+ }
+ return treeNode;
+}
+
+void* nsIFrame::DisplayIntrinsicISizeEnter(nsIFrame* aFrame,
+ const char* aType) {
+ if (!DR_state->mInited) DR_state->Init();
+ if (!DR_state->mActive) return nullptr;
+
+ NS_ASSERTION(aFrame, "invalid call");
+
+ DR_FrameTreeNode* treeNode = DR_state->CreateTreeNode(aFrame, nullptr);
+ if (treeNode && treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ printf("Get%sISize\n", aType);
+ }
+ return treeNode;
+}
+
+void* nsIFrame::DisplayIntrinsicSizeEnter(nsIFrame* aFrame, const char* aType) {
+ if (!DR_state->mInited) DR_state->Init();
+ if (!DR_state->mActive) return nullptr;
+
+ NS_ASSERTION(aFrame, "invalid call");
+
+ DR_FrameTreeNode* treeNode = DR_state->CreateTreeNode(aFrame, nullptr);
+ if (treeNode && treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ printf("Get%sSize\n", aType);
+ }
+ return treeNode;
+}
+
+void nsIFrame::DisplayReflowExit(nsPresContext* aPresContext, nsIFrame* aFrame,
+ ReflowOutput& aMetrics,
+ const nsReflowStatus& aStatus,
+ void* aFrameTreeNode) {
+ if (!DR_state->mActive) return;
+
+ NS_ASSERTION(aFrame, "DisplayReflowExit - invalid call");
+ if (!aFrameTreeNode) return;
+
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)aFrameTreeNode;
+ if (treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+
+ char width[16];
+ char height[16];
+ char x[16];
+ char y[16];
+ DR_state->PrettyUC(aMetrics.Width(), width, 16);
+ DR_state->PrettyUC(aMetrics.Height(), height, 16);
+ printf("Reflow d=%s,%s", width, height);
+
+ if (!aStatus.IsEmpty()) {
+ printf(" status=%s", ToString(aStatus).c_str());
+ }
+ if (aFrame->HasOverflowAreas()) {
+ DR_state->PrettyUC(aMetrics.InkOverflow().x, x, 16);
+ DR_state->PrettyUC(aMetrics.InkOverflow().y, y, 16);
+ DR_state->PrettyUC(aMetrics.InkOverflow().width, width, 16);
+ DR_state->PrettyUC(aMetrics.InkOverflow().height, height, 16);
+ printf(" vis-o=(%s,%s) %s x %s", x, y, width, height);
+
+ nsRect storedOverflow = aFrame->InkOverflowRect();
+ DR_state->PrettyUC(storedOverflow.x, x, 16);
+ DR_state->PrettyUC(storedOverflow.y, y, 16);
+ DR_state->PrettyUC(storedOverflow.width, width, 16);
+ DR_state->PrettyUC(storedOverflow.height, height, 16);
+ printf(" vis-sto=(%s,%s) %s x %s", x, y, width, height);
+
+ DR_state->PrettyUC(aMetrics.ScrollableOverflow().x, x, 16);
+ DR_state->PrettyUC(aMetrics.ScrollableOverflow().y, y, 16);
+ DR_state->PrettyUC(aMetrics.ScrollableOverflow().width, width, 16);
+ DR_state->PrettyUC(aMetrics.ScrollableOverflow().height, height, 16);
+ printf(" scr-o=(%s,%s) %s x %s", x, y, width, height);
+
+ storedOverflow = aFrame->ScrollableOverflowRect();
+ DR_state->PrettyUC(storedOverflow.x, x, 16);
+ DR_state->PrettyUC(storedOverflow.y, y, 16);
+ DR_state->PrettyUC(storedOverflow.width, width, 16);
+ DR_state->PrettyUC(storedOverflow.height, height, 16);
+ printf(" scr-sto=(%s,%s) %s x %s", x, y, width, height);
+ }
+ printf("\n");
+ if (DR_state->mDisplayPixelErrors) {
+ int32_t d2a = aPresContext->AppUnitsPerDevPixel();
+ CheckPixelError(aMetrics.Width(), d2a);
+ CheckPixelError(aMetrics.Height(), d2a);
+ }
+ }
+ DR_state->DeleteTreeNode(*treeNode);
+}
+
+void nsIFrame::DisplayLayoutExit(nsIFrame* aFrame, void* aFrameTreeNode) {
+ if (!DR_state->mActive) return;
+
+ NS_ASSERTION(aFrame, "non-null frame required");
+ if (!aFrameTreeNode) return;
+
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)aFrameTreeNode;
+ if (treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ nsRect rect = aFrame->GetRect();
+ printf("XULLayout=%d,%d,%d,%d\n", rect.x, rect.y, rect.width, rect.height);
+ }
+ DR_state->DeleteTreeNode(*treeNode);
+}
+
+void nsIFrame::DisplayIntrinsicISizeExit(nsIFrame* aFrame, const char* aType,
+ nscoord aResult,
+ void* aFrameTreeNode) {
+ if (!DR_state->mActive) return;
+
+ NS_ASSERTION(aFrame, "non-null frame required");
+ if (!aFrameTreeNode) return;
+
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)aFrameTreeNode;
+ if (treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ char iSize[16];
+ DR_state->PrettyUC(aResult, iSize, 16);
+ printf("Get%sISize=%s\n", aType, iSize);
+ }
+ DR_state->DeleteTreeNode(*treeNode);
+}
+
+void nsIFrame::DisplayIntrinsicSizeExit(nsIFrame* aFrame, const char* aType,
+ nsSize aResult, void* aFrameTreeNode) {
+ if (!DR_state->mActive) return;
+
+ NS_ASSERTION(aFrame, "non-null frame required");
+ if (!aFrameTreeNode) return;
+
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)aFrameTreeNode;
+ if (treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+
+ char width[16];
+ char height[16];
+ DR_state->PrettyUC(aResult.width, width, 16);
+ DR_state->PrettyUC(aResult.height, height, 16);
+ printf("Get%sSize=%s,%s\n", aType, width, height);
+ }
+ DR_state->DeleteTreeNode(*treeNode);
+}
+
+/* static */
+void nsIFrame::DisplayReflowStartup() { DR_state = new DR_State(); }
+
+/* static */
+void nsIFrame::DisplayReflowShutdown() {
+ delete DR_state;
+ DR_state = nullptr;
+}
+
+void DR_cookie::Change() const {
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)mValue;
+ if (treeNode && treeNode->mDisplay) {
+ DisplayReflowEnterPrint(mPresContext, mFrame, mReflowInput, *treeNode,
+ true);
+ }
+}
+
+/* static */
+void* ReflowInput::DisplayInitConstraintsEnter(nsIFrame* aFrame,
+ ReflowInput* aState,
+ nscoord aContainingBlockWidth,
+ nscoord aContainingBlockHeight,
+ const nsMargin* aBorder,
+ const nsMargin* aPadding) {
+ MOZ_ASSERT(aFrame, "non-null frame required");
+ MOZ_ASSERT(aState, "non-null state required");
+
+ if (!DR_state->mInited) DR_state->Init();
+ if (!DR_state->mActive) return nullptr;
+
+ DR_FrameTreeNode* treeNode = DR_state->CreateTreeNode(aFrame, aState);
+ if (treeNode && treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+
+ printf("InitConstraints parent=%p", (void*)aState->mParentReflowInput);
+
+ char width[16];
+ char height[16];
+
+ DR_state->PrettyUC(aContainingBlockWidth, width, 16);
+ DR_state->PrettyUC(aContainingBlockHeight, height, 16);
+ printf(" cb=%s,%s", width, height);
+
+ DR_state->PrettyUC(aState->AvailableWidth(), width, 16);
+ DR_state->PrettyUC(aState->AvailableHeight(), height, 16);
+ printf(" as=%s,%s", width, height);
+
+ DR_state->PrintMargin("b", aBorder);
+ DR_state->PrintMargin("p", aPadding);
+ putchar('\n');
+ }
+ return treeNode;
+}
+
+/* static */
+void ReflowInput::DisplayInitConstraintsExit(nsIFrame* aFrame,
+ ReflowInput* aState,
+ void* aValue) {
+ MOZ_ASSERT(aFrame, "non-null frame required");
+ MOZ_ASSERT(aState, "non-null state required");
+
+ if (!DR_state->mActive) return;
+ if (!aValue) return;
+
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)aValue;
+ if (treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ char cmiw[16], cw[16], cmxw[16], cmih[16], ch[16], cmxh[16];
+ DR_state->PrettyUC(aState->ComputedMinWidth(), cmiw, 16);
+ DR_state->PrettyUC(aState->ComputedWidth(), cw, 16);
+ DR_state->PrettyUC(aState->ComputedMaxWidth(), cmxw, 16);
+ DR_state->PrettyUC(aState->ComputedMinHeight(), cmih, 16);
+ DR_state->PrettyUC(aState->ComputedHeight(), ch, 16);
+ DR_state->PrettyUC(aState->ComputedMaxHeight(), cmxh, 16);
+ printf("InitConstraints= cw=(%s <= %s <= %s) ch=(%s <= %s <= %s)", cmiw, cw,
+ cmxw, cmih, ch, cmxh);
+ const nsMargin m = aState->ComputedPhysicalOffsets();
+ DR_state->PrintMargin("co", &m);
+ putchar('\n');
+ }
+ DR_state->DeleteTreeNode(*treeNode);
+}
+
+/* static */
+void* SizeComputationInput::DisplayInitOffsetsEnter(
+ nsIFrame* aFrame, SizeComputationInput* aState, nscoord aPercentBasis,
+ WritingMode aCBWritingMode, const nsMargin* aBorder,
+ const nsMargin* aPadding) {
+ MOZ_ASSERT(aFrame, "non-null frame required");
+ MOZ_ASSERT(aState, "non-null state required");
+
+ if (!DR_state->mInited) DR_state->Init();
+ if (!DR_state->mActive) return nullptr;
+
+ // aState is not necessarily a ReflowInput
+ DR_FrameTreeNode* treeNode = DR_state->CreateTreeNode(aFrame, nullptr);
+ if (treeNode && treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+
+ char pctBasisStr[16];
+ DR_state->PrettyUC(aPercentBasis, pctBasisStr, 16);
+ printf("InitOffsets pct_basis=%s", pctBasisStr);
+
+ DR_state->PrintMargin("b", aBorder);
+ DR_state->PrintMargin("p", aPadding);
+ putchar('\n');
+ }
+ return treeNode;
+}
+
+/* static */
+void SizeComputationInput::DisplayInitOffsetsExit(nsIFrame* aFrame,
+ SizeComputationInput* aState,
+ void* aValue) {
+ MOZ_ASSERT(aFrame, "non-null frame required");
+ MOZ_ASSERT(aState, "non-null state required");
+
+ if (!DR_state->mActive) return;
+ if (!aValue) return;
+
+ DR_FrameTreeNode* treeNode = (DR_FrameTreeNode*)aValue;
+ if (treeNode->mDisplay) {
+ DR_state->DisplayFrameTypeInfo(aFrame, treeNode->mIndent);
+ printf("InitOffsets=");
+ const auto m = aState->ComputedPhysicalMargin();
+ DR_state->PrintMargin("m", &m);
+ const auto p = aState->ComputedPhysicalPadding();
+ DR_state->PrintMargin("p", &p);
+ const auto bp = aState->ComputedPhysicalBorderPadding();
+ DR_state->PrintMargin("b+p", &bp);
+ putchar('\n');
+ }
+ DR_state->DeleteTreeNode(*treeNode);
+}
+
+// End Display Reflow
+
+// Validation of SideIsVertical.
+# define CASE(side, result) \
+ static_assert(SideIsVertical(side) == result, "SideIsVertical is wrong")
+CASE(eSideTop, false);
+CASE(eSideRight, true);
+CASE(eSideBottom, false);
+CASE(eSideLeft, true);
+# undef CASE
+
+// Validation of HalfCornerIsX.
+# define CASE(corner, result) \
+ static_assert(HalfCornerIsX(corner) == result, "HalfCornerIsX is wrong")
+CASE(eCornerTopLeftX, true);
+CASE(eCornerTopLeftY, false);
+CASE(eCornerTopRightX, true);
+CASE(eCornerTopRightY, false);
+CASE(eCornerBottomRightX, true);
+CASE(eCornerBottomRightY, false);
+CASE(eCornerBottomLeftX, true);
+CASE(eCornerBottomLeftY, false);
+# undef CASE
+
+// Validation of HalfToFullCorner.
+# define CASE(corner, result) \
+ static_assert(HalfToFullCorner(corner) == result, \
+ "HalfToFullCorner is " \
+ "wrong")
+CASE(eCornerTopLeftX, eCornerTopLeft);
+CASE(eCornerTopLeftY, eCornerTopLeft);
+CASE(eCornerTopRightX, eCornerTopRight);
+CASE(eCornerTopRightY, eCornerTopRight);
+CASE(eCornerBottomRightX, eCornerBottomRight);
+CASE(eCornerBottomRightY, eCornerBottomRight);
+CASE(eCornerBottomLeftX, eCornerBottomLeft);
+CASE(eCornerBottomLeftY, eCornerBottomLeft);
+# undef CASE
+
+// Validation of FullToHalfCorner.
+# define CASE(corner, vert, result) \
+ static_assert(FullToHalfCorner(corner, vert) == result, \
+ "FullToHalfCorner is wrong")
+CASE(eCornerTopLeft, false, eCornerTopLeftX);
+CASE(eCornerTopLeft, true, eCornerTopLeftY);
+CASE(eCornerTopRight, false, eCornerTopRightX);
+CASE(eCornerTopRight, true, eCornerTopRightY);
+CASE(eCornerBottomRight, false, eCornerBottomRightX);
+CASE(eCornerBottomRight, true, eCornerBottomRightY);
+CASE(eCornerBottomLeft, false, eCornerBottomLeftX);
+CASE(eCornerBottomLeft, true, eCornerBottomLeftY);
+# undef CASE
+
+// Validation of SideToFullCorner.
+# define CASE(side, second, result) \
+ static_assert(SideToFullCorner(side, second) == result, \
+ "SideToFullCorner is wrong")
+CASE(eSideTop, false, eCornerTopLeft);
+CASE(eSideTop, true, eCornerTopRight);
+
+CASE(eSideRight, false, eCornerTopRight);
+CASE(eSideRight, true, eCornerBottomRight);
+
+CASE(eSideBottom, false, eCornerBottomRight);
+CASE(eSideBottom, true, eCornerBottomLeft);
+
+CASE(eSideLeft, false, eCornerBottomLeft);
+CASE(eSideLeft, true, eCornerTopLeft);
+# undef CASE
+
+// Validation of SideToHalfCorner.
+# define CASE(side, second, parallel, result) \
+ static_assert(SideToHalfCorner(side, second, parallel) == result, \
+ "SideToHalfCorner is wrong")
+CASE(eSideTop, false, true, eCornerTopLeftX);
+CASE(eSideTop, false, false, eCornerTopLeftY);
+CASE(eSideTop, true, true, eCornerTopRightX);
+CASE(eSideTop, true, false, eCornerTopRightY);
+
+CASE(eSideRight, false, false, eCornerTopRightX);
+CASE(eSideRight, false, true, eCornerTopRightY);
+CASE(eSideRight, true, false, eCornerBottomRightX);
+CASE(eSideRight, true, true, eCornerBottomRightY);
+
+CASE(eSideBottom, false, true, eCornerBottomRightX);
+CASE(eSideBottom, false, false, eCornerBottomRightY);
+CASE(eSideBottom, true, true, eCornerBottomLeftX);
+CASE(eSideBottom, true, false, eCornerBottomLeftY);
+
+CASE(eSideLeft, false, false, eCornerBottomLeftX);
+CASE(eSideLeft, false, true, eCornerBottomLeftY);
+CASE(eSideLeft, true, false, eCornerTopLeftX);
+CASE(eSideLeft, true, true, eCornerTopLeftY);
+# undef CASE
+
+#endif