layout/forms/nsRangeFrame.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   3 /* This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef nsRangeFrame_h___
   8 #define nsRangeFrame_h___
   9
  10 #include "mozilla/Attributes.h"
  11 #include "mozilla/Decimal.h"
  12 #include "mozilla/EventForwards.h"
  13 #include "nsContainerFrame.h"
  14 #include "nsIAnonymousContentCreator.h"
  15 #include "nsIDOMEventListener.h"
  16 #include "nsCOMPtr.h"
  17 #include "nsTArray.h"
  18
  19 class nsDisplayRangeFocusRing;
  20
  21 namespace mozilla {
  22 class ListMutationObserver;
  23 class PresShell;
  24 namespace dom {
  25 class Event;
  26 class HTMLInputElement;
  27 }  // namespace dom
  28 }  // namespace mozilla
  29
  30 class nsRangeFrame final : public nsContainerFrame,
  31                            public nsIAnonymousContentCreator {
  32   friend nsIFrame* NS_NewRangeFrame(mozilla::PresShell* aPresShell,
  33                                     ComputedStyle* aStyle);
  34
  35   void Init(nsIContent* aContent, nsContainerFrame* aParent,
  36             nsIFrame* aPrevInFlow) override;
  37
  38   friend class nsDisplayRangeFocusRing;
  39
  40   explicit nsRangeFrame(ComputedStyle* aStyle, nsPresContext* aPresContext);
  41   virtual ~nsRangeFrame();
  42
  43   typedef mozilla::PseudoStyleType PseudoStyleType;
  44   typedef mozilla::dom::Element Element;
  45
  46  public:
  47   NS_DECL_QUERYFRAME
  48   NS_DECL_FRAMEARENA_HELPERS(nsRangeFrame)
  49
  50   // nsIFrame overrides
  51   void Destroy(DestroyContext&) override;
  52
  53   void BuildDisplayList(nsDisplayListBuilder* aBuilder,
  54                         const nsDisplayListSet& aLists) override;
  55
  56   virtual void Reflow(nsPresContext* aPresContext, ReflowOutput& aDesiredSize,
  57                       const ReflowInput& aReflowInput,
  58                       nsReflowStatus& aStatus) override;
  59
  60 #ifdef DEBUG_FRAME_DUMP
  61   virtual nsresult GetFrameName(nsAString& aResult) const override {
  62     return MakeFrameName(u"Range"_ns, aResult);
  63   }
  64 #endif
  65
  66 #ifdef ACCESSIBILITY
  67   virtual mozilla::a11y::AccType AccessibleType() override;
  68 #endif
  69
  70   // nsIAnonymousContentCreator
  71   virtual nsresult CreateAnonymousContent(
  72       nsTArray<ContentInfo>& aElements) override;
  73   virtual void AppendAnonymousContentTo(nsTArray<nsIContent*>& aElements,
  74                                         uint32_t aFilter) override;
  75
  76   virtual nsresult AttributeChanged(int32_t aNameSpaceID, nsAtom* aAttribute,
  77                                     int32_t aModType) override;
  78
  79   mozilla::LogicalSize ComputeAutoSize(
  80       gfxContext* aRenderingContext, mozilla::WritingMode aWM,
  81       const mozilla::LogicalSize& aCBSize, nscoord aAvailableISize,
  82       const mozilla::LogicalSize& aMargin,
  83       const mozilla::LogicalSize& aBorderPadding,
  84       const mozilla::StyleSizeOverrides& aSizeOverrides,
  85       mozilla::ComputeSizeFlags aFlags) override;
  86
  87   virtual nscoord GetMinISize(gfxContext* aRenderingContext) override;
  88   virtual nscoord GetPrefISize(gfxContext* aRenderingContext) override;
  89
  90   virtual bool IsFrameOfType(uint32_t aFlags) const override {
  91     return nsContainerFrame::IsFrameOfType(
  92         aFlags & ~(nsIFrame::eReplaced | nsIFrame::eReplacedContainsBlock));
  93   }
  94
  95   /**
  96    * Returns true if the slider's thumb moves horizontally, or else false if it
  97    * moves vertically.
  98    */
  99   bool IsHorizontal() const;
 100
 101   /**
 102    * Returns true if the slider is oriented along the inline axis.
 103    */
 104   bool IsInlineOriented() const {
 105     return IsHorizontal() != GetWritingMode().IsVertical();
 106   }
 107
 108   /**
 109    * Returns true if the slider's thumb moves right-to-left for increasing
 110    * values; only relevant when IsHorizontal() is true.
 111    */
 112   bool IsRightToLeft() const {
 113     MOZ_ASSERT(IsHorizontal());
 114     return GetWritingMode().IsPhysicalRTL();
 115   }
 116
 117   /**
 118    * Returns true if the range progresses upwards (for vertical ranges in
 119    * horizontal writing mode, or for bidi-RTL in vertical mode). Only
 120    * relevant when IsHorizontal() is false.
 121    */
 122   bool IsUpwards() const {
 123     MOZ_ASSERT(!IsHorizontal());
 124     mozilla::WritingMode wm = GetWritingMode();
 125     return wm.GetBlockDir() == mozilla::WritingMode::eBlockTB ||
 126            wm.GetInlineDir() == mozilla::WritingMode::eInlineBTT;
 127   }
 128
 129   double GetMin() const;
 130   double GetMax() const;
 131   double GetValue() const;
 132
 133   /**
 134    * Returns the input element's value as a fraction of the difference between
 135    * the input's minimum and its maximum (i.e. returns 0.0 when the value is
 136    * the same as the minimum, and returns 1.0 when the value is the same as the
 137    * maximum).
 138    */
 139   double GetValueAsFractionOfRange();
 140
 141   /**
 142    * Returns the given value as a fraction of the difference between the input's
 143    * minimum and its maximum (i.e. returns 0.0 when the value is the same as the
 144    * input's minimum, and returns 1.0 when the value is the same as the input's
 145    * maximum).
 146    */
 147   double GetDoubleAsFractionOfRange(const mozilla::Decimal& value);
 148
 149   /**
 150    * Returns whether the frame and its child should use the native style.
 151    */
 152   bool ShouldUseNativeStyle() const;
 153
 154   mozilla::Decimal GetValueAtEventPoint(mozilla::WidgetGUIEvent* aEvent);
 155
 156   /**
 157    * Helper that's used when the value of the range changes to reposition the
 158    * thumb, resize the range-progress element, and schedule a repaint. (This
 159    * does not reflow, since the position and size of the thumb and
 160    * range-progress element do not affect the position or size of any other
 161    * frames.)
 162    */
 163   void UpdateForValueChange();
 164
 165   nsTArray<mozilla::Decimal> TickMarks();
 166
 167   /**
 168    * Returns the given value's offset from the range's nearest list tick mark
 169    * or NaN if there are no tick marks.
 170    */
 171   mozilla::Decimal NearestTickMark(const mozilla::Decimal& aValue);
 172
 173  protected:
 174   mozilla::dom::HTMLInputElement& InputElement() const;
 175
 176  private:
 177   // Return our preferred size in the cross-axis (the axis perpendicular
 178   // to the direction of movement of the thumb).
 179   nscoord AutoCrossSize(mozilla::Length aEm);
 180
 181   nsresult MakeAnonymousDiv(Element** aResult, PseudoStyleType aPseudoType,
 182                             nsTArray<ContentInfo>& aElements);
 183
 184   // Helper function which reflows the anonymous div frames.
 185   void ReflowAnonymousContent(nsPresContext* aPresContext,
 186                               ReflowOutput& aDesiredSize,
 187                               const ReflowInput& aReflowInput);
 188
 189   void DoUpdateThumbPosition(nsIFrame* aThumbFrame, const nsSize& aRangeSize);
 190
 191   void DoUpdateRangeProgressFrame(nsIFrame* aProgressFrame,
 192                                   const nsSize& aRangeSize);
 193
 194   /**
 195    * The div used to show the ::-moz-range-track pseudo-element.
 196    * @see nsRangeFrame::CreateAnonymousContent
 197    */
 198   nsCOMPtr<Element> mTrackDiv;
 199
 200   /**
 201    * The div used to show the ::-moz-range-progress pseudo-element, which is
 202    * used to (optionally) style the specific chunk of track leading up to the
 203    * thumb's current position.
 204    * @see nsRangeFrame::CreateAnonymousContent
 205    */
 206   nsCOMPtr<Element> mProgressDiv;
 207
 208   /**
 209    * The div used to show the ::-moz-range-thumb pseudo-element.
 210    * @see nsRangeFrame::CreateAnonymousContent
 211    */
 212   nsCOMPtr<Element> mThumbDiv;
 213
 214   /**
 215    * This mutation observer is used to invalidate paint when the @list changes,
 216    * when a @list exists.
 217    */
 218   RefPtr<mozilla::ListMutationObserver> mListMutationObserver;
 219 };
 220
 221 #endif