Constructor
new module:argos/Fields/_Field()
Extends:
- Mixes In:
- Source:
Extends
Members
alwaysUseValue
Properties:
Name | Type | Description |
---|---|---|
alwaysUseValue |
Boolean | Signifies that the field should always be included when the form calls getValues. |
- Source:
applyTo
Properties:
Name | Type | Description |
---|---|---|
applyTo |
String | If defined it will use the applyTo string when getting and setting properties from
the SData object instead of the |
- Source:
autoFocus
Properties:
Name | Type | Description |
---|---|---|
autoFocus |
Boolean | Flag to indicate if this field should be focused when the form is shown. |
- Source:
containerNode
Properties:
Name | Type | Description |
---|---|---|
The |
HTMLElement | parent container element of the field. |
- 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.
- Source:
disabled
Properties:
Name | Type | Description |
---|---|---|
disabled |
Boolean | Indicates the disabled state |
- Source:
hidden
Properties:
Name | Type | Description |
---|---|---|
hidden |
Boolean | Indicates the visibility state |
- Source:
label
Properties:
Name | Type | Description |
---|---|---|
label |
String | The text that will, by default, show to the left of a field. |
- Source:
name
Properties:
Name | Type | Description |
---|---|---|
name |
String | The unique (within the current form) name of the field |
- Source:
owner
Properties:
Name | Type | Description |
---|---|---|
owner |
View | View that controls the field. |
- Source:
property
Properties:
Name | Type | Description |
---|---|---|
property |
String | The SData property that the field will be bound to. |
- Source:
type
Properties:
Name | Type | Description |
---|---|---|
type |
String | The registered name of the field that gets mapped in FieldManager when the field is constructed |
- Source:
widgetTemplate
Properties:
Name | Type | Description |
---|---|---|
Simplate |
Simplate | used to define the fields HTML Markup |
- Source:
Methods
buildRendering()
Processes this.widgetTemplate
or this.contentTemplate
- Inherited From:
- Source:
clearValue()
Each field type will need to implement this function to clear the value and visually.
- Source:
disable()
Sets disabled to true and fires onDisable.
- Source:
enable()
Sets disabled to false and fires onEnable.
- Source:
focus()
Focuses the input for the field
- Source:
getValue()
Each field type will need to implement this function to return the value of the field.
- Source:
hide()
Sets hidden to true and fires onHide.
- Source:
init()
Calledd during app startup after all fields have been inserted into the view
- Source:
isDirty() → {Boolean}
Determines if the fields' value has changed from the original value. Each field type should override this function and provide one tailored to its datatype.
- Source:
Returns:
True if the value has been modified (dirty).
- Type
- Boolean
isDisabled() → {Boolean}
Returns the disabled state
- Source:
Returns:
- Type
- Boolean
isHidden() → {Boolean}
Returns the hidden state
- Source:
Returns:
- Type
- Boolean
onChange(field)
Event that fires when the field is changed
Parameters:
Name | Type | Description |
---|---|---|
field |
_Field | The field itself |
- Source:
onDisable(field)
Event that fires when the field is disabled
Parameters:
Name | Type | Description |
---|---|---|
field |
_Field | The field itself |
- Source:
onEnable(field)
Event that fires when the field is enabled
Parameters:
Name | Type | Description |
---|---|---|
field |
_Field | The field itself |
- Source:
onHide(field)
Event that fires when the field is hidden
Parameters:
Name | Type | Description |
---|---|---|
field |
_Field | The field itself |
- Source:
onShow(field)
Event that fires when the field is shown
Parameters:
Name | Type | Description |
---|---|---|
field |
_Field | The field itself |
- 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 |
- Source:
setValue(val, initial)
Each field type will need to implement this function to set the value and represent the change visually.
Parameters:
Name | Type | Description |
---|---|---|
val |
String/Boolean/Number/Object | The value to set |
initial |
Boolean | If true the value is meant to be the default/original/clean value. |
- Source:
show()
Sets hidden to false and fires onShow.
- 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 validator is a RegExp, use return
-
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.
- If message is a function, call and return the result of the function passing the value, _Field instance and the
-
Return the result.
Parameters:
Name | Type | Description |
---|---|---|
value |
Value of the field, if not passed then getValue is used. |
- 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