API Preview tool | The Dojo Toolkit

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
- summary
dojox.mobile.app.TextBox.attributeMap
- summary
dojox.mobile.app.TextBox.buildRendering
- type
```
Function
```
- source: [view]
     var node = this.srcNodeRef;
  
     // If an input is used as the source node, wrap it in a div
     if(!node || node.tagName != "INPUT"){
      node = dojo.create("input", {});
     }
  
     dojo.attr(node, {
      type: "text",
      value: dojo.attr(node, "value") || "",
      placeholder: this.placeHolder || null
     });
  
     this.domNode = this.textbox = this.focusNode = node;
- summary
dojox.mobile.app.TextBox._setPlaceHolderAttr
- type
```
Function
```
- parameters:
  - v: (typeof )
- source: [view]
     this.placeHolder = v;
     if(this.textbox){
      dojo.attr(this.textbox, "placeholder", v);
     }
- summary

dojox.mobile.app.TextBox._getValueAttr

type
```
Function
```
source: [view]
return this.parse(this.get('displayedValue'), this.constraints);
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().

dojox.mobile.app.TextBox._setValueAttr
- type
```
Function
```
- 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.
```
- source: [view]
     var filteredValue;
     if(value !== undefined){
      // TODO: this is calling filter() on both the display value and the actual value.
      // I added a comment to the filter() definition about this, but it should be changed.
      filteredValue = this.filter(value);
      if(typeof formattedValue != "string"){
       if(filteredValue !== null
         && ((typeof filteredValue != "number") || !isNaN(filteredValue))){
        formattedValue = this.filter(this.format(filteredValue, this.constraints));
       }else{ formattedValue = ''; }
      }
     }
     if(formattedValue != null && formattedValue != undefined
       && ((typeof formattedValue) != "number" || !isNaN(formattedValue))
       && this.textbox.value != formattedValue){
      this.textbox.value = formattedValue;
     }
  
     this.inherited(arguments, [filteredValue, priorityChange]);
- 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.
```

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.

dojox.mobile.app.TextBox._getDisplayedValueAttr

type
```
Function
```
source: [view]
return this.filter(this.textbox.value);
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)

dojox.mobile.app.TextBox._setDisplayedValueAttr
- type
```
Function
```
- parameters:
  - value: (typeof String)
- source: [view]
     if(value === null || value === undefined){ value = '' }
     else if(typeof value != "string"){ value = String(value) }
     this.textbox.value = value;
     this._setValueAttr(this.get('value'), undefined, value);
- 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.
```
dojox.mobile.app.TextBox.format
- type
```
Function
```
- parameters:
  - value: (typeof String)
  - constraints: (typeof Object)
- source: [view]
  return ((value == null || value == undefined) ? "" : (value.toString ? value.toString() : value));
- summary
```
Replacable function to convert a value to a properly formatted string.
```
- tags:
dojox.mobile.app.TextBox.parse
- type
```
Function
```
- parameters:
  - value: (typeof String)
  - constraints: (typeof Object)
- source: [view]
  return value; // String
- summary
```
Replacable function to convert a formatted string to a value
```
- tags:
- returns
```
String
```
dojox.mobile.app.TextBox._refreshState
- type
```
Function
```
- source: [view]
     // summary:
     //  After the user types some characters, etc., this method is
     //  called to check the field for validity etc. The base method
     //  in `dijit.form.TextBox` does nothing, but subclasses override.
     // tags:
     //  protected
- summary
```
After the user types some characters, etc., this method is
called to check the field for validity etc.  The base method
in `dijit.form.TextBox` does nothing, but subclasses override.
```
- tags:
dojox.mobile.app.TextBox._onInput
- type
```
Function
```
- parameters:
  - e: (typeof )
- source: [view]
     if(e && e.type && /key/i.test(e.type) && e.keyCode){
      switch(e.keyCode){
       case dojo.keys.SHIFT:
       case dojo.keys.ALT:
       case dojo.keys.CTRL:
       case dojo.keys.TAB:
        return;
      }
     }
     if(this.intermediateChanges){
      var _this = this;
      // the setTimeout allows the key to post to the widget input box
      setTimeout(function(){ _this._handleOnChange(_this.get('value'), false); }, 0);
     }
     this._refreshState();
- summary
dojox.mobile.app.TextBox.postCreate
- type
```
Function
```
- source: [view]
  dojo.provide("dojox.mobile.app.TextBox");
  dojo.experimental("dojox.mobile.app.TextBox");
  
  dojo.require("dojox.mobile.app._Widget");
  dojo.require("dojox.mobile.app._FormWidget");
  
  dojo.declare(
  "dojox.mobile.app.TextBox",
  dojox.mobile.app._FormValueWidget, {
  
    // summary:
    //  A base class for textbox form inputs
  
    // trim: Boolean
    //  Removes leading and trailing whitespace if true. Default is false.
    trim: false,
  
    // uppercase: Boolean
    //  Converts all characters to uppercase if true. Default is false.
    uppercase: false,
  
    // lowercase: Boolean
    //  Converts all characters to lowercase if true. Default is false.
    lowercase: false,
  
    // propercase: Boolean
    //  Converts the first character of each word to uppercase if true.
    propercase: false,
  
    // maxLength: String
    //  HTML INPUT tag maxLength declaration.
    maxLength: "",
  
    // selectOnClick: [const] Boolean
    //  If true, all text will be selected when focused with mouse
    selectOnClick: false,
  
    // placeHolder: String
    //  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).
    placeHolder: "",
  
    baseClass: "mblTextBox",
  
    attributeMap: dojo.delegate(dojox.mobile.app._FormValueWidget.prototype.attributeMap, {
     maxLength: "focusNode"
    }),
  
    buildRendering: function(){
     var node = this.srcNodeRef;
  
     // If an input is used as the source node, wrap it in a div
     if(!node || node.tagName != "INPUT"){
      node = dojo.create("input", {});
     }
  
     dojo.attr(node, {
      type: "text",
      value: dojo.attr(node, "value") || "",
      placeholder: this.placeHolder || null
     });
  
     this.domNode = this.textbox = this.focusNode = node;
    },
  
    _setPlaceHolderAttr: function(v){
     this.placeHolder = v;
     if(this.textbox){
      dojo.attr(this.textbox, "placeholder", v);
     }
    },
  
    _getValueAttr: function(){
     // summary:
     //  Hook so attr('value') works as we like.
     // description:
     //  For `dijit.form.TextBox` this basically returns the value of the .
     //
     //  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().
     return this.parse(this.get('displayedValue'), this.constraints);
    },
  
    _setValueAttr: function(value, /*Boolean?*/ priorityChange, /*String?*/ formattedValue){
     // 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.
     //
     // value:
     //  The visual element value is also set to a corresponding,
     //  but not necessarily the same, value.
     //
     // formattedValue:
     //  If specified, used to set the visual element value,
     //  otherwise a computed visual value is used.
     //
     // priorityChange:
     //  If true, an onChange event is fired immediately instead of
     //  waiting for the next blur event.
  
     var filteredValue;
     if(value !== undefined){
      // TODO: this is calling filter() on both the display value and the actual value.
      // I added a comment to the filter() definition about this, but it should be changed.
      filteredValue = this.filter(value);
      if(typeof formattedValue != "string"){
       if(filteredValue !== null
         && ((typeof filteredValue != "number") || !isNaN(filteredValue))){
        formattedValue = this.filter(this.format(filteredValue, this.constraints));
       }else{ formattedValue = ''; }
      }
     }
     if(formattedValue != null && formattedValue != undefined
       && ((typeof formattedValue) != "number" || !isNaN(formattedValue))
       && this.textbox.value != formattedValue){
      this.textbox.value = formattedValue;
     }
  
     this.inherited(arguments, [filteredValue, priorityChange]);
    },
  
    // displayedValue: String
    //  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.
    displayedValue: "",
  
    _getDisplayedValueAttr: function(){
     // 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)
  
     return this.filter(this.textbox.value);
    },
  
    _setDisplayedValueAttr: function(/*String*/value){
     // 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.
  
     if(value === null || value === undefined){ value = '' }
     else if(typeof value != "string"){ value = String(value) }
     this.textbox.value = value;
     this._setValueAttr(this.get('value'), undefined, value);
    },
  
    format: function(/* String */ value, /* Object */ constraints){
     // summary:
     //  Replacable function to convert a value to a properly formatted string.
     // tags:
     //  protected extension
     return ((value == null || value == undefined) ? "" : (value.toString ? value.toString() : value));
    },
  
    parse: function(/* String */ value, /* Object */ constraints){
     // summary:
     //  Replacable function to convert a formatted string to a value
     // tags:
     //  protected extension
  
     return value; // String
    },
  
    _refreshState: function(){
     // summary:
     //  After the user types some characters, etc., this method is
     //  called to check the field for validity etc. The base method
     //  in `dijit.form.TextBox` does nothing, but subclasses override.
     // tags:
     //  protected
    },
  
    _onInput: function(e){
     if(e && e.type && /key/i.test(e.type) && e.keyCode){
      switch(e.keyCode){
       case dojo.keys.SHIFT:
       case dojo.keys.ALT:
       case dojo.keys.CTRL:
       case dojo.keys.TAB:
        return;
      }
     }
     if(this.intermediateChanges){
      var _this = this;
      // the setTimeout allows the key to post to the widget input box
      setTimeout(function(){ _this._handleOnChange(_this.get('value'), false); }, 0);
     }
     this._refreshState();
    },
  
    postCreate: function(){
     // setting the value here is needed since value="" in the template causes "undefined"
     // and setting in the DOM (instead of the JS object) helps with form reset actions
  
     this.textbox.setAttribute("value", this.textbox.value); // DOM and JS values shuld be the same
     this.inherited(arguments);
     if(dojo.isMoz || dojo.isOpera){
      this.connect(this.textbox, "oninput", this._onInput);
     }else{
      this.connect(this.textbox, "onkeydown", this._onInput);
      this.connect(this.textbox, "onkeyup", this._onInput);
      this.connect(this.textbox, "onpaste", this._onInput);
      this.connect(this.textbox, "oncut", this._onInput);
     }
- returns
```
String
```
- summary
dojox.mobile.app.TextBox._blankValue
- summary

dojox.mobile.app.TextBox.filter

type
```
Function
```
parameters:
- val: (typeof )
source: [view]
   if(val === null){ return this._blankValue; }
   if(typeof val != "string"){ return val; }
   if(this.trim){
    val = dojo.trim(val);
   }
   if(this.uppercase){
    val = val.toUpperCase();
   }
   if(this.lowercase){
    val = val.toLowerCase();
   }
   if(this.propercase){
    val = val.replace(/[^\s]+/g, function(word){
     return word.substring(0,1).toUpperCase() + word.substring(1);
    });
   }
   return 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:

dojox.mobile.app.TextBox._setBlurValue
- type
```
Function
```
- source: [view]
  this._setValueAttr(this.get('value'), true);
- summary
dojox.mobile.app.TextBox._onBlur
- type
```
Function
```
- parameters:
  - e: (typeof )
- source: [view]
     if(this.disabled){ return; }
     this._setBlurValue();
     this.inherited(arguments);
  
     if(this._selectOnClickHandle){
      this.disconnect(this._selectOnClickHandle);
     }
     if(this.selectOnClick && dojo.isMoz){
      this.textbox.selectionStart = this.textbox.selectionEnd = undefined; // clear selection so that the next mouse click doesn't reselect
     }
- summary
dojox.mobile.app.TextBox._onFocus
- type
```
Function
```
- parameters:
  - by: (typeof String)
- source: [view]
     if(this.disabled || this.readOnly){ return; }
  
     // Select all text on focus via click if nothing already selected.
     // Since mouse-up will clear the selection need to defer selection until after mouse-up.
     // Don't do anything on focus by tabbing into the widget since there's no associated mouse-up event.
     if(this.selectOnClick && by == "mouse"){
      this._selectOnClickHandle = this.connect(this.domNode, "onmouseup", function(){
       // Only select all text on first click; otherwise users would have no way to clear
       // the selection.
       this.disconnect(this._selectOnClickHandle);
  
       // Check if the user selected some text manually (mouse-down, mouse-move, mouse-up)
       // and if not, then select all the text
       var textIsNotSelected;
       textIsNotSelected = this.textbox.selectionStart == this.textbox.selectionEnd;
       if(textIsNotSelected){
        this.selectInputText(this.textbox);
       }
      });
     }
  
     this._refreshState();
     this.inherited(arguments);
- summary
dojox.mobile.app.TextBox.reset
- type
```
Function
```
- source: [view]
  dojo.provide("dojox.mobile.app.TextBox");
  dojo.experimental("dojox.mobile.app.TextBox");
  
  dojo.require("dojox.mobile.app._Widget");
  dojo.require("dojox.mobile.app._FormWidget");
  
  dojo.declare(
  "dojox.mobile.app.TextBox",
  dojox.mobile.app._FormValueWidget, {
  
    // summary:
    //  A base class for textbox form inputs
  
    // trim: Boolean
    //  Removes leading and trailing whitespace if true. Default is false.
    trim: false,
  
    // uppercase: Boolean
    //  Converts all characters to uppercase if true. Default is false.
    uppercase: false,
  
    // lowercase: Boolean
    //  Converts all characters to lowercase if true. Default is false.
    lowercase: false,
  
    // propercase: Boolean
    //  Converts the first character of each word to uppercase if true.
    propercase: false,
  
    // maxLength: String
    //  HTML INPUT tag maxLength declaration.
    maxLength: "",
  
    // selectOnClick: [const] Boolean
    //  If true, all text will be selected when focused with mouse
    selectOnClick: false,
  
    // placeHolder: String
    //  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).
    placeHolder: "",
  
    baseClass: "mblTextBox",
  
    attributeMap: dojo.delegate(dojox.mobile.app._FormValueWidget.prototype.attributeMap, {
     maxLength: "focusNode"
    }),
  
    buildRendering: function(){
     var node = this.srcNodeRef;
  
     // If an input is used as the source node, wrap it in a div
     if(!node || node.tagName != "INPUT"){
      node = dojo.create("input", {});
     }
  
     dojo.attr(node, {
      type: "text",
      value: dojo.attr(node, "value") || "",
      placeholder: this.placeHolder || null
     });
  
     this.domNode = this.textbox = this.focusNode = node;
    },
  
    _setPlaceHolderAttr: function(v){
     this.placeHolder = v;
     if(this.textbox){
      dojo.attr(this.textbox, "placeholder", v);
     }
    },
  
    _getValueAttr: function(){
     // summary:
     //  Hook so attr('value') works as we like.
     // description:
     //  For `dijit.form.TextBox` this basically returns the value of the .
     //
     //  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().
     return this.parse(this.get('displayedValue'), this.constraints);
    },
  
    _setValueAttr: function(value, /*Boolean?*/ priorityChange, /*String?*/ formattedValue){
     // 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.
     //
     // value:
     //  The visual element value is also set to a corresponding,
     //  but not necessarily the same, value.
     //
     // formattedValue:
     //  If specified, used to set the visual element value,
     //  otherwise a computed visual value is used.
     //
     // priorityChange:
     //  If true, an onChange event is fired immediately instead of
     //  waiting for the next blur event.
  
     var filteredValue;
     if(value !== undefined){
      // TODO: this is calling filter() on both the display value and the actual value.
      // I added a comment to the filter() definition about this, but it should be changed.
      filteredValue = this.filter(value);
      if(typeof formattedValue != "string"){
       if(filteredValue !== null
         && ((typeof filteredValue != "number") || !isNaN(filteredValue))){
        formattedValue = this.filter(this.format(filteredValue, this.constraints));
       }else{ formattedValue = ''; }
      }
     }
     if(formattedValue != null && formattedValue != undefined
       && ((typeof formattedValue) != "number" || !isNaN(formattedValue))
       && this.textbox.value != formattedValue){
      this.textbox.value = formattedValue;
     }
  
     this.inherited(arguments, [filteredValue, priorityChange]);
    },
  
    // displayedValue: String
    //  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.
    displayedValue: "",
  
    _getDisplayedValueAttr: function(){
     // 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)
  
     return this.filter(this.textbox.value);
    },
  
    _setDisplayedValueAttr: function(/*String*/value){
     // 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.
  
     if(value === null || value === undefined){ value = '' }
     else if(typeof value != "string"){ value = String(value) }
     this.textbox.value = value;
     this._setValueAttr(this.get('value'), undefined, value);
    },
  
    format: function(/* String */ value, /* Object */ constraints){
     // summary:
     //  Replacable function to convert a value to a properly formatted string.
     // tags:
     //  protected extension
     return ((value == null || value == undefined) ? "" : (value.toString ? value.toString() : value));
    },
  
    parse: function(/* String */ value, /* Object */ constraints){
     // summary:
     //  Replacable function to convert a formatted string to a value
     // tags:
     //  protected extension
  
     return value; // String
    },
  
    _refreshState: function(){
     // summary:
     //  After the user types some characters, etc., this method is
     //  called to check the field for validity etc. The base method
     //  in `dijit.form.TextBox` does nothing, but subclasses override.
     // tags:
     //  protected
    },
  
    _onInput: function(e){
     if(e && e.type && /key/i.test(e.type) && e.keyCode){
      switch(e.keyCode){
       case dojo.keys.SHIFT:
       case dojo.keys.ALT:
       case dojo.keys.CTRL:
       case dojo.keys.TAB:
        return;
      }
     }
     if(this.intermediateChanges){
      var _this = this;
      // the setTimeout allows the key to post to the widget input box
      setTimeout(function(){ _this._handleOnChange(_this.get('value'), false); }, 0);
     }
     this._refreshState();
    },
  
    postCreate: function(){
     // setting the value here is needed since value="" in the template causes "undefined"
     // and setting in the DOM (instead of the JS object) helps with form reset actions
  
     this.textbox.setAttribute("value", this.textbox.value); // DOM and JS values shuld be the same
     this.inherited(arguments);
     if(dojo.isMoz || dojo.isOpera){
      this.connect(this.textbox, "oninput", this._onInput);
     }else{
      this.connect(this.textbox, "onkeydown", this._onInput);
      this.connect(this.textbox, "onkeyup", this._onInput);
      this.connect(this.textbox, "onpaste", this._onInput);
      this.connect(this.textbox, "oncut", this._onInput);
     }
    },
  
    _blankValue: '', // if the textbox is blank, what value should be reported
    filter: function(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:
     //  protected extension
     if(val === null){ return this._blankValue; }
     if(typeof val != "string"){ return val; }
     if(this.trim){
      val = dojo.trim(val);
     }
     if(this.uppercase){
      val = val.toUpperCase();
     }
     if(this.lowercase){
      val = val.toLowerCase();
     }
     if(this.propercase){
      val = val.replace(/[^\s]+/g, function(word){
       return word.substring(0,1).toUpperCase() + word.substring(1);
      });
     }
     return val;
    },
  
    _setBlurValue: function(){
     this._setValueAttr(this.get('value'), true);
    },
  
    _onBlur: function(e){
     if(this.disabled){ return; }
     this._setBlurValue();
     this.inherited(arguments);
  
     if(this._selectOnClickHandle){
      this.disconnect(this._selectOnClickHandle);
     }
     if(this.selectOnClick && dojo.isMoz){
      this.textbox.selectionStart = this.textbox.selectionEnd = undefined; // clear selection so that the next mouse click doesn't reselect
     }
  
    },
  
    _onFocus: function(/*String*/ by){
     if(this.disabled || this.readOnly){ return; }
  
     // Select all text on focus via click if nothing already selected.
     // Since mouse-up will clear the selection need to defer selection until after mouse-up.
     // Don't do anything on focus by tabbing into the widget since there's no associated mouse-up event.
     if(this.selectOnClick && by == "mouse"){
      this._selectOnClickHandle = this.connect(this.domNode, "onmouseup", function(){
       // Only select all text on first click; otherwise users would have no way to clear
       // the selection.
       this.disconnect(this._selectOnClickHandle);
  
       // Check if the user selected some text manually (mouse-down, mouse-move, mouse-up)
       // and if not, then select all the text
       var textIsNotSelected;
       textIsNotSelected = this.textbox.selectionStart == this.textbox.selectionEnd;
       if(textIsNotSelected){
        this.selectInputText(this.textbox);
       }
      });
     }
  
     this._refreshState();
     this.inherited(arguments);
    },
  
    reset: function(){
     // Overrides dijit._FormWidget.reset().
     // Additionally resets the displayed textbox value to ''
     this.textbox.value = '';
     this.inherited(arguments);
- returns
```
String
```
- summary
dojox.mobile.app.TextBox.domNode
- summary
dojox.mobile.app.TextBox.textbox.value
- summary
dojox.mobile.app.TextBox.textbox.selectionStart
- summary
dojox.mobile.app.TextBox._selectOnClickHandle
- summary
dojox.mobile.app
- type
```
Object
```
- summary
dojox.mobile
- type
```
Object
```
- summary
dojox
- type
```
Object
```
- summary

dojox/mobile/app/TextBox.js

Provides:

Requires:

dojox.mobile.app.TextBox

dojox.mobile.app.TextBox.trim

dojox.mobile.app.TextBox.uppercase

dojox.mobile.app.TextBox.lowercase

dojox.mobile.app.TextBox.propercase

dojox.mobile.app.TextBox.maxLength

dojox.mobile.app.TextBox.selectOnClick

dojox.mobile.app.TextBox.placeHolder

dojox.mobile.app.TextBox.baseClass

dojox.mobile.app.TextBox.attributeMap

dojox.mobile.app.TextBox.buildRendering

dojox.mobile.app.TextBox._setPlaceHolderAttr

dojox.mobile.app.TextBox._getValueAttr

dojox.mobile.app.TextBox._setValueAttr

dojox.mobile.app.TextBox.displayedValue

dojox.mobile.app.TextBox._getDisplayedValueAttr

dojox.mobile.app.TextBox._setDisplayedValueAttr

dojox.mobile.app.TextBox.format

dojox.mobile.app.TextBox.parse

dojox.mobile.app.TextBox._refreshState

dojox.mobile.app.TextBox._onInput

dojox.mobile.app.TextBox.postCreate

dojox.mobile.app.TextBox._blankValue

dojox.mobile.app.TextBox.filter

dojox.mobile.app.TextBox._setBlurValue

dojox.mobile.app.TextBox._onBlur

dojox.mobile.app.TextBox._onFocus

dojox.mobile.app.TextBox.reset

dojox.mobile.app.TextBox.domNode

dojox.mobile.app.TextBox.textbox.value

dojox.mobile.app.TextBox.textbox.selectionStart

dojox.mobile.app.TextBox._selectOnClickHandle

dojox.mobile.app

dojox.mobile

dojox