Class: TextField

TextField()

The TextField is the base method of inputting just a string that is bound to a ``. It does introduce: * Clear button - adds a small x buton to clear the input * Option to only allow valid input at each keypress

Constructor

new TextField()

Source:
Requires:
  • module:argos.FieldManager
Example
{
        name: 'LastName',
        property: 'LastName',
        label: this.lastNameText,
        type: 'text',
    }

Extends

Requires

  • module:argos.FieldManager

Members

alwaysUseValue

Properties:
Name Type Description
Signifies Boolean that the field should always be included when the form calls getValues.
Inherited From:
Source:

applyTo

Properties:
Name Type Description
If String defined it will use the applyTo string when getting and setting properties from the SData object instead of the `property` property.
Inherited From:
Source:

attributeMap

Properties:
Name Type Description
Creates Object a setter map to html nodes, namely: * inputValue => inputNode's value attribute
Source:

autoFocus

Properties:
Name Type Description
Flag Boolean to indicate if this field should be focused when the form is shown.
Inherited From:
Source:

clearNode

Properties:
Name Type Description
The HTMLElement dojo-attach-point reference to the clear button
Source:

containerNode

Properties:
Name Type Description
The HTMLElement parent container element of the field.
Inherited From:
Source:

default

This applies a default value when inserting a new record, the default value is applied after the template entry but before the context and changes are applied. Note the word `default` must be in quotes as default is a reserved word in javascript.
Inherited From:
Source:

disabled

Properties:
Name Type Description
Indicates Boolean the disabled state
Inherited From:
Source:

enableClearButton

Source:

hidden

Properties:
Name Type Description
Indicates Boolean the visibility state
Inherited From:
Source:

inputNode

Properties:
Name Type Description
The HTMLElement dojo-attach-point reference to the input element
Source:

inputType

Source:

label

Properties:
Name Type Description
The String text that will, by default, show to the left of a field.
Inherited From:
Source:

name

Properties:
Name Type Description
The String unique (within the current form) name of the field
Inherited From:
Source:

notificationTrigger

Source:

originalValue

Properties:
Name Type Description
Value String storage for keeping track of modified/unmodified values. Used in isDirty.
Source:

owner

Properties:
Name Type Description
View View that controls the field.
Inherited From:
Source:

previousValue

Properties:
Name Type Description
Value String storage for detecting changes either via direct input or programmatic setting.
Source:

property

Properties:
Name Type Description
The String SData property that the field will be bound to.
Inherited From:
Source:

required :Boolean

required should be true if the field requires input. Defaults to false.
Type:
  • Boolean
Source:

type

Properties:
Name Type Description
The String registered name of the field that gets mapped in FieldManager when the field is constructed
Inherited From:
Source:

validationTrigger

Source:

validInputOnly

Source:

widgetTemplate

Properties:
Name Type Description
Simplate Simplate that defines the fields HTML Markup * `$` => Field instance * `$$` => Owner View instance
Overrides:
Source:

Methods

_onBlur(evt)

Handler for the `onblur` event If either the `validationTrigger` or `notificationTrigger` is set to `blur` then it will fire the respective function.
Parameters:
Name Type Description
evt Event
Source:

_onKeyPress(evt)

Handler for the `onkeypress` event which is not connected unless `validInputOnly` is true. Since this is a direct tie-in for `validInputOnly`, this intercepts the key press, adds it to the current value temporarily and validates the result -- if it validates the key press is accepted, if validation fails the key press is rejected and the key is not entered.
Parameters:
Name Type Description
evt Event
Source:

_onKeyUp(evt)

Handler for the `onkeyup` event. If either the `validationTrigger` or `notificationTrigger` is set to `keyup` then it will fire the respective function.
Parameters:
Name Type Description
evt Event
Source:

clearValue(asDirty)

Clears the input nodes value, optionally clearing as a modified value.
Parameters:
Name Type Description
asDirty Boolean If true it signifies the clearing is meant as destroying an existing value and should then be detected as modified/dirty.
Overrides:
Source:

disable()

Extends the parent implementation to set the disabled attribute of the input to true
Overrides:
Source:

enable()

Extends the parent implementation to set the disabled attribute of the input to false
Overrides:
Source:

focus()

Focuses the input for the field
Overrides:
Source:

getValue() → {String}

Returns the input nodes value
Overrides:
Source:
Returns:
Type
String

hide()

Sets hidden to true and fires onHide.
Inherited From:
Source:

init()

Extends the parent implementation to optionally bind the `onkeypress` event if `validInputOnly` is true. Binds the 'onblur' and 'keyup' events.
Overrides:
Source:

isDirty() → {Boolean}

Determines if the value has been modified from the default/original state
Overrides:
Source:
Returns:
Type
Boolean

isDisabled() → {Boolean}

Returns the disabled state
Inherited From:
Source:
Returns:
Type
Boolean

isHidden() → {Boolean}

Returns the hidden state
Inherited From:
Source:
Returns:
Type
Boolean

onChange(field)

Event that fires when the field is changed
Parameters:
Name Type Description
field _Field The field itself
Inherited From:
Source:

onDisable(field)

Event that fires when the field is disabled
Parameters:
Name Type Description
field _Field The field itself
Inherited From:
Source:

onEnable(field)

Event that fires when the field is enabled
Parameters:
Name Type Description
field _Field The field itself
Inherited From:
Source:

onHide(field)

Event that fires when the field is hidden
Parameters:
Name Type Description
field _Field The field itself
Inherited From:
Source:

onNotificationTrigger(evt)

Fires onChange if the value has changed since the previous notification event or a direct setting of the value.
Parameters:
Name Type Description
evt Event
Source:

onShow(field)

Event that fires when the field is shown
Parameters:
Name Type Description
field _Field The field itself
Inherited From:
Source:

onValidationTrigger(evt)

Immediately calls validate and adds the respective row styling.
Parameters:
Name Type Description
evt Event
Source:

renderTo(node)

Inserts the field into the given DOM node using dijit Widget `placeAt(node)` and saves a reference to it to `this.containerNode`.
Parameters:
Name Type Description
node HTMLElement Target node to insert the field into
Inherited From:
Source:

setValue(val, initial)

Sets the value of the input node, clears the previous value for notification trigger and if setting an initial value - set the originalValue to the passed value for dirty detection.
Parameters:
Name Type Description
val String Value to be set
initial Boolean True if the value is the default/clean value, false if it is a meant as a dirty value
Overrides:
Source:

setValueNoTrigger(val, initial)

Sets the value of the input node, and set the value as the previous value so notification trigger will not trigger and if setting an initial value - set the originalValue to the passed value for dirty detection.
Parameters:
Name Type Description
val String Value to be set
initial Boolean True if the value is the default/clean value, false if it is a meant as a dirty value
Source:

show()

Sets hidden to false and fires onShow.
Inherited From:
Source:

validate(value) → {Boolean/Object}

The validate function determines if there is any errors - meaning it will return false for a "Error free" field. ###Basic Flow: * loops over each `validator` defined on the field * Evaluate the result * If the validator is a RegExp, use return `!regExp.test(value)` * If the validator is a function, call and return the result of the function passing the value, _Field instance, and the `owner` property. * If the validator is an object and has a `test` key, follow the RegExp path. * If the validator is an object and has a `fn` key, follow the function path. * If the result is true and the validator is an object with a `message` key: * If message is a function, call and return the result of the function passing the value, _Field instance and the `owner` property. * Otherwise, assume it is a string format and call dojo's `string.substitute` using the message as the format, `${0}` as the value, `${1}` as the fields name, `${2}` as the fields label property. * Save the result of the function or string substitution as the result itself. * Return the result.
Parameters:
Name Type Description
value Value of the field, if not passed then getValue is used.
Inherited From:
Source:
Returns:
False signifies that everything is okay and the field is valid, `true` or a `string message` indicates that it failed.
Type
Boolean/Object