DateTextBox is a text box using with a drop down calendar. This allows a user to type in or choosing a date from a calendar widget. Maximum and minimum inputable date can be set.
| Description | ||
| new DateTextBox(params?srcNodeRef?) |
Create a new DateTextBox widget. |
| Type | Description | |
| _styleAttr | Object |
when you want to set style for other node. you can do this by example...
_styleAttr:{
|
| _timerChanged | dojox.timing.Timer |
Timer for 'delayChanged' property. |
| active | Boolean |
If true, this forces the control to enter the active state and classname 'amos-form-active' will be added. |
| busy | Boolean |
If true, this forces the control to enter the busy state and classname 'amos-form-busy' will be added. |
| customIcons | DOMNode | String[] | Object[] | Add custom icons and their functionalities. This property can receive an array of DOM nodes of HTML markups or DOM nodes created from a widget creation. It allows an array of image path strings and CSS class strings. It also accepts an array consisting both types of inputs. |
| delayChanged | Number |
Number of milliseconds to wait until timing out before executes a function. Value ‘0’ means no timeout. |
| disabled | Boolean |
If true, any control's events(except change) are not responding. Its content cannot be edited and is excluded when the form is submitted. |
| displayedValue | String |
The value presently displays in the control. |
| error | Boolean |
If true, this forces the control to enter the error state and classname 'amos-form-error' will be added. |
| errorMessageVisible | Boolean | If true, error message is visible when an error occur. Otherwise, nothing is shown when an error occrus. |
| errorType | String | Error type of text box (use constant.) |
| filled | Boolean |
A flag that shows whether a form element is filled in (true) or empty (false). |
| focused | Boolean |
If true, the element is focused. |
| format | String |
Date format. |
| hasClearIcon | Boolean | If true, a clear icon is shown near right border inside the text box once there is at least a character input. |
| hasDownArrow | Boolean |
If true, this DateTextBox element will have a down arrow button. (This button is used to display a drop-down calendar.) |
| id | String | An unique id for a text box. (The specified value must be unique within the document.) |
| intermediateChanges | Boolean |
If true, it will fires onChange event every change to the value of the text box. |
| label | String | Label of a text box. |
| leftIcons | DOMNode | String[] | Object[] | Add custom icons and their functionalities at the left of textbox. This property can receive an array of DOM nodes of HTML markups or DOM nodes created from a widget creation. It allows an array of image path strings and CSS class strings. It also accepts an array consisting both types of inputs. |
| max | Date |
Maximum inputable date. If it is set to null, there is no maximum. |
| maxHeight | String | Number |
The max height for dropdown. Any dropdown taller than this value will have a scrollbar. |
| maxLength | Number |
Maximum number of characters that can be entered. |
| min | Date |
Minimum inputable date. If it is set to null, there is no minimum. |
| name | String | Name of a text box. When sending a request to server, this property is the parameter's name. |
| placeHolder | String | Placeholder is a short hint that describes expected value of an input field. It is displayed in the input field before the user enters a value. |
| preventInjection | Boolean |
If true, prevent HTML injection. If false, allow HTML injection. If null, the control will refer to the web configuration file whether to prevent or allow HTML injection. |
| readOnly | Boolean |
If true, the control is read-only and cannot be edited. However, its content, if presents, is included in form submission. |
| regExp | String | RegExp | Regular expression pattern to be used for validation. |
| required | Boolean |
If true, the input field must be filled out before form submission. |
| rightIcons | DOMNode | String[] | Object[] | Add custom icons and their functionalities at the right of textbox. This property can receive an array of DOM nodes of HTML markups or DOM nodes created from a widget creation. It allows an array of image path strings and CSS class strings. It also accepts an array consisting both types of inputs. |
| textAlign | String | Specify the alignment of value in text box. |
| trim | Boolean |
If true, blank spaces will be removed from both sides of a string. |
| type | String | Specify the type of value in text box to display. |
| valid | Boolean | Validity flag that shows whether a text box is validated to be valid (true) or invalid (false). |
| value | Date |
Value of a DateTextBox. |
| viewMode | Boolean |
If true, the control will show only the displayedValue. |
| width | Number | String | Width of text box. |
| Return type | Description | |
| hideDropDown() | None |
Hide drop-down list. |
| appendBottomDropDown(node) | None |
Add item to bottom node. |
| appendDropDown(node) | None |
Add item to a drop-down list as the last child of the node. |
| blur() | None |
Remove focus from an element. (Blur the element.) |
| clearBottomDropDown() | None |
Clear bottom node in drop-down. |
| clearDropDown() | None |
Clear items in drop-down list. |
| focus() | None |
Focus to an element. |
| hide(elem?) | None |
Hide a specified element. The hidden element will not be displayed at all. |
| __baseClassInherit(constructor) | None |
get className from superclass. |
| isValid() | Boolean |
Returns true when text validation succeeded; otherwise, false. |
| isVisible(elem?) | Boolean |
Return true if the element is visible, otherwise false. |
| reset() | None | Reset all state and value to default. |
| show(elem?) | None |
Display a specified element. |
| showDropDown(winBox) | None |
Show drop-down list. |
| showError(msgError) | None | Show error message. |
| toggle(elem?) | None |
Toggle visibility of a specified element. |
| toggleDropDown() | Boolean |
Toggle between hide() and show() a drop-down list. |
| Description | ||
| blur |
Fires when an object loses focus. |
|
| click |
Fires when the user clicks on an element. |
|
| dblclick |
Fires when the user double-clicks on an element |
|
| focus |
Fires when an element gets focus. |
|
| icon-clear-click | Fires when user clicks icon for clear text in a text box. (Icon that appears on the rigth of text box.) | |
| icon-click | Fires when user clicks icon (custom icon). | |
| keydown |
Fires when the user is pressing a key (on the keyboard). |
|
| keypress |
Fires when the user presses a key (on the keyboard). |
|
| keyup |
Fires when the user releases a key (on the keyboard). |
|
| mousedown |
Fires when a user presses a mouse button over an element. |
|
| mouseout |
Fires when the mouse pointer is moved out of an element. |
|
| mouseover |
Fires when the mouse pointer is moved onto an element. |
|
| mouseup |
Fires when a user releases a mouse button over an element. |
|
| paste |
Fires when the user pastes some content in an element. |
when you want to set style for other node. you can do this by example...
_styleAttr:{
style-property:effected-node
}
this property was effected where this class was inherited and your widget was called by...
var widget = new YourWidget({
style:{
style-property:style-value
}
});
now effected-node in you widget will have style-property = style-value
Default value: {}
Timer for 'delayChanged' property.
If true, this forces the control to enter the active state and classname 'amos-form-active' will be added.
Default value: false
If true, this forces the control to enter the busy state and classname 'amos-form-busy' will be added.
Default value: false
Number of milliseconds to wait until timing out before executes a function. Value ‘0’ means no timeout.
Default value: 0
If true, any control's events(except change) are not responding. Its content cannot be edited and is excluded when the form is submitted.
Default value: false
If true, this forces the control to enter the error state and classname 'amos-form-error' will be added.
Default value: false
Default value: true
A flag that shows whether a form element is filled in (true) or empty (false).
Default value: false
Default value: true
If true, this DateTextBox element will have a down arrow button. (This button is used to display a drop-down calendar.)
Default value: true
If true, it will fires onChange event every change to the value of the text box.
Otherwise, it will fire when the text box loses focus after its value was changed.
Default value: true
The max height for dropdown. Any dropdown taller than this value will have a scrollbar.
Default value: 200
If true, prevent HTML injection. If false, allow HTML injection. If null, the control will refer to the web configuration file whether to prevent or allow HTML injection.
Default value: false
If true, the control is read-only and cannot be edited. However, its content, if presents, is included in form submission.
Default value: false
If true, the input field must be filled out before form submission.
Default value: false
If true, blank spaces will be removed from both sides of a string.
Default value: true
Default value: false
Hide drop-down list.
Add item to bottom node.
<DOMNode>
node
|
Required |
item which you add |
Add item to a drop-down list as the last child of the node.
<DOMNode>
node
|
Required |
item which you add |
Remove focus from an element. (Blur the element.)
Clear bottom node in drop-down.
Clear items in drop-down list.
Focus to an element.
Hide a specified element. The hidden element will not be displayed at all.
<Node>
elem
|
Optional |
Specified element to be hidden. |
get className from superclass.
<Object>
constructor
|
Required |
|
Return true if the element is visible, otherwise false.
<Node>
elem
|
Optional |
Specified element to be checked. If not specified, domNode of the widget is used instead. |
Display a specified element.
<Node>
elem
|
Optional |
Specified element to be displayed. |
Show drop-down list.
<Object>
winBox
|
Required |
size of drop-down area |
<String>
msgError
|
Required |
Text for error message.
|
Toggle visibility of a specified element.
<Node>
elem
|
Optional |
Specified element to toggle visibility. |
Fires when the user double-clicks on an element
<Object>
evt
|
javascript event object |
<Object>
evt
|
-javascript event object
|
Fires when the user is pressing a key (on the keyboard).
<Object>
evt
|
javascript event object |
Fires when the user presses a key (on the keyboard).
<Object>
evt
|
javascript event object |
Fires when the user releases a key (on the keyboard).
<Object>
evt
|
javascript event object |
Fires when a user presses a mouse button over an element.
<Object>
evt
|
javascript event object |
Fires when the mouse pointer is moved out of an element.
<Object>
evt
|
javascript event object |
Fires when the mouse pointer is moved onto an element.
<Object>
evt
|
javascript event object |
Fires when a user releases a mouse button over an element.
<Object>
evt
|
javascript event object |
Fires when the user pastes some content in an element.
<Object>
evt
|
javascript event object |