third_party/WebKit/Source/core/html/TextControlElement.h - chromium/src - Git at Google

 /*
  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
  *           (C) 2000 Dirk Mueller (mueller@kde.org)
  * Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010 Apple Inc. All rights
  * reserved.
  * Copyright (C) 2009, 2010, 2011 Google Inc. All rights reserved.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Library General Public License for more details.
  *
  * You should have received a copy of the GNU Library General Public License
  * along with this library; see the file COPYING.LIB.  If not, write to
  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  *
  */

 #ifndef TextControlElement_h
 #define TextControlElement_h

 #include "base/gtest_prod_util.h"
 #include "core/CoreExport.h"
 #include "core/editing/Forward.h"
 #include "core/html/HTMLFormControlElementWithState.h"
 #include "public/platform/WebFocusType.h"

 namespace blink {

 class ExceptionState;

 enum TextFieldSelectionDirection {
   kSelectionHasNoDirection,
   kSelectionHasForwardDirection,
   kSelectionHasBackwardDirection
 };
 enum TextFieldEventBehavior {
   kDispatchNoEvent,
   kDispatchChangeEvent,
   kDispatchInputAndChangeEvent
 };

 enum class TextControlSetValueSelection {
   kSetSelectionToEnd,
   kDoNotSet,
 };

 class CORE_EXPORT TextControlElement : public HTMLFormControlElementWithState {
  public:
   // Common flag for HTMLInputElement::tooLong(),
   // HTMLTextAreaElement::tooLong(),
   // HTMLInputElement::tooShort() and HTMLTextAreaElement::tooShort().
   enum NeedsToCheckDirtyFlag { kCheckDirtyFlag, kIgnoreDirtyFlag };

   ~TextControlElement() override;

   void ForwardEvent(Event*);

   void SetFocused(bool, WebFocusType) override;

   // The derived class should return true if placeholder processing is needed.
   virtual bool IsPlaceholderVisible() const = 0;
   virtual void SetPlaceholderVisibility(bool) = 0;
   virtual bool SupportsPlaceholder() const = 0;
   String StrippedPlaceholder() const;
   HTMLElement* PlaceholderElement() const;
   void UpdatePlaceholderVisibility();

   VisiblePosition VisiblePositionForIndex(int) const;
   int IndexForVisiblePosition(const VisiblePosition&) const;
   unsigned selectionStart() const;
   unsigned selectionEnd() const;
   const AtomicString& selectionDirection() const;
   void setSelectionStart(unsigned);
   void setSelectionEnd(unsigned);
   void setSelectionDirection(const String&);
   void select();
   virtual void setRangeText(const String& replacement, ExceptionState&);
   virtual void setRangeText(const String& replacement,
                             unsigned start,
                             unsigned end,
                             const String& selection_mode,
                             ExceptionState&);
   // Web-exposed setSelectionRange() function. This schedule to dispatch
   // 'select' event.
   void setSelectionRangeForBinding(unsigned start,
                                    unsigned end,
                                    const String& direction = "none");
   // Blink-internal version of setSelectionRange(). This translates "none"
   // direction to "forward" on platforms without "none" direction.
   // This returns true if it updated cached selection and/or FrameSelection.
   bool SetSelectionRange(
       unsigned start,
       unsigned end,
       TextFieldSelectionDirection = kSelectionHasNoDirection);
   SelectionInDOMTree Selection() const;

   virtual bool SupportsAutocapitalize() const = 0;
   virtual const AtomicString& DefaultAutocapitalize() const = 0;
   const AtomicString& autocapitalize() const;
   void setAutocapitalize(const AtomicString&);

   int maxLength() const;
   int minLength() const;
   void setMaxLength(int, ExceptionState&);
   void setMinLength(int, ExceptionState&);

   // Dispatch 'change' event if the value is updated.
   void DispatchFormControlChangeEvent();
   // Enqueue 'change' event if the value is updated.
   void EnqueueChangeEvent();
   // This should be called on every user-input, before the user-input changes
   // the value.
   void SetValueBeforeFirstUserEditIfNotSet();
   // This should be called on every user-input, after the user-input changed the
   // value. The argument is the updated value.
   void CheckIfValueWasReverted(const String&);
   void ClearValueBeforeFirstUserEdit();

   virtual String value() const = 0;
   virtual void setValue(
       const String&,
       TextFieldEventBehavior = kDispatchNoEvent,
       TextControlSetValueSelection =
           TextControlSetValueSelection::kSetSelectionToEnd) = 0;

   HTMLElement* InnerEditorElement() const;

   void SelectionChanged(bool user_triggered);
   bool LastChangeWasUserEdit() const;
   virtual void SetInnerEditorValue(const String&);
   String InnerEditorValue() const;
   Node* CreatePlaceholderBreakElement() const;

   String DirectionForFormData() const;

   virtual void SetSuggestedValue(const String& value);
   const String& SuggestedValue() const;

  protected:
   TextControlElement(const QualifiedName&, Document&);
   bool IsPlaceholderEmpty() const;
   virtual void UpdatePlaceholderText() = 0;
   virtual String GetPlaceholderValue() const = 0;

   void ParseAttribute(const AttributeModificationParams&) override;

   void RestoreCachedSelection();

   void DefaultEventHandler(Event*) override;
   virtual void SubtreeHasChanged() = 0;

   void SetLastChangeWasNotUserEdit() { last_change_was_user_edit_ = false; }
   void AddPlaceholderBreakElementIfNecessary();
   String ValueWithHardLineBreaks() const;

   void CopyNonAttributePropertiesFromElement(const Element&) override;

  private:
   unsigned ComputeSelectionStart() const;
   unsigned ComputeSelectionEnd() const;
   TextFieldSelectionDirection ComputeSelectionDirection() const;
   // Returns true if cached values and arguments are not same.
   bool CacheSelection(unsigned start,
                       unsigned end,
                       TextFieldSelectionDirection);
   static unsigned IndexForPosition(HTMLElement* inner_editor, const Position&);

   void DispatchFocusEvent(Element* old_focused_element,
                           WebFocusType,
                           InputDeviceCapabilities* source_capabilities) final;
   void DispatchBlurEvent(Element* new_focused_element,
                          WebFocusType,
                          InputDeviceCapabilities* source_capabilities) final;
   void ScheduleSelectEvent();

   // Returns true if user-editable value is empty. Used to check placeholder
   // visibility.
   virtual bool IsEmptyValue() const = 0;
   // Returns true if suggested value is empty. Used to check placeholder
   // visibility.
   bool IsEmptySuggestedValue() const { return SuggestedValue().IsEmpty(); }
   // Called in dispatchFocusEvent(), after placeholder process, before calling
   // parent's dispatchFocusEvent().
   virtual void HandleFocusEvent(Element* /* oldFocusedNode */, WebFocusType) {}
   // Called in dispatchBlurEvent(), after placeholder process, before calling
   // parent's dispatchBlurEvent().
   virtual void HandleBlurEvent() {}

   bool PlaceholderShouldBeVisible() const;

   // In m_valueBeforeFirstUserEdit, we distinguish a null String and zero-length
   // String. Null String means the field doesn't have any data yet, and
   // zero-length String is a valid data.
   String value_before_first_user_edit_;
   bool last_change_was_user_edit_;

   unsigned cached_selection_start_;
   unsigned cached_selection_end_;
   TextFieldSelectionDirection cached_selection_direction_;

   String suggested_value_;
   String value_before_set_suggested_value_;

   FRIEND_TEST_ALL_PREFIXES(TextControlElementTest, IndexForPosition);
 };

 inline bool IsTextControlElement(const Element& element) {
   return element.IsTextControl();
 }

 DEFINE_HTMLELEMENT_TYPE_CASTS_WITH_FUNCTION(TextControlElement);

 TextControlElement* EnclosingTextControl(const Position&);
 TextControlElement* EnclosingTextControl(const Node*);

 }  // namespace blink

 #endif
	/*
	* Copyright (C) 1999 Lars Knoll (knoll@kde.org)
	* (C) 1999 Antti Koivisto (koivisto@kde.org)
	* (C) 2000 Dirk Mueller (mueller@kde.org)
	* Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010 Apple Inc. All rights
	* reserved.
	* Copyright (C) 2009, 2010, 2011 Google Inc. All rights reserved.
	*
	* This library is free software; you can redistribute it and/or
	* modify it under the terms of the GNU Library General Public
	* License as published by the Free Software Foundation; either
	* version 2 of the License, or (at your option) any later version.
	*
	* This library is distributed in the hope that it will be useful,
	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	* Library General Public License for more details.
	*
	* You should have received a copy of the GNU Library General Public License
	* along with this library; see the file COPYING.LIB. If not, write to
	* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
	* Boston, MA 02110-1301, USA.
	*
	*/

	#ifndef TextControlElement_h
	#define TextControlElement_h

	#include "base/gtest_prod_util.h"
	#include "core/CoreExport.h"
	#include "core/editing/Forward.h"
	#include "core/html/HTMLFormControlElementWithState.h"
	#include "public/platform/WebFocusType.h"

	namespace blink {

	class ExceptionState;

	enum TextFieldSelectionDirection {
	kSelectionHasNoDirection,
	kSelectionHasForwardDirection,
	kSelectionHasBackwardDirection
	};
	enum TextFieldEventBehavior {
	kDispatchNoEvent,
	kDispatchChangeEvent,
	kDispatchInputAndChangeEvent
	};

	enum class TextControlSetValueSelection {
	kSetSelectionToEnd,
	kDoNotSet,
	};

	class CORE_EXPORT TextControlElement : public HTMLFormControlElementWithState {
	public:
	// Common flag for HTMLInputElement::tooLong(),
	// HTMLTextAreaElement::tooLong(),
	// HTMLInputElement::tooShort() and HTMLTextAreaElement::tooShort().
	enum NeedsToCheckDirtyFlag { kCheckDirtyFlag, kIgnoreDirtyFlag };

	~TextControlElement() override;

	void ForwardEvent(Event*);

	void SetFocused(bool, WebFocusType) override;

	// The derived class should return true if placeholder processing is needed.
	virtual bool IsPlaceholderVisible() const = 0;
	virtual void SetPlaceholderVisibility(bool) = 0;
	virtual bool SupportsPlaceholder() const = 0;
	String StrippedPlaceholder() const;
	HTMLElement* PlaceholderElement() const;
	void UpdatePlaceholderVisibility();

	VisiblePosition VisiblePositionForIndex(int) const;
	int IndexForVisiblePosition(const VisiblePosition&) const;
	unsigned selectionStart() const;
	unsigned selectionEnd() const;
	const AtomicString& selectionDirection() const;
	void setSelectionStart(unsigned);
	void setSelectionEnd(unsigned);
	void setSelectionDirection(const String&);
	void select();
	virtual void setRangeText(const String& replacement, ExceptionState&);
	virtual void setRangeText(const String& replacement,
	unsigned start,
	unsigned end,
	const String& selection_mode,
	ExceptionState&);
	// Web-exposed setSelectionRange() function. This schedule to dispatch
	// 'select' event.
	void setSelectionRangeForBinding(unsigned start,
	unsigned end,
	const String& direction = "none");
	// Blink-internal version of setSelectionRange(). This translates "none"
	// direction to "forward" on platforms without "none" direction.
	// This returns true if it updated cached selection and/or FrameSelection.
	bool SetSelectionRange(
	unsigned start,
	unsigned end,
	TextFieldSelectionDirection = kSelectionHasNoDirection);
	SelectionInDOMTree Selection() const;

	virtual bool SupportsAutocapitalize() const = 0;
	virtual const AtomicString& DefaultAutocapitalize() const = 0;
	const AtomicString& autocapitalize() const;
	void setAutocapitalize(const AtomicString&);

	int maxLength() const;
	int minLength() const;
	void setMaxLength(int, ExceptionState&);
	void setMinLength(int, ExceptionState&);

	// Dispatch 'change' event if the value is updated.
	void DispatchFormControlChangeEvent();
	// Enqueue 'change' event if the value is updated.
	void EnqueueChangeEvent();
	// This should be called on every user-input, before the user-input changes
	// the value.
	void SetValueBeforeFirstUserEditIfNotSet();
	// This should be called on every user-input, after the user-input changed the
	// value. The argument is the updated value.
	void CheckIfValueWasReverted(const String&);
	void ClearValueBeforeFirstUserEdit();

	virtual String value() const = 0;
	virtual void setValue(
	const String&,
	TextFieldEventBehavior = kDispatchNoEvent,
	TextControlSetValueSelection =
	TextControlSetValueSelection::kSetSelectionToEnd) = 0;

	HTMLElement* InnerEditorElement() const;

	void SelectionChanged(bool user_triggered);
	bool LastChangeWasUserEdit() const;
	virtual void SetInnerEditorValue(const String&);
	String InnerEditorValue() const;
	Node* CreatePlaceholderBreakElement() const;

	String DirectionForFormData() const;

	virtual void SetSuggestedValue(const String& value);
	const String& SuggestedValue() const;

	protected:
	TextControlElement(const QualifiedName&, Document&);
	bool IsPlaceholderEmpty() const;
	virtual void UpdatePlaceholderText() = 0;
	virtual String GetPlaceholderValue() const = 0;

	void ParseAttribute(const AttributeModificationParams&) override;

	void RestoreCachedSelection();

	void DefaultEventHandler(Event*) override;
	virtual void SubtreeHasChanged() = 0;

	void SetLastChangeWasNotUserEdit() { last_change_was_user_edit_ = false; }
	void AddPlaceholderBreakElementIfNecessary();
	String ValueWithHardLineBreaks() const;

	void CopyNonAttributePropertiesFromElement(const Element&) override;

	private:
	unsigned ComputeSelectionStart() const;
	unsigned ComputeSelectionEnd() const;
	TextFieldSelectionDirection ComputeSelectionDirection() const;
	// Returns true if cached values and arguments are not same.
	bool CacheSelection(unsigned start,
	unsigned end,
	TextFieldSelectionDirection);
	static unsigned IndexForPosition(HTMLElement* inner_editor, const Position&);

	void DispatchFocusEvent(Element* old_focused_element,
	WebFocusType,
	InputDeviceCapabilities* source_capabilities) final;
	void DispatchBlurEvent(Element* new_focused_element,
	WebFocusType,
	InputDeviceCapabilities* source_capabilities) final;
	void ScheduleSelectEvent();

	// Returns true if user-editable value is empty. Used to check placeholder
	// visibility.
	virtual bool IsEmptyValue() const = 0;
	// Returns true if suggested value is empty. Used to check placeholder
	// visibility.
	bool IsEmptySuggestedValue() const { return SuggestedValue().IsEmpty(); }
	// Called in dispatchFocusEvent(), after placeholder process, before calling
	// parent's dispatchFocusEvent().
	virtual void HandleFocusEvent(Element* /* oldFocusedNode */, WebFocusType) {}
	// Called in dispatchBlurEvent(), after placeholder process, before calling
	// parent's dispatchBlurEvent().
	virtual void HandleBlurEvent() {}

	bool PlaceholderShouldBeVisible() const;

	// In m_valueBeforeFirstUserEdit, we distinguish a null String and zero-length
	// String. Null String means the field doesn't have any data yet, and
	// zero-length String is a valid data.
	String value_before_first_user_edit_;
	bool last_change_was_user_edit_;

	unsigned cached_selection_start_;
	unsigned cached_selection_end_;
	TextFieldSelectionDirection cached_selection_direction_;

	String suggested_value_;
	String value_before_set_suggested_value_;

	FRIEND_TEST_ALL_PREFIXES(TextControlElementTest, IndexForPosition);
	};

	inline bool IsTextControlElement(const Element& element) {
	return element.IsTextControl();
	}

	DEFINE_HTMLELEMENT_TYPE_CASTS_WITH_FUNCTION(TextControlElement);

	TextControlElement* EnclosingTextControl(const Position&);
	TextControlElement* EnclosingTextControl(const Node*);

	} // namespace blink

	#endif