dojox/mobile/app/TextBox.js

• Provides:

  • dojox.mobile.app.TextBox

• Requires:

  • dojox.mobile.app._Widget in common
  • dojox.mobile.app._FormWidget in common

• dojox.mobile.app.TextBox

  • type

    Function

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

    A base class for textbox form inputs

• dojox.mobile.app.TextBox.trim

  • type

    Boolean

  • summary

    Removes leading and trailing whitespace if true.  Default is false.

• dojox.mobile.app.TextBox.uppercase

  • type

    Boolean

  • summary

    Converts all characters to uppercase if true.  Default is false.

• dojox.mobile.app.TextBox.lowercase

  • type

    Boolean

  • summary

    Converts all characters to lowercase if true.  Default is false.

• dojox.mobile.app.TextBox.propercase

  • type

    Boolean

  • summary

    Converts the first character of each word to uppercase if true.

• dojox.mobile.app.TextBox.maxLength

  • type

    String

  • summary

    HTML INPUT tag maxLength declaration.

• dojox.mobile.app.TextBox.selectOnClick

  • tags: const
  • type

    Boolean

  • summary

    If true, all text will be selected when focused with mouse

• dojox.mobile.app.TextBox.placeHolder

  • type

    String

  • summary

    Defines a hint to help users fill out the input field (as defined in HTML 5).
    This should only contain plain text (no html markup).

• dojox.mobile.app.TextBox.baseClass

  • type

    String

• dojox.mobile.app.TextBox.attributeMap

  • type

    Object

• dojox.mobile.app.TextBox.buildRendering

  • type

    Function

• dojox.mobile.app.TextBox.domNode

• dojox.mobile.app.TextBox.textbox

• dojox.mobile.app.TextBox.focusNode

• dojox.mobile.app.TextBox._setPlaceHolderAttr

  • parameters:
    • v
  • type

    Function

• dojox.mobile.app.TextBox._getValueAttr

  • summary

    Hook so attr('value') works as we like.

  • description

    For `dijit.form.TextBox` this basically returns the value of the <input>.
    
    For `dijit.form.MappedTextBox` subclasses, which have both
    a "displayed value" and a separate "submit value",
    This treats the "displayed value" as the master value, computing the
    submit value from it via this.parse().

  • type

    Function

• dojox.mobile.app.TextBox._setValueAttr

  • parameters:
    • value: (typeof The)

      visual element value is also set to a corresponding,
      but not necessarily the same, value.

    • priorityChange: (typeof Boolean)

      If true, an onChange event is fired immediately instead of
      waiting for the next blur event.

    • formattedValue: (typeof String)

      If specified, used to set the visual element value,
      otherwise a computed visual value is used.

  • summary

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

  • description

    Sets the value of the widget to "value" which can be of
    any type as determined by the widget.

  • type

    Function

• dojox.mobile.app.TextBox.textbox.value

  • type

    String

• dojox.mobile.app.TextBox.displayedValue

  • type

    String

  • summary

    For subclasses like ComboBox where the displayed value
    (ex: Kentucky) and the serialized value (ex: KY) are different,
    this represents the displayed value.
    
    Setting 'displayedValue' through attr('displayedValue', ...)
    updates 'value', and vice-versa.  Otherwise 'value' is updated
    from 'displayedValue' periodically, like onBlur etc.
    
    TODO: move declaration to MappedTextBox?
    Problem is that ComboBox references displayedValue,
    for benefit of FilteringSelect.
    
    
    if the textbox is blank, what value should be reported

• dojox.mobile.app.TextBox._getDisplayedValueAttr

  • summary

    Hook so attr('displayedValue') works.

  • description

    Returns the displayed value (what the user sees on the screen),
    after filtering (ie, trimming spaces etc.).
    
    For some subclasses of TextBox (like ComboBox), the displayed value
    is different from the serialized value that's actually
    sent to the server (see dijit.form.ValidationTextBox.serialize)

  • type

    Function

• dojox.mobile.app.TextBox._setDisplayedValueAttr

  • parameters:
    • value: (typeof String)
  • summary

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

  • description

    Sets the value of the visual element to the string "value".
    The widget value is also set to a corresponding,
    but not necessarily the same, value.

  • type

    Function

• dojox.mobile.app.TextBox.format

  • parameters:
    • value: (typeof String)
    • constraints: (typeof Object)
  • summary

    Replacable function to convert a value to a properly formatted string.

  • tags: extension
  • type

    Function

• dojox.mobile.app.TextBox.parse

  • parameters:
    • value: (typeof String)
    • constraints: (typeof Object)
  • returns

    String

  • summary

    Replacable function to convert a formatted string to a value

  • tags: extension
  • type

    Function

• dojox.mobile.app.TextBox._refreshState

  • summary

    After the user types some characters, etc., this method is
    called to check the field for validity etc.  The base method
    in <code>dijit.form.TextBox</code> does nothing, but subclasses override.

  • tags:
  • type

    Function

• dojox.mobile.app.TextBox._onInput

  • parameters:
    • e
  • type

    Function

• dojox.mobile.app.TextBox.postCreate

  • type

    Function

• dojox.mobile.app.TextBox._blankValue

  • type

    String

• dojox.mobile.app.TextBox.filter

  • parameters:
    • val
  • summary

    Auto-corrections (such as trimming) that are applied to textbox
    value on blur or form submit.

  • description

    For MappedTextBox subclasses, this is called twice
    - once with the display value
    - once the value as set/returned by attr('value', ...)
    and attr('value'), ex: a Number for NumberTextBox.
    
    In the latter case it does corrections like converting null to NaN.  In
    the former case the NumberTextBox.filter() method calls this.inherited()
    to execute standard trimming code in TextBox.filter().
    
    TODO: break this into two methods in 2.0

  • tags: extension
  • type

    Function

• dojox.mobile.app.TextBox._setBlurValue

  • type

    Function

• dojox.mobile.app.TextBox._onBlur

  • parameters:
    • e
  • type

    Function

• dojox.mobile.app.TextBox.textbox.selectionStart

  • type

    Object

• dojox.mobile.app.TextBox.textbox.selectionEnd

  • type

    Object

• dojox.mobile.app.TextBox._onFocus

  • parameters:
    • by: (typeof String)
  • type

    Function

• dojox.mobile.app.TextBox._selectOnClickHandle

  • type

    Object

• dojox.mobile.app.TextBox.reset

  • type

    Function

• dojox.mobile.app

  • type

    Object

• dojox.mobile

  • type

    Object

• dojox

  • type

    Object