dojox/mobile/app/_FormWidget.js

• Provides:

  • dojox.mobile.app._FormWidget

• Requires:

  • dojo.window in common
  • dijit._WidgetBase in common

• dojox.mobile.app._FormWidget

  • type

    Function

  • chains:
    • dijit._WidgetBase: (prototype)
    • dijit._WidgetBase: (call)
  • summary

    Base class for widgets corresponding to native HTML elements such as <checkbox> or <button>,
    which can be children of a &lt;form&gt; node or a <code>dojox.mobile.app.Form</code> widget.

  • description

    Represents a single HTML element.
    All these widgets should have these attributes just like native HTML input elements.
    You can set them during widget construction or afterwards, via `dijit._WidgetBase.attr`.
    
    They also share some common methods.

• dojox.mobile.app._FormWidget.name

  • type

    String

  • summary

    Name used when submitting form; same as "name" attribute or plain HTML elements

• dojox.mobile.app._FormWidget.alt

  • type

    String

  • summary

    Corresponds to the native HTML <input> element's attribute.

• dojox.mobile.app._FormWidget.value

  • type

    String

  • summary

    Corresponds to the native HTML <input> element's attribute.

• dojox.mobile.app._FormWidget.type

  • type

    String

  • summary

    Corresponds to the native HTML <input> element's attribute.

• dojox.mobile.app._FormWidget.disabled

  • type

    Boolean

  • summary

    Should this widget respond to user input?
    In markup, this is specified as "disabled='disabled'", or just "disabled".

• dojox.mobile.app._FormWidget.intermediateChanges

  • type

    Boolean

  • summary

    Fires onChange for each value change or only on demand

• dojox.mobile.app._FormWidget.scrollOnFocus

  • type

    Boolean

  • summary

    On focus, should this widget scroll into view?

• dojox.mobile.app._FormWidget.attributeMap

  • type

    Object

• dojox.mobile.app._FormWidget.postMixInProperties

  • type

    Function

• dojox.mobile.app._FormWidget.nameAttrSetting

• dojox.mobile.app._FormWidget.postCreate

  • type

    Function

• dojox.mobile.app._FormWidget._setDisabledAttr

  • parameters:
    • value: (typeof Boolean)
  • type

    Function

• dojox.mobile.app._FormWidget._onFocus

  • parameters:
    • e
  • type

    Function

• dojox.mobile.app._FormWidget.isFocusable

  • summary

    Tells if this widget is focusable or not.   Used internally by dijit.

  • tags:
  • type

    Function

• dojox.mobile.app._FormWidget.focus

  • summary

    Put focus on this widget

  • type

    Function

• dojox.mobile.app._FormWidget.compare

  • parameters:
    • val1: (typeof anything)
    • val2: (typeof anything)
  • summary

    Compare 2 values (as returned by attr('value') for this widget).

  • tags:
  • type

    Function

• dojox.mobile.app._FormWidget.onChange

  • parameters:
    • newValue
  • summary

    Callback when this widget's value is changed.

  • tags: callback
  • type

    Function

• dojox.mobile.app._FormWidget._onChangeActive

  • tags:
  • type

    Boolean

  • summary

    Indicates that changes to the value should call onChange() callback.
    This is false during widget initialization, to avoid calling onChange()
    when the initial value is set.

• dojox.mobile.app._FormWidget._handleOnChange

  • parameters:
    • newValue: (typeof anything)

      the new value

    • priorityChange: (typeof Boolean)

      For a slider, for example, dragging the slider is priorityChange==false,
      but on mouse up, it's priorityChange==true.  If intermediateChanges==true,
      onChange is only called form priorityChange=true events.

  • summary

    Called when the value of the widget is set.  Calls onChange() if appropriate

  • tags:
  • type

    Function

• dojox.mobile.app._FormWidget._lastValue

• dojox.mobile.app._FormWidget._resetValue

• dojox.mobile.app._FormWidget._lastValueReported

• dojox.mobile.app._FormWidget._onChangeHandle

  • type

    Object

• dojox.mobile.app._FormWidget.create

  • type

    Function

• dojox.mobile.app._FormWidget.destroy

  • type

    Function

• dojox.mobile.app._FormWidget._onMouseDown

  • parameters:
    • e
  • type

    Function

• dojox.mobile.app._FormWidget.selectInputText

  • parameters:
    • element: (typeof DomNode)
    • start: (typeof Number)
    • stop: (typeof Number)
  • summary

    Select text in the input element argument, from start (default 0), to stop (default end).

  • type

    Function

• dojox.mobile.app._FormValueWidget

  • type

    Function

  • chains:
    • dojox.mobile.app._FormWidget: (prototype)
    • dojox.mobile.app._FormWidget: (call)
  • summary

    Base class for widgets corresponding to native HTML elements such as <input> or <select> that have user changeable values.

  • description

    Each _FormValueWidget represents a single input value, and has a (possibly hidden) <input> element,
    to which it serializes it's input value, so that form submission (either normal submission or via FormBind?)
    works as expected.

• dojox.mobile.app._FormValueWidget.readOnly

  • type

    Boolean

  • summary

    Should this widget respond to user input?
    In markup, this is specified as "readOnly".
    Similar to disabled except readOnly form values are submitted.

• dojox.mobile.app._FormValueWidget.attributeMap

  • type

    Object

• dojox.mobile.app._FormValueWidget._setReadOnlyAttr

  • parameters:
    • value: (typeof Boolean)
  • type

    Function

• dojox.mobile.app._FormValueWidget.postCreate

  • type

    Function

• dojox.mobile.app._FormValueWidget._resetValue

• dojox.mobile.app._FormValueWidget._setValueAttr

  • parameters:
    • newValue: (typeof anything)
    • priorityChange: (typeof Boolean,)

      optional

  • summary

    Hook so attr('value', value) works.

  • description

    Sets the value of the widget.
    If the value has changed, then fire onChange event, unless priorityChange
    is specified as null (or false?)

  • type

    Function

• dojox.mobile.app._FormValueWidget.value

• dojox.mobile.app._FormValueWidget._getValueAttr

  • summary

    Hook so attr('value') works.

  • type

    Function

• dojox.mobile.app._FormValueWidget.undo

  • summary

    Restore the value to the last value passed to onChange

  • type

    Function

• dojox.mobile.app._FormValueWidget.reset

  • summary

    Reset the widget's value to what it was at initialization time

  • type

    Function

• dojox.mobile.app._FormValueWidget._hasBeenBlurred

  • type

    bool

• dojox.mobile.app

  • type

    Object

• dojox.mobile

  • type

    Object

• dojox

  • type

    Object