HTMLInputElement.h

mozilla-central/dom/html/HTMLInputElement.h (file symbol)

Enable keyboard shortcuts

Source code

Revision control

Copy as Markdown

Other Tools

/* -*- 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/. */

#ifndef mozilla_dom_HTMLInputElement_h

#define mozilla_dom_HTMLInputElement_h

#include "mozilla/Attributes.h"

#include "mozilla/Decimal.h"

#include "mozilla/Maybe.h"

#include "mozilla/TextControlElement.h"

#include "mozilla/TextControlState.h"

#include "mozilla/UniquePtr.h"

#include "mozilla/Variant.h"

#include "mozilla/dom/BindingDeclarations.h"

#include "mozilla/dom/HTMLInputElementBinding.h"

#include "mozilla/dom/Promise.h"

#include "mozilla/dom/UnionTypes.h"

#include "mozilla/dom/SingleLineTextInputTypes.h"

#include "mozilla/dom/NumericInputTypes.h"

#include "mozilla/dom/CheckableInputTypes.h"

#include "mozilla/dom/ButtonInputTypes.h"

#include "mozilla/dom/DateTimeInputTypes.h"

#include "mozilla/dom/ColorInputType.h"

#include "mozilla/dom/ConstraintValidation.h"

#include "mozilla/dom/FileInputType.h"

#include "mozilla/dom/HiddenInputType.h"

#include "mozilla/dom/RadioGroupContainer.h"

#include "nsGenericHTMLElement.h"

#include "nsImageLoadingContent.h"

#include "nsCOMPtr.h"

#include "nsIFilePicker.h"

#include "nsIContentPrefService2.h"

#include "nsContentUtils.h"

class nsIEditor;

class nsIRadioVisitor;

namespace mozilla {

class EventChainPostVisitor;

class EventChainPreVisitor;

namespace dom {

class AfterSetFilesOrDirectoriesRunnable;

class Date;

class DispatchChangeEventCallback;

class File;

class FileList;

class FileSystemEntry;

class FormData;

class GetFilesHelper;

class InputType;

/**

 * A class we use to create a singleton object that is used to keep track of

 * the last directory from which the user has picked files (via

 * <input type=file>) on a per-domain basis. The implementation uses

 * nsIContentPrefService2/NS_CONTENT_PREF_SERVICE_CONTRACTID to store the last

 * directory per-domain, and to ensure that whether the directories are

 * persistently saved (saved across sessions) or not honors whether or not the

 * page is being viewed in private browsing.

*/

class UploadLastDir final : public nsIObserver, public nsSupportsWeakReference {

  ~UploadLastDir() = default;

 public:

  NS_DECL_ISUPPORTS

  NS_DECL_NSIOBSERVER

/**

   * Fetch the last used directory for this location from the content

   * pref service, and display the file picker opened in that directory.

   * @param aDoc          current document

   * @param aFilePicker   the file picker to open

   * @param aFpCallback   the callback object to be run when the file is shown.

*/

  nsresult FetchDirectoryAndDisplayPicker(

      Document* aDoc, nsIFilePicker* aFilePicker,

      nsIFilePickerShownCallback* aFpCallback);

/**

   * Store the last used directory for this location using the

   * content pref service, if it is available

   * @param aURI URI of the current page

   * @param aDir Parent directory of the file(s)/directory chosen by the user

*/

  nsresult StoreLastUsedDirectory(Document* aDoc, nsIFile* aDir);

  class ContentPrefCallback final : public nsIContentPrefCallback2 {

    virtual ~ContentPrefCallback() = default;

   public:

    ContentPrefCallback(nsIFilePicker* aFilePicker,

                        nsIFilePickerShownCallback* aFpCallback)

        : mFilePicker(aFilePicker), mFpCallback(aFpCallback) {}

    NS_DECL_ISUPPORTS

    NS_DECL_NSICONTENTPREFCALLBACK2

    nsCOMPtr<nsIFilePicker> mFilePicker;

    nsCOMPtr<nsIFilePickerShownCallback> mFpCallback;

    nsCOMPtr<nsIContentPref> mResult;

};

};

class HTMLInputElement final : public TextControlElement,

                               public nsImageLoadingContent,

                               public ConstraintValidation {

  friend class AfterSetFilesOrDirectoriesCallback;

  friend class DispatchChangeEventCallback;

  friend class InputType;

 public:

  using ConstraintValidation::GetValidationMessage;

  using nsGenericHTMLFormControlElementWithState::GetForm;

  using nsGenericHTMLFormControlElementWithState::GetFormAction;

  using ValueSetterOption = TextControlState::ValueSetterOption;

  using ValueSetterOptions = TextControlState::ValueSetterOptions;

  enum class FromClone { No, Yes };

  HTMLInputElement(already_AddRefed<dom::NodeInfo>&& aNodeInfo,

                   FromParser aFromParser,

                   FromClone aFromClone = FromClone::No);

  NS_IMPL_FROMNODE_HTML_WITH_TAG(HTMLInputElement, input)

  // nsISupports

  NS_DECL_ISUPPORTS_INHERITED

  int32_t TabIndexDefault() override;

  using nsGenericHTMLElement::Focus;

  // nsINode

#if !defined(ANDROID) && !defined(XP_MACOSX)

  bool IsNodeApzAwareInternal() const override;

#endif

  // Element

  bool IsInteractiveHTMLContent() const override;

  // nsGenericHTMLElement

  bool IsDisabledForEvents(WidgetEvent* aEvent) override;

  // nsGenericHTMLFormElement

  void SaveState() override;

  MOZ_CAN_RUN_SCRIPT_BOUNDARY bool RestoreState(PresState* aState) override;

  // EventTarget

  void AsyncEventRunning(AsyncEventDispatcher* aEvent) override;

  // Overriden nsIFormControl methods

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  NS_IMETHOD Reset() override;

  NS_IMETHOD SubmitNamesValues(FormData* aFormData) override;

  void FieldSetDisabledChanged(bool aNotify) override;

  // nsIContent

  bool IsHTMLFocusable(IsFocusableFlags, bool* aIsFocusable,

                       int32_t* aTabIndex) override;

  bool ParseAttribute(int32_t aNamespaceID, nsAtom* aAttribute,

                      const nsAString& aValue,

                      nsIPrincipal* aMaybeScriptedPrincipal,

                      nsAttrValue& aResult) override;

  // Note: if this returns false, then attributes may not yet be sanitized

  // (per SetValueInternal's dependence on mDoneCreating).

  bool IsDoneCreating() const { return mDoneCreating; }

  bool LastValueChangeWasInteractive() const {

    return mLastValueChangeWasInteractive;

  void GetLastInteractiveValue(nsAString&);

  nsChangeHint GetAttributeChangeHint(const nsAtom* aAttribute,

                                      int32_t aModType) const override;

  NS_IMETHOD_(bool) IsAttributeMapped(const nsAtom* aAttribute) const override;

  nsMapRuleToAttributesFunc GetAttributeMappingFunction() const override;

  void GetEventTargetParent(EventChainPreVisitor& aVisitor) override;

  void LegacyPreActivationBehavior(EventChainVisitor& aVisitor) override;

  MOZ_CAN_RUN_SCRIPT

  void ActivationBehavior(EventChainPostVisitor& aVisitor) override;

  void LegacyCanceledActivationBehavior(

      EventChainPostVisitor& aVisitor) override;

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  nsresult PreHandleEvent(EventChainVisitor& aVisitor) override;

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  nsresult PostHandleEvent(EventChainPostVisitor& aVisitor) override;

  MOZ_CAN_RUN_SCRIPT

  nsresult MaybeHandleRadioButtonNavigation(EventChainPostVisitor&,

                                            uint32_t aKeyCode);

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  void PostHandleEventForRangeThumb(EventChainPostVisitor& aVisitor);

  MOZ_CAN_RUN_SCRIPT

  void StartRangeThumbDrag(WidgetGUIEvent* aEvent);

  MOZ_CAN_RUN_SCRIPT

  void FinishRangeThumbDrag(WidgetGUIEvent* aEvent = nullptr);

  MOZ_CAN_RUN_SCRIPT

  void CancelRangeThumbDrag(bool aIsForUserEvent = true);

  enum class SnapToTickMarks : bool { No, Yes };

  MOZ_CAN_RUN_SCRIPT

  void SetValueOfRangeForUserEvent(Decimal aValue,

                                   SnapToTickMarks = SnapToTickMarks::No);

  nsresult BindToTree(BindContext&, nsINode& aParent) override;

  void UnbindFromTree(UnbindContext&) override;

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  void DoneCreatingElement() override;

  void DestroyContent() override;

  void SetLastValueChangeWasInteractive(bool);

  // TextControlElement

  bool IsSingleLineTextControlOrTextArea() const override {

    return IsSingleLineTextControl(false);

  void SetValueChanged(bool aValueChanged) override;

  bool IsSingleLineTextControl() const override;

  bool IsTextArea() const override;

  bool IsPasswordTextControl() const override;

  Maybe<int32_t> GetCols() override;

  int32_t GetWrapCols() override;

  int32_t GetRows() override;

  void GetDefaultValueFromContent(nsAString& aValue, bool aForDisplay) override;

  bool ValueChanged() const override;

  void GetTextEditorValue(nsAString& aValue) const override;

  MOZ_CAN_RUN_SCRIPT TextEditor* GetTextEditor() override;

  TextEditor* GetTextEditorWithoutCreation() const override;

  nsISelectionController* GetSelectionController() override;

  nsFrameSelection* GetConstFrameSelection() override;

  TextControlState* GetTextControlState() const override {

    return GetEditorState();

  nsresult BindToFrame(nsTextControlFrame* aFrame) override;

  MOZ_CAN_RUN_SCRIPT void UnbindFromFrame(nsTextControlFrame* aFrame) override;

  MOZ_CAN_RUN_SCRIPT nsresult CreateEditor() override;

  void SetPreviewValue(const nsAString& aValue) override;

  void GetPreviewValue(nsAString& aValue) override;

  void SetAutofillState(const nsAString& aState) override {

    SetFormAutofillState(aState);

  void GetAutofillState(nsAString& aState) override {

    GetFormAutofillState(aState);

  void EnablePreview() override;

  bool IsPreviewEnabled() override;

  void InitializeKeyboardEventListeners() override;

  void OnValueChanged(ValueChangeKind, bool aNewValueEmpty,

                      const nsAString* aKnownNewValue) override;

  void GetValueFromSetRangeText(nsAString& aValue) override;

  MOZ_CAN_RUN_SCRIPT nsresult

  SetValueFromSetRangeText(const nsAString& aValue) override;

  bool HasCachedSelection() override;

  MOZ_CAN_RUN_SCRIPT void SetRevealPassword(bool aValue);

  bool RevealPassword() const;

  // Methods for nsFormFillController so it can do selection operations on input

  // types the HTML spec doesn't support them on, like "email".

  uint32_t GetSelectionStartIgnoringType(ErrorResult& aRv);

  uint32_t GetSelectionEndIgnoringType(ErrorResult& aRv);

  void GetDisplayFileName(nsAString& aFileName) const;

  const nsTArray<OwningFileOrDirectory>& GetFilesOrDirectoriesInternal() const;

  void SetFilesOrDirectories(

      const nsTArray<OwningFileOrDirectory>& aFilesOrDirectories,

      bool aSetValueChanged);

  void SetFiles(FileList* aFiles, bool aSetValueChanged);

  // This method is used for test only. Onces the data is set, a 'change' event

  // is dispatched.

  void MozSetDndFilesAndDirectories(

      const nsTArray<OwningFileOrDirectory>& aSequence);

  // Called when a nsIFilePicker or a nsIColorPicker terminate.

  void PickerClosed();

  void SetCheckedChangedInternal(bool aCheckedChanged);

  bool GetCheckedChanged() const { return mCheckedChanged; }

  void AddToRadioGroup();

  void RemoveFromRadioGroup();

  void DisconnectRadioGroupContainer();

/**

   * Helper function returning the currently selected button in the radio group.

   * Returning null if the element is not a button or if there is no selectied

   * button in the group.

   * @return the selected button (or null).

*/

  HTMLInputElement* GetSelectedRadioButton() const;

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  nsresult Clone(dom::NodeInfo*, nsINode** aResult) const override;

  NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(HTMLInputElement, TextControlElement)

  static UploadLastDir* gUploadLastDir;

  // create and destroy the static UploadLastDir object for remembering

  // which directory was last used on a site-by-site basis

  static void InitUploadLastDir();

  static void DestroyUploadLastDir();

  // If the valueAsDate attribute should be enabled in webIDL

  static bool ValueAsDateEnabled(JSContext* cx, JSObject* obj);

  void MaybeLoadImage();

  bool HasPatternAttribute() const { return mHasPatternAttribute; }

  // nsIConstraintValidation

  bool IsTooLong();

  bool IsTooShort();

  bool IsValueMissing() const;

  bool HasTypeMismatch() const;

  Maybe<bool> HasPatternMismatch() const;

  bool IsRangeOverflow() const;

  bool IsRangeUnderflow() const;

  bool ValueIsStepMismatch(const Decimal& aValue) const;

  bool HasStepMismatch() const;

  bool HasBadInput() const;

  void UpdateTooLongValidityState();

  void UpdateTooShortValidityState();

  void UpdateValueMissingValidityState();

  void UpdateTypeMismatchValidityState();

  void UpdatePatternMismatchValidityState();

  void UpdateRangeOverflowValidityState();

  void UpdateRangeUnderflowValidityState();

  void UpdateStepMismatchValidityState();

  void UpdateBadInputValidityState();

  void UpdatePlaceholderShownState();

  void UpdateCheckedState(bool aNotify);

  void UpdateIndeterminateState(bool aNotify);

  // Update all our validity states and then update our element state

  // as needed.  aNotify controls whether the element state update

  // needs to notify.

  void UpdateAllValidityStates(bool aNotify);

  void UpdateValidityElementStates(bool aNotify);

  MOZ_CAN_RUN_SCRIPT

  void MaybeUpdateAllValidityStates(bool aNotify) {

    // If you need to add new type which supports validationMessage, you should

    // add test cases into test_MozEditableElement_setUserInput.html.

    if (mType == FormControlType::InputEmail) {

      UpdateAllValidityStates(aNotify);

  // Update all our validity states without updating element state.

  // This should be called instead of UpdateAllValidityStates any time

  // we're guaranteed that element state will be updated anyway.

  void UpdateAllValidityStatesButNotElementState();

  void UpdateBarredFromConstraintValidation();

  nsresult GetValidationMessage(nsAString& aValidationMessage,

                                ValidityStateType aType) override;

  // Override SetCustomValidity so we update our state properly when it's called

  // via bindings.

  void SetCustomValidity(const nsAString& aError);

/**

   * Update the value missing validity state for radio elements when they have

   * a group.

   * @param aIgnoreSelf Whether the required attribute and the checked state

   * of the current radio should be ignored.

   * @note This method shouldn't be called if the radio element hasn't a group.

*/

  void UpdateValueMissingValidityStateForRadio(bool aIgnoreSelf);

/**

   * Set filters to the filePicker according to the accept attribute value.

   * See:

   * http://dev.w3.org/html5/spec/forms.html#attr-input-accept

   * @note You should not call this function if the element has no @accept.

   * @note "All Files" filter is always set, no matter if there is a valid

   * filter specified or not.

   * @note If more than one valid filter is found, the "All Supported Types"

   * filter is added, which is the concatenation of all valid filters.

   * @note Duplicate filters and similar filters (i.e. filters whose file

   * extensions already exist in another filter) are ignored.

   * @note "All Files" filter will be selected by default if unknown mime types

   * have been specified and no file extension filter has been specified.

   * Otherwise, specified filter or "All Supported Types" filter will be

   * selected by default.

   * The logic behind is that having unknown mime type means we might restrict

   * user's input too much, as some filters will be missing.

   * However, if author has also specified some file extension filters, it's

   * likely those are fallback for the unusual mime type we haven't been able

   * to resolve; so it's better to select author specified filters in that case.

*/

  void SetFilePickerFiltersFromAccept(nsIFilePicker* filePicker);

  void SetUserInteracted(bool) final;

/**

   * Fires change event if mFocusedValue and current value held are unequal and

   * if a change event may be fired on bluring.

   * Sets mFocusedValue to value, if a change event is fired.

*/

  void FireChangeEventIfNeeded();

/**

   * Returns the input element's value as a Decimal.

   * Returns NaN if the current element's value is not a floating point number.

   * @return the input element's value as a Decimal.

*/

  Decimal GetValueAsDecimal() const;

/**

   * Returns the input's "minimum" (as defined by the HTML5 spec) as a double.

   * Note this takes account of any default minimum that the type may have.

   * Returns NaN if the min attribute isn't a valid floating point number and

   * the input's type does not have a default minimum.

   * NOTE: Only call this if you know DoesMinMaxApply() returns true.

*/

  Decimal GetMinimum() const;

/**

   * Returns the input's "maximum" (as defined by the HTML5 spec) as a double.

   * Note this takes account of any default maximum that the type may have.

   * Returns NaN if the max attribute isn't a valid floating point number and

   * the input's type does not have a default maximum.

   * NOTE:Only call this if you know DoesMinMaxApply() returns true.

*/

  Decimal GetMaximum() const;

  // WebIDL

  void GetAccept(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::accept, aValue); }

  void SetAccept(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::accept, aValue, aRv);

  void GetAlt(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::alt, aValue); }

  void SetAlt(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::alt, aValue, aRv);

  void GetAutocomplete(nsAString& aValue);

  void SetAutocomplete(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::autocomplete, aValue, aRv);

  void GetAutocompleteInfo(Nullable<AutocompleteInfo>& aInfo);

  void GetCapture(nsAString& aValue);

  void SetCapture(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::capture, aValue, aRv);

  bool DefaultChecked() const { return HasAttr(nsGkAtoms::checked); }

  void SetDefaultChecked(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::checked, aValue, aRv);

  bool Checked() const { return mChecked; }

  void SetChecked(bool aChecked);

  bool IsRadioOrCheckbox() const {

    return mType == FormControlType::InputCheckbox ||

           mType == FormControlType::InputRadio;

  bool IsInputColor() const { return mType == FormControlType::InputColor; }

  bool Disabled() const { return GetBoolAttr(nsGkAtoms::disabled); }

  void SetDisabled(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::disabled, aValue, aRv);

  FileList* GetFiles();

  void SetFiles(FileList* aFiles);

  void SetFormAction(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::formaction, aValue, aRv);

  void GetFormEnctype(nsAString& aValue);

  void SetFormEnctype(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::formenctype, aValue, aRv);

  void GetFormMethod(nsAString& aValue);

  void SetFormMethod(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::formmethod, aValue, aRv);

  bool FormNoValidate() const { return GetBoolAttr(nsGkAtoms::formnovalidate); }

  void SetFormNoValidate(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::formnovalidate, aValue, aRv);

  void GetFormTarget(nsAString& aValue) {

    GetHTMLAttr(nsGkAtoms::formtarget, aValue);

  void SetFormTarget(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::formtarget, aValue, aRv);

  MOZ_CAN_RUN_SCRIPT uint32_t Height();

  void SetHeight(uint32_t aValue, ErrorResult& aRv) {

    SetUnsignedIntAttr(nsGkAtoms::height, aValue, 0, aRv);

  bool Indeterminate() const { return mIndeterminate; }

  bool IsDraggingRange() const { return mIsDraggingRange; }

  void SetIndeterminate(bool aValue);

  HTMLDataListElement* GetList() const;

  void GetMax(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::max, aValue); }

  void SetMax(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::max, aValue, aRv);

  int32_t MaxLength() const { return GetIntAttr(nsGkAtoms::maxlength, -1); }

  int32_t UsedMaxLength() const final {

    if (!mInputType->MinAndMaxLengthApply()) {

      return -1;

    return MaxLength();

  void SetMaxLength(int32_t aValue, ErrorResult& aRv) {

    int32_t minLength = MinLength();

    if (aValue < 0 || (minLength >= 0 && aValue < minLength)) {

      aRv.Throw(NS_ERROR_DOM_INDEX_SIZE_ERR);

      return;

    SetHTMLIntAttr(nsGkAtoms::maxlength, aValue, aRv);

  int32_t MinLength() const { return GetIntAttr(nsGkAtoms::minlength, -1); }

  void SetMinLength(int32_t aValue, ErrorResult& aRv) {

    int32_t maxLength = MaxLength();

    if (aValue < 0 || (maxLength >= 0 && aValue > maxLength)) {

      aRv.Throw(NS_ERROR_DOM_INDEX_SIZE_ERR);

      return;

    SetHTMLIntAttr(nsGkAtoms::minlength, aValue, aRv);

  void GetMin(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::min, aValue); }

  void SetMin(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::min, aValue, aRv);

  bool Multiple() const { return GetBoolAttr(nsGkAtoms::multiple); }

  void SetMultiple(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::multiple, aValue, aRv);

  void GetName(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::name, aValue); }

  void SetName(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::name, aValue, aRv);

  void GetPattern(nsAString& aValue) {

    GetHTMLAttr(nsGkAtoms::pattern, aValue);

  void SetPattern(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::pattern, aValue, aRv);

  void GetPlaceholder(nsAString& aValue) {

    GetHTMLAttr(nsGkAtoms::placeholder, aValue);

  void SetPlaceholder(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::placeholder, aValue, aRv);

  bool ReadOnly() const { return GetBoolAttr(nsGkAtoms::readonly); }

  void SetReadOnly(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::readonly, aValue, aRv);

  bool Required() const { return GetBoolAttr(nsGkAtoms::required); }

  void SetRequired(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::required, aValue, aRv);

  uint32_t Size() const {

    return GetUnsignedIntAttr(nsGkAtoms::size, DEFAULT_COLS);

  void SetSize(uint32_t aValue, ErrorResult& aRv) {

    if (aValue == 0) {

      aRv.Throw(NS_ERROR_DOM_INDEX_SIZE_ERR);

      return;

    SetUnsignedIntAttr(nsGkAtoms::size, aValue, DEFAULT_COLS, aRv);

  void GetSrc(nsAString& aValue) {

    GetURIAttr(nsGkAtoms::src, nullptr, aValue);

  void SetSrc(const nsAString& aValue, nsIPrincipal* aTriggeringPrincipal,

              ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::src, aValue, aTriggeringPrincipal, aRv);

  void GetStep(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::step, aValue); }

  void SetStep(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::step, aValue, aRv);

  void GetType(nsAString& aValue) const;

  void SetType(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::type, aValue, aRv);

  void GetDefaultValue(nsAString& aValue) {

    GetHTMLAttr(nsGkAtoms::value, aValue);

  void SetDefaultValue(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::value, aValue, aRv);

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  void SetValue(const nsAString& aValue, CallerType aCallerType,

                ErrorResult& aRv);

  void GetValue(nsAString& aValue, CallerType aCallerType);

  // Generic getter for the value that doesn't do experimental control type

  // sanitization.

  void GetValueInternal(nsAString& aValue, CallerType aCallerType) const;

  void GetValueAsDate(JSContext* aCx, JS::MutableHandle<JSObject*> aObj,

                      ErrorResult& aRv);

  void SetValueAsDate(JSContext* aCx, JS::Handle<JSObject*> aObj,

                      ErrorResult& aRv);

  double ValueAsNumber() const {

    return DoesValueAsNumberApply() ? GetValueAsDecimal().toDouble()

                                    : UnspecifiedNaN<double>();

  void SetValueAsNumber(double aValue, ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT uint32_t Width();

  void SetWidth(uint32_t aValue, ErrorResult& aRv) {

    SetUnsignedIntAttr(nsGkAtoms::width, aValue, 0, aRv);

  void StepUp(int32_t aN, ErrorResult& aRv) { ApplyStep(aN, aRv); }

  void StepDown(int32_t aN, ErrorResult& aRv) { ApplyStep(-aN, aRv); }

/**

   * Returns the current step value.

   * Returns kStepAny if the current step is "any" string.

   * @return the current step value.

*/

  Decimal GetStep() const;

  // Returns whether the given keyboard event steps up or down the value of an

  // <input> element.

  bool StepsInputValue(const WidgetKeyboardEvent&) const;

  already_AddRefed<nsINodeList> GetLabels();

  MOZ_CAN_RUN_SCRIPT void Select();

  Nullable<uint32_t> GetSelectionStart(ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT void SetSelectionStart(const Nullable<uint32_t>& aValue,

                                            ErrorResult& aRv);

  Nullable<uint32_t> GetSelectionEnd(ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT void SetSelectionEnd(const Nullable<uint32_t>& aValue,

                                          ErrorResult& aRv);

  void GetSelectionDirection(nsAString& aValue, ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT void SetSelectionDirection(const nsAString& aValue,

                                                ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT void SetSelectionRange(

      uint32_t aStart, uint32_t aEnd, const Optional<nsAString>& direction,

      ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT void SetRangeText(const nsAString& aReplacement,

                                       ErrorResult& aRv);

  MOZ_CAN_RUN_SCRIPT void SetRangeText(const nsAString& aReplacement,

                                       uint32_t aStart, uint32_t aEnd,

                                       SelectionMode aSelectMode,

                                       ErrorResult& aRv);

  void ShowPicker(ErrorResult& aRv);

  bool WebkitDirectoryAttr() const {

    return HasAttr(nsGkAtoms::webkitdirectory);

  void SetWebkitDirectoryAttr(bool aValue, ErrorResult& aRv) {

    SetHTMLBoolAttr(nsGkAtoms::webkitdirectory, aValue, aRv);

  void GetWebkitEntries(nsTArray<RefPtr<FileSystemEntry>>& aSequence);

  already_AddRefed<Promise> GetFilesAndDirectories(ErrorResult& aRv);

  void GetAlign(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::align, aValue); }

  void SetAlign(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::align, aValue, aRv);

  void GetUseMap(nsAString& aValue) { GetHTMLAttr(nsGkAtoms::usemap, aValue); }

  void SetUseMap(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::usemap, aValue, aRv);

  void GetDirName(nsAString& aValue) {

    GetHTMLAttr(nsGkAtoms::dirname, aValue);

  void SetDirName(const nsAString& aValue, ErrorResult& aRv) {

    SetHTMLAttr(nsGkAtoms::dirname, aValue, aRv);

  nsIControllers* GetControllers(ErrorResult& aRv);

  // XPCOM adapter function widely used throughout code, leaving it as is.

  nsresult GetControllers(nsIControllers** aResult);

  int32_t InputTextLength(CallerType aCallerType);

  void MozGetFileNameArray(nsTArray<nsString>& aFileNames, ErrorResult& aRv);

  void MozSetFileNameArray(const Sequence<nsString>& aFileNames,

                           ErrorResult& aRv);

  void MozSetFileArray(const Sequence<OwningNonNull<File>>& aFiles);

  void MozSetDirectory(const nsAString& aDirectoryPath, ErrorResult& aRv);

/*

   * The following functions are called from datetime picker to let input box

   * know the current state of the picker or to update the input box on changes.

*/

  void GetDateTimeInputBoxValue(DateTimeValue& aValue);

/*

   * This allows chrome JavaScript to dispatch event to the inner datetimebox

   * anonymous or UA Widget element.

*/

  Element* GetDateTimeBoxElement();

/*

   * The following functions are called from datetime input box XBL to control

   * and update the picker.

*/

  void OpenDateTimePicker(const DateTimeValue& aInitialValue);

  void UpdateDateTimePicker(const DateTimeValue& aValue);

  void CloseDateTimePicker();

/*

   * Called from datetime input box binding when inner text fields are focused

   * or blurred.

*/

  void SetFocusState(bool aIsFocused);

/*

   * Called from datetime input box binding when the the user entered value

   * becomes valid/invalid.

*/

  void UpdateValidityState();

/*

   * The following are called from datetime input box binding to get the

   * corresponding computed values.

*/

  double GetStepAsDouble() { return GetStep().toDouble(); }

  double GetStepBaseAsDouble() { return GetStepBase().toDouble(); }

  double GetMinimumAsDouble() { return GetMinimum().toDouble(); }

  double GetMaximumAsDouble() { return GetMaximum().toDouble(); }

  void StartNumberControlSpinnerSpin();

  enum SpinnerStopState { eAllowDispatchingEvents, eDisallowDispatchingEvents };

  void StopNumberControlSpinnerSpin(

      SpinnerStopState aState = eAllowDispatchingEvents);

  MOZ_CAN_RUN_SCRIPT

  void StepNumberControlForUserEvent(int32_t aDirection);

/**

   * The callback function used by the nsRepeatService that we use to spin the

   * spinner for <input type=number>.

*/

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  static void HandleNumberControlSpin(void* aData);

  bool NumberSpinnerUpButtonIsDepressed() const {

    return mNumberControlSpinnerIsSpinning && mNumberControlSpinnerSpinsUp;

  bool NumberSpinnerDownButtonIsDepressed() const {

    return mNumberControlSpinnerIsSpinning && !mNumberControlSpinnerSpinsUp;

  bool MozIsTextField(bool aExcludePassword);

  MOZ_CAN_RUN_SCRIPT nsIEditor* GetEditorForBindings();

  // For WebIDL bindings.

  bool HasEditor() const;

  bool IsInputEventTarget() const { return IsSingleLineTextControl(false); }

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  void SetUserInput(const nsAString& aInput, nsIPrincipal& aSubjectPrincipal);

/**

   * If aValue contains a valid floating-point number in the format specified

   * by the HTML 5 spec:

   *   http://www.whatwg.org/specs/web-apps/current-work/multipage/common-microsyntaxes.html#floating-point-numbers

   * then this function will return the number parsed as a Decimal, otherwise

   * it will return a Decimal for which Decimal::isFinite() will return false.

*/

  static Decimal StringToDecimal(const nsAString& aValue);

  void UpdateEntries(

      const nsTArray<OwningFileOrDirectory>& aFilesOrDirectories);

/**

   * Returns if the required attribute applies for the current type.

*/

  bool DoesRequiredApply() const;

/**

   * Returns the current required state of the element. This function differs

   * from Required() in that this function only returns true for input types

   * that @required attribute applies and the attribute is set; in contrast,

   * Required() returns true whenever @required attribute is set.

*/

  bool IsRequired() const { return State().HasState(ElementState::REQUIRED); }

  bool HasBeenTypePassword() const { return mHasBeenTypePassword; }

/**

   * Returns whether the current value is the empty string.  This only makes

   * sense for some input types; does NOT make sense for file inputs.

   * @return whether the current value is the empty string.

*/

  bool IsValueEmpty() const {

    return State().HasState(ElementState::VALUE_EMPTY);

  // Parse a simple (hex) color.

  static mozilla::Maybe<nscolor> ParseSimpleColor(const nsAString& aColor);

/**

   * https://html.spec.whatwg.org/#auto-directionality-form-associated-elements

*/

  bool IsAutoDirectionalityAssociated() const {

    return IsAutoDirectionalityAssociated(mType);

 protected:

  MOZ_CAN_RUN_SCRIPT_BOUNDARY virtual ~HTMLInputElement();

  JSObject* WrapNode(JSContext* aCx,

                     JS::Handle<JSObject*> aGivenProto) override;

  // Pull IsSingleLineTextControl into our scope, otherwise it'd be hidden

  // by the TextControlElement version.

  using nsGenericHTMLFormControlElementWithState::IsSingleLineTextControl;

/**

   * The ValueModeType specifies how the value IDL attribute should behave.

   * See: http://dev.w3.org/html5/spec/forms.html#dom-input-value

*/

  enum ValueModeType {

    // On getting, returns the value.

    // On setting, sets value.

    VALUE_MODE_VALUE,

    // On getting, returns the value if present or the empty string.

    // On setting, sets the value.

    VALUE_MODE_DEFAULT,

    // On getting, returns the value if present or "on".

    // On setting, sets the value.

    VALUE_MODE_DEFAULT_ON,

    // On getting, returns "C:\fakepath\" followed by the file name of the

    // first file of the selected files if any.

    // On setting the empty string, empties the selected files list, otherwise

    // throw the INVALID_STATE_ERR exception.

    VALUE_MODE_FILENAME

};

/**

   * This helper method convert a sub-string that contains only digits to a

   * number (unsigned int given that it can't contain a minus sign).

   * This method will return whether the sub-string is correctly formatted

   * (ie. contains only digit) and it can be successfuly parsed to generate a

   * number).

   * If the method returns true, |aResult| will contained the parsed number.

   * @param aValue  the string on which the sub-string will be extracted and

   * parsed.

   * @param aStart  the beginning of the sub-string in aValue.

   * @param aLen    the length of the sub-string.

   * @param aResult the parsed number.

   * @return whether the sub-string has been parsed successfully.

*/

  static bool DigitSubStringToNumber(const nsAString& aValue, uint32_t aStart,

                                     uint32_t aLen, uint32_t* aResult);

  // Helper method

/**

   * Setting the value.

   * @param aValue      String to set.

   * @param aOldValue   Previous value before setting aValue.

                        If previous value is unknown, aOldValue can be nullptr.

   * @param aOptions    See TextControlState::ValueSetterOption.

*/

  MOZ_CAN_RUN_SCRIPT nsresult

  SetValueInternal(const nsAString& aValue, const nsAString* aOldValue,

                   const ValueSetterOptions& aOptions);

  MOZ_CAN_RUN_SCRIPT nsresult SetValueInternal(

      const nsAString& aValue, const ValueSetterOptions& aOptions) {

    return SetValueInternal(aValue, nullptr, aOptions);

  // A getter for callers that know we're not dealing with a file input, so they

  // don't have to think about the caller type.

  void GetNonFileValueInternal(nsAString& aValue) const;

  void ClearFiles(bool aSetValueChanged);

  void SetIndeterminateInternal(bool aValue, bool aShouldInvalidate);

/**

   * Called when an attribute is about to be changed

*/

  void BeforeSetAttr(int32_t aNameSpaceID, nsAtom* aName,

                     const nsAttrValue* aValue, bool aNotify) override;

/**

   * Called when an attribute has just been changed

*/

  MOZ_CAN_RUN_SCRIPT_BOUNDARY

  void AfterSetAttr(int32_t aNameSpaceID, nsAtom* aName,

                    const nsAttrValue* aValue, const nsAttrValue* aOldValue,

                    nsIPrincipal* aSubjectPrincipal, bool aNotify) override;

  void BeforeSetForm(HTMLFormElement* aForm, bool aBindToTree) override;

  void AfterClearForm(bool aUnbindOrDelete) override;

  void ResultForDialogSubmit(nsAString& aResult) override;

  MOZ_CAN_RUN_SCRIPT void SelectAll();

  bool IsImage() const {

    return AttrValueIs(kNameSpaceID_None, nsGkAtoms::type, nsGkAtoms::image,

                       eIgnoreCase);

/**

   * Visit the group of radio buttons this radio belongs to

   * @param aVisitor the visitor to visit with

*/

  nsresult VisitGroup(nsIRadioVisitor* aVisitor);

/**

   * Do all the work that |SetChecked| does (radio button handling, etc.), but

   * take an |aNotify| parameter.

*/

  void DoSetChecked(bool aValue, bool aNotify, bool aSetValueChanged);

/**

   * Do all the work that |SetCheckedChanged| does (radio button handling,

   * etc.), but take an |aNotify| parameter that lets it avoid flushing content

   * when it can.

*/

  void DoSetCheckedChanged(bool aCheckedChanged, bool aNotify);

/**

   * Actually set checked and notify the frame of the change.

   * @param aValue the value of checked to set

*/

  void SetCheckedInternal(bool aValue, bool aNotify);

  void RadioSetChecked(bool aNotify);

  void SetCheckedChanged(bool aCheckedChanged);

/**

   * MaybeSubmitForm looks for a submit input or a single text control

   * and submits the form if either is present.

*/

  MOZ_CAN_RUN_SCRIPT void MaybeSubmitForm(nsPresContext* aPresContext);

/**

   * Called after calling one of the SetFilesOrDirectories() functions.

   * This method can explore the directory recursively if needed.

*/

  void AfterSetFilesOrDirectories(bool aSetValueChanged);

/**

   * Recursively explore the directory and populate mFileOrDirectories correctly

   * for webkitdirectory.

*/

  void ExploreDirectoryRecursively(bool aSetValuechanged);

/**

   * Determine whether the editor needs to be initialized explicitly for

   * a particular event.

*/

  bool NeedToInitializeEditorForEvent(EventChainPreVisitor& aVisitor) const;

/**

   * Get the value mode of the element, depending of the type.

*/

  ValueModeType GetValueMode() const;

/**

   * Get the mutable state of the element.

   * When the element isn't mutable (immutable), the value or checkedness

   * should not be changed by the user.

   * See: https://html.spec.whatwg.org/#concept-fe-mutable

*/

  bool IsMutable() const;

/**

   * Returns if the min and max attributes apply for the current type.

*/

  bool DoesMinMaxApply() const;

/**

   * Returns if the step attribute apply for the current type.

*/

  bool DoesStepApply() const { return DoesMinMaxApply(); }

/**

   * Returns if stepDown and stepUp methods apply for the current type.

*/

  bool DoStepDownStepUpApply() const { return DoesStepApply(); }

/**

   * Returns if valueAsNumber attribute applies for the current type.

*/

  bool DoesValueAsNumberApply() const { return DoesMinMaxApply(); }

/**

   * Returns if autocomplete attribute applies for the current type.

*/

  bool DoesAutocompleteApply() const;

  MOZ_CAN_RUN_SCRIPT void FreeData();

  TextControlState* GetEditorState() const;

  void EnsureEditorState();

  MOZ_CAN_RUN_SCRIPT TextEditor* GetTextEditorFromState();

/**

   * Manages the internal data storage across type changes.

*/

  MOZ_CAN_RUN_SCRIPT

  void HandleTypeChange(FormControlType aNewType, bool aNotify);

/**

   * If the input range has a list, this function will snap the given value to

   * the nearest tick mark, but only if the given value is close enough to that

   * tick mark.

*/

  void MaybeSnapToTickMark(Decimal& aValue);

  enum class SanitizationKind { ForValueGetter, ForValueSetter, ForDisplay };

/**

   * Sanitize the value of the element depending of its current type.

   * See:

   * http://www.whatwg.org/specs/web-apps/current-work/#value-sanitization-algorithm

*/

  void SanitizeValue(nsAString& aValue, SanitizationKind) const;

/**

   * Returns whether the placeholder attribute applies for the current type.

*/

  bool PlaceholderApplies() const;

/**

   * Set the current default value to the value of the input element.

   * @note You should not call this method if GetValueMode() doesn't return

   * VALUE_MODE_VALUE.

*/

  MOZ_CAN_RUN_SCRIPT

  nsresult SetDefaultValueAsValue();

/**

   * Returns the radio group container within the DOM tree that the element

   * is currently a member of, if one exists.

*/

  RadioGroupContainer* GetCurrentRadioGroupContainer() const;

/**

   * Returns the radio group container within the DOM tree that the element

   * should be added into, if one exists.

*/

  RadioGroupContainer* FindTreeRadioGroupContainer() const;

/**

   * Parse a color string of the form #XXXXXX where X should be hexa characters

   * @param the string to be parsed.

   * @return whether the string is a valid simple color.

   * Note : this function does not consider the empty string as valid.

*/

  bool IsValidSimpleColor(const nsAString& aValue) const;

/**

   * Parse a week string of the form yyyy-Www

   * @param the string to be parsed.

   * @return whether the string is a valid week.

   * Note : this function does not consider the empty string as valid.

*/

  bool IsValidWeek(const nsAString& aValue) const;

/**

   * Parse a month string of the form yyyy-mm

   * @param the string to be parsed.

   * @return whether the string is a valid month.

   * Note : this function does not consider the empty string as valid.

*/

  bool IsValidMonth(const nsAString& aValue) const;

/**

   * Parse a date string of the form yyyy-mm-dd

   * @param the string to be parsed.

   * @return whether the string is a valid date.

   * Note : this function does not consider the empty string as valid.

*/

  bool IsValidDate(const nsAString& aValue) const;

/**

   * Parse a datetime-local string of the form yyyy-mm-ddThh:mm[:ss.s] or

   * yyyy-mm-dd hh:mm[:ss.s], where fractions of seconds can be 1 to 3 digits.

   * @param the string to be parsed.

   * @return whether the string is a valid datetime-local string.

   * Note : this function does not consider the empty string as valid.

*/

  bool IsValidDateTimeLocal(const nsAString& aValue) const;

/**

   * Parse a year string of the form yyyy

   * @param the string to be parsed.

   * @return the year in aYear.

   * @return whether the parsing was successful.

*/

  bool ParseYear(const nsAString& aValue, uint32_t* aYear) const;

/**

   * Parse a month string of the form yyyy-mm

   * @param the string to be parsed.

   * @return the year and month in aYear and aMonth.

   * @return whether the parsing was successful.

*/

  bool ParseMonth(const nsAString& aValue, uint32_t* aYear,

                  uint32_t* aMonth) const;

/**

   * Parse a week string of the form yyyy-Www

   * @param the string to be parsed.

   * @return the year and week in aYear and aWeek.

   * @return whether the parsing was successful.

*/

  bool ParseWeek(const nsAString& aValue, uint32_t* aYear,

                 uint32_t* aWeek) const;

/**

   * Parse a date string of the form yyyy-mm-dd

   * @param the string to be parsed.

   * @return the date in aYear, aMonth, aDay.

   * @return whether the parsing was successful.

*/

  bool ParseDate(const nsAString& aValue, uint32_t* aYear, uint32_t* aMonth,

                 uint32_t* aDay) const;

/**

   * Parse a datetime-local string of the form yyyy-mm-ddThh:mm[:ss.s] or

   * yyyy-mm-dd hh:mm[:ss.s], where fractions of seconds can be 1 to 3 digits.

   * @param the string to be parsed.

   * @return the date in aYear, aMonth, aDay and time expressed in milliseconds

   *         in aTime.

   * @return whether the parsing was successful.

*/

  bool ParseDateTimeLocal(const nsAString& aValue, uint32_t* aYear,

                          uint32_t* aMonth, uint32_t* aDay,

                          uint32_t* aTime) const;

/**

   * Normalize the datetime-local string following the HTML specifications:

   * https://html.spec.whatwg.org/multipage/infrastructure.html#valid-normalised-local-date-and-time-string

*/

  void NormalizeDateTimeLocal(nsAString& aValue) const;

/**

   * This methods returns the number of days since epoch for a given year and

   * week.

*/

  double DaysSinceEpochFromWeek(uint32_t aYear, uint32_t aWeek) const;

/**

   * This methods returns the number of days in a given month, for a given year.

*/

  uint32_t NumberOfDaysInMonth(uint32_t aMonth, uint32_t aYear) const;

/**

   * This methods returns the number of months between January 1970 and the

   * given year and month.

*/

  int32_t MonthsSinceJan1970(uint32_t aYear, uint32_t aMonth) const;

/**

   * This methods returns the day of the week given a date. If @isoWeek is true,

   * 7=Sunday, otherwise, 0=Sunday.

*/

  uint32_t DayOfWeek(uint32_t aYear, uint32_t aMonth, uint32_t aDay,

                     bool isoWeek) const;

/**

   * This methods returns the maximum number of week in a given year, the

   * result is either 52 or 53.

*/

  uint32_t MaximumWeekInYear(uint32_t aYear) const;

/**

   * This methods returns true if it's a leap year.

*/

  bool IsLeapYear(uint32_t aYear) const;

/**

   * Returns whether aValue is a valid time as described by HTML specifications:

   * http://www.whatwg.org/specs/web-apps/current-work/multipage/common-microsyntaxes.html#valid-time-string

   * @param aValue the string to be tested.

   * @return Whether the string is a valid time per HTML specifications.

*/

  bool IsValidTime(const nsAString& aValue) const;

/**

   * Returns the time expressed in milliseconds of |aValue| being parsed as a

   * time following the HTML specifications:

   * http://www.whatwg.org/specs/web-apps/current-work/#parse-a-time-string

   * Note: |aResult| can be null.

   * @param aValue  the string to be parsed.

   * @param aResult the time expressed in milliseconds representing the time

   * [out]

   * @return Whether the parsing was successful.

*/

  static bool ParseTime(const nsAString& aValue, uint32_t* aResult);

/**

   * Sets the value of the element to the string representation of the Decimal.

   * @param aValue The Decimal that will be used to set the value.

*/

  void SetValue(Decimal aValue, CallerType aCallerType);

  void UpdateHasRange(bool aNotify);

  // Updates the :in-range / :out-of-range states.

  void UpdateInRange(bool aNotify);

/**

   * Get the step scale value for the current type.

   * See:

   * http://www.whatwg.org/specs/web-apps/current-work/multipage/common-input-element-attributes.html#concept-input-step-scale

*/

  Decimal GetStepScaleFactor() const;

/**

   * Return the base used to compute if a value matches step.

   * Basically, it's the min attribute if present and a default value otherwise.

   * @return The step base.

*/

  Decimal GetStepBase() const;

/**

   * Returns the default step for the current type.

   * @return the default step for the current type.

*/

  Decimal GetDefaultStep() const;

  enum class StepCallerType { ForUserEvent, ForScript };

/**

   * Returns the value that this input would take if someone tries to step

   * aStepCount steps and this input's value would change as a result, or

   * Decimal::nan() otherwise (e.g., if this inputs value would not change due

   * to it being already at max, and asking for the next step up).

   * Negative aStep means step down, positive means step up.

*/

  Decimal GetValueIfStepped(int32_t aStepCount, StepCallerType, ErrorResult&);

/**

   * Apply a step change from stepUp or stepDown by multiplying aStep by the

   * current step value.

   * @param aStep The value used to be multiplied against the step value.

*/

  void ApplyStep(int32_t aStep, ErrorResult&);

/**

   * Returns if the current type is an experimental mobile type.

*/

  static bool IsExperimentalMobileType(FormControlType);

/*

   * Returns if the current type is one of the date/time input types: date,

   * time, month, week and datetime-local.

*/

  static bool IsDateTimeInputType(FormControlType);

/**

   * Returns whether getting `.value` as a string should sanitize the value.

   * See SanitizeValue.

*/

  bool SanitizesOnValueGetter() const;

/**

   * Returns true if the element should prevent dispatching another DOMActivate.

   * This is used in situations where the anonymous subtree should already have

   * sent a DOMActivate and prevents firing more than once.

*/

  bool ShouldPreventDOMActivateDispatch(EventTarget* aOriginalTarget);

/**

   * Some input type (color and file) let user choose a value using a picker:

   * this function checks if it is needed, and if so, open the corresponding

   * picker (color picker or file picker).

*/

  nsresult MaybeInitPickers(EventChainPostVisitor& aVisitor);

/**

   * Returns all valid colors in the <datalist> for the input with type=color.

*/

  nsTArray<nsString> GetColorsFromList();

  enum FilePickerType { FILE_PICKER_FILE, FILE_PICKER_DIRECTORY };

  nsresult InitFilePicker(FilePickerType aType);

  nsresult InitColorPicker();

  GetFilesHelper* GetOrCreateGetFilesHelper(bool aRecursiveFlag,

                                            ErrorResult& aRv);

  void ClearGetFilesHelpers();

/**

   * nsINode::SetMayBeApzAware() will be invoked in this function if necessary

   * to prevent default action of APZC so that we can increase/decrease the

   * value of this InputElement when mouse wheel event comes without scrolling

   * the page.

   * SetMayBeApzAware() will set flag MayBeApzAware which is checked by apzc to

   * decide whether to add this element into its dispatch-to-content region.

*/

  void UpdateApzAwareFlag();

/**

   * A helper to get the current selection range.  Will throw on the ErrorResult

   * if we have no editor state.

*/

  void GetSelectionRange(uint32_t* aSelectionStart, uint32_t* aSelectionEnd,

                         ErrorResult& aRv);

/**

   * Override for nsImageLoadingContent.

*/

  nsIContent* AsContent() override { return this; }

  nsCOMPtr<nsIControllers> mControllers;

/*

   * In mInputData, the mState field is used if IsSingleLineTextControl returns

   * true and mValue is used otherwise.  We have to be careful when handling it

   * on a type change.

   * Accessing the mState member should be done using the GetEditorState

   * function, which returns null if the state is not present.

*/

  union InputData {

/**

     * The current value of the input if it has been changed from the default

*/

    char16_t* mValue;

/**

     * The state of the text editor associated with the text/password input

*/

    TextControlState* mState;

  } mInputData;

  struct FileData;

  UniquePtr<FileData> mFileData;

/**

   * The value of the input element when first initialized and it is updated

   * when the element is either changed through a script, focused or dispatches

   * a change event. This is to ensure correct future change event firing.

   * NB: This is ONLY applicable where the element is a text control. ie,

   * where type= "date", "time", "text", "email", "search", "tel", "url" or

   * "password".

*/

  nsString mFocusedValue;

/**

   * If mIsDraggingRange is true, this is the value that the input had before

   * the drag started. Used to reset the input to its old value if the drag is

   * canceled.

*/

  Decimal mRangeThumbDragStartValue;

/**

   * Current value in the input box, in DateTimeValue dictionary format, see

   * HTMLInputElement.webidl for details.

*/

  UniquePtr<DateTimeValue> mDateTimeInputBoxValue;

/**

   * The triggering principal for the src attribute.

*/

  nsCOMPtr<nsIPrincipal> mSrcTriggeringPrincipal;

/*

   * InputType object created based on input type.

*/

  UniquePtr<InputType, InputType::DoNotDelete> mInputType;

  static constexpr size_t INPUT_TYPE_SIZE =

      sizeof(Variant<TextInputType, SearchInputType, TelInputType, URLInputType,

                     EmailInputType, PasswordInputType, NumberInputType,

                     RangeInputType, RadioInputType, CheckboxInputType,

                     ButtonInputType, ImageInputType, ResetInputType,

                     SubmitInputType, DateInputType, TimeInputType,

                     WeekInputType, MonthInputType, DateTimeLocalInputType,

                     FileInputType, ColorInputType, HiddenInputType>);

  // Memory allocated for mInputType, reused when type changes.

  char mInputTypeMem[INPUT_TYPE_SIZE];

  // Step scale factor values, for input types that have one.

  static const Decimal kStepScaleFactorDate;

  static const Decimal kStepScaleFactorNumberRange;

  static const Decimal kStepScaleFactorTime;

  static const Decimal kStepScaleFactorMonth;

  static const Decimal kStepScaleFactorWeek;

  // Default step base value when a type do not have specific one.

  static const Decimal kDefaultStepBase;

  // Default step base value when type=week does not not have a specific one,

  // which is −259200000, the start of week 1970-W01.

  static const Decimal kDefaultStepBaseWeek;

  // Default step used when there is no specified step.

  static const Decimal kDefaultStep;

  static const Decimal kDefaultStepTime;

  // Float value returned by GetStep() when the step attribute is set to 'any'.

  static const Decimal kStepAny;

  // Minimum year limited by HTML standard, year >= 1.

  static const double kMinimumYear;

  // Maximum year limited by ECMAScript date object range, year <= 275760.

  static const double kMaximumYear;

  // Maximum valid week is 275760-W37.

  static const double kMaximumWeekInMaximumYear;

  // Maximum valid day is 275760-09-13.

  static const double kMaximumDayInMaximumYear;

  // Maximum valid month is 275760-09.

  static const double kMaximumMonthInMaximumYear;

  // Long years in a ISO calendar have 53 weeks in them.

  static const double kMaximumWeekInYear;

  // Milliseconds in a day.

  static const double kMsPerDay;

  nsContentUtils::AutocompleteAttrState mAutocompleteAttrState;

  nsContentUtils::AutocompleteAttrState mAutocompleteInfoState;

  bool mDisabledChanged : 1;

  // https://html.spec.whatwg.org/#concept-fe-dirty

  // TODO: Maybe rename to match the spec?

  bool mValueChanged : 1;

  // https://html.spec.whatwg.org/#user-interacted

  bool mUserInteracted : 1;

  bool mLastValueChangeWasInteractive : 1;

  bool mCheckedChanged : 1;

  bool mChecked : 1;

  bool mShouldInitChecked : 1;

  bool mDoneCreating : 1;

  bool mInInternalActivate : 1;

  bool mCheckedIsToggled : 1;

  bool mIndeterminate : 1;

  bool mInhibitRestoration : 1;

  bool mHasRange : 1;

  bool mIsDraggingRange : 1;

  bool mNumberControlSpinnerIsSpinning : 1;

  bool mNumberControlSpinnerSpinsUp : 1;

  bool mPickerRunning : 1;

  bool mIsPreviewEnabled : 1;

  bool mHasBeenTypePassword : 1;

  bool mHasPatternAttribute : 1;

 private:

  Maybe<int32_t> GetNumberInputCols() const;

  static void ImageInputMapAttributesIntoRule(MappedDeclarationsBuilder&);

/**

   * Returns true if this input's type will fire a DOM "change" event when it

   * loses focus if its value has changed since it gained focus.

*/

  bool MayFireChangeOnBlur() const { return MayFireChangeOnBlur(mType); }

/**

   * Returns true if selection methods can be called on element

*/

  bool SupportsTextSelection() const {

    switch (mType) {

      case FormControlType::InputText:

      case FormControlType::InputSearch:

      case FormControlType::InputUrl:

      case FormControlType::InputTel:

      case FormControlType::InputPassword:

        return true;

      default:

        return false;

/**

   * https://html.spec.whatwg.org/#auto-directionality-form-associated-elements

*/

  static bool IsAutoDirectionalityAssociated(FormControlType aType) {

    switch (aType) {

      case FormControlType::InputHidden:

      case FormControlType::InputText:

      case FormControlType::InputSearch:

      case FormControlType::InputTel:

      case FormControlType::InputUrl:

      case FormControlType::InputEmail:

      case FormControlType::InputPassword:

      case FormControlType::InputSubmit:

      case FormControlType::InputReset:

      case FormControlType::InputButton:

        return true;

      default:

        return false;

  static bool CreatesDateTimeWidget(FormControlType aType) {

    return aType == FormControlType::InputDate ||

           aType == FormControlType::InputTime ||

           aType == FormControlType::InputDatetimeLocal;

  bool CreatesDateTimeWidget() const { return CreatesDateTimeWidget(mType); }

  static bool MayFireChangeOnBlur(FormControlType aType) {

    return IsSingleLineTextControl(false, aType) ||

           CreatesDateTimeWidget(aType) ||

           aType == FormControlType::InputRange ||

           aType == FormControlType::InputNumber;

  bool CheckActivationBehaviorPreconditions(EventChainVisitor& aVisitor) const;

/**

   * Call MaybeDispatchPasswordEvent or MaybeDispatchUsernameEvent

   * in order to dispatch LoginManager events.

*/

  void MaybeDispatchLoginManagerEvents(HTMLFormElement* aForm);

/**

   * Fire an event when the password input field is removed from the DOM tree.

   * This is now only used by the password manager and formautofill.

*/

  void MaybeFireInputPasswordRemoved();

/**

   * Checks if aDateTimeInputType should be supported.

*/

  static bool IsDateTimeTypeSupported(FormControlType);

/**

   * The radio group container containing the group the element is a part of.

   * This allows the element to only access a container it has been added to.

*/

  RadioGroupContainer* mRadioGroupContainer;

  struct nsFilePickerFilter {

    nsFilePickerFilter() : mFilterMask(0) {}

    explicit nsFilePickerFilter(int32_t aFilterMask)

        : mFilterMask(aFilterMask) {}

    nsFilePickerFilter(const nsString& aTitle, const nsString& aFilter)

        : mFilterMask(0), mTitle(aTitle), mFilter(aFilter) {}

    nsFilePickerFilter(const nsFilePickerFilter& other) {

      mFilterMask = other.mFilterMask;

      mTitle = other.mTitle;

      mFilter = other.mFilter;

    bool operator==(const nsFilePickerFilter& other) const {

      if ((mFilter == other.mFilter) && (mFilterMask == other.mFilterMask)) {

        return true;

      } else {

        return false;

    // Filter mask, using values defined in nsIFilePicker

    int32_t mFilterMask;

    // If mFilterMask is defined, mTitle and mFilter are useless and should be

    // ignored

    nsString mTitle;

    nsString mFilter;

};

  class nsFilePickerShownCallback : public nsIFilePickerShownCallback {

    virtual ~nsFilePickerShownCallback() = default;

   public:

    nsFilePickerShownCallback(HTMLInputElement* aInput,

                              nsIFilePicker* aFilePicker);

    NS_DECL_ISUPPORTS

    NS_IMETHOD Done(nsIFilePicker::ResultCode aResult) override;

   private:

    nsCOMPtr<nsIFilePicker> mFilePicker;

    const RefPtr<HTMLInputElement> mInput;

};

};

}  // namespace dom

}  // namespace mozilla

#endif