Property
|
Description
|
---|---|
id
|
The identifier for the widget.
|
dataName
|
The name of the data element to which the widget is bound. This property is not mandatory. When there is no data need to be sent to the server, this property can be left blank.
|
urlForList
|
The urlForList property specifies the URL of the .js file that contains the data of the list of choices that are available for selection on the widget.
|
dataNameForList
|
The dataNameForList property specifies the name of the data, from a toolkit context or a JSON string, which holds the labels and values of the choices that are available for a user to select on the widget. This is an optional property.
|
labelField
|
The name of the field in data provider array objects ( dataNameForList or urlForList) to use as the label field.
|
valueField
|
The value of the field in data provider array objects ( dataNameForList or urlForList) to use as the value field.
|
isMandatory
|
The isMandatory property specifies whether a user is required to enter a value in the text box.
|
visibility
|
The visibility property defines how a widget is displayed on a GUI. The following values can be specified for this property:
visible
The widget is displayed on a GUI and users are able to interact with the widget.
hidden
The widget is not displayed on a GUI, but it occupies space on the GUI.
gone
The widget is not displayed on a GUI, and it does not occupy space on the GUI.
|
disabled
|
Disabled elements cannot have focus; do not receive or fire mouse events; and cannot receive user input. If you set this property to true, the widget is displayed on a GUI, but a user cannot interact with it. Data contained in a disabled widget is not processed when the form is submitted. The default value is false.
|
readOnly
|
To prevent a user from changing the value, set readOnly to true. The default value is false.
|
hint
|
A description of the widget that is displayed as a tooltip for a user. This property has multilingual support.
|
shortcut
|
Shortcut is a single character from the document character set. Pressing a shortcut assigned to a widget together with hot key of browser gives focus to the widget. Different widget may have different action when it receives focus. For example, when user activates a TextBox, this TextBox is focused and all texts are selected; when user activates a button, this button is focused and selected. The toolkit supports a shortcut function based on standard HTML access key and browser capability. That's mean the shortcut character and the hot key may be different in different browsers.
For more information about HTML access keys, see:
Action for Combo is : focus widget and select all text
Shortcut character: a-z 0-9 , . / ; ’ [ ] = -
Hot key
Firefox: Shift + Alt + shortcut
IE: Alt + shortcut
Sample
Input on UDTT tooling: a
Usage on IE: Pressing Alt + a
|
styleClass
|
The styleClass property specifies the name of the CSS style ( also known as CSS style class) associated with the widget. This property is set by selecting a style from the CSS styles table in the Style tab of the Properties view. If you do not configure the styleClass property, the default style is used instead. For more detailed information, refer to Setting CSS style to widgets.
|
width
|
The width property specifies the width of the widget. This property is set in the Appearance tab of the Properties view.
|
typeAhead
|
This typeAhead property indicates whether the value can be editable or not.
▪ True (Default): editable
▪ False: read-only
This property is set to True in code and is not available in tooling.
|
Event
|
Description
|
---|---|
onClick
|
Is fired when the left mouse button is clicked.
|
onFocus
|
Is fired when the widget receives focus because the user moves the mouse pointer over the widget.
|
onBlur
|
Is fired when the widget does not receive focus, or when the user clicks outside the widget, or when the widget is hidden.
|
onKeyDown
|
Is fired when a keyboard key is pressed.
|
onKeyUp
|
Is fired when a keyboard key is released.
|
onKeyPress
|
Is fired when a keyboard key is pressed or held down.
|
onMouseDown
|
Is fired when a mouse button is clicked.
|
onMouseUp
|
Is fired when a mouse button is released.
|
onMouseEnter
|
Is fired when the mouse pointer moves over the widget.
|
onMouseLeave
|
Is fired when the mouse pointer moves out of the widget.
|
onMouseMove
|
Is fired when the mouse pointer moves over nodes that are contained in the widget.
|
onChange
|
Is fired when the value of the widget changes.
|
onAsyncOK
|
Is fired when the page has been successfully updated with AJAX.
|
onAsyncError
|
Is fired when the page has failed to be updated with AJAX.
|
Property
|
Description
|
---|---|
id
|
This property can be used in the Condition part of ECA rule.
|
readOnly
|
This property can be used in the Condition and Actions part of ECA rule.
|
value
|
The value property specifies the text that is displayed in the widget.
This property can be used in the Condition and Actions part of ECA rule.
|
asyncStatus
|
The asyncStatus property specifies the status of the AJAX. The status is provided as an HTTP status code.
This property can be used in the Condition and Actions part of ECA rule.
|
asyncErrorMessage
|
The asyncErrorMessage property provides an error message an AJAX. The error message is retrieved from the browser-side.
This property can be used in the Condition and Actions part of ECA rule.
|
isMandatory
|
The value of the widget cannot be empty if the isMandatory property is true.
This property can be used in the Condition and Actions part of ECA rule.
|
visibility
|
visible
The widget is displayed on a GUI and users are able to interact with the widget.
hidden
The widget is not displayed on a GUI, but it occupies space on the GUI.
gone
The widget is not displayed on a GUI, and it does not occupy space on the GUI.
This property can be used in the Condition and Actions part of ECA rule.
|
disabled
|
Disabled elements cannot have focus, do not receive or fire mouse events, cannot receive user input. If you select a value of true for the disabled property, the widget is displayed on a GUI but a user cannot interact with it. Data contained in a disabled widget is not processed when the form is submitted. The default value for the disabled property is false.
This property can be used in the Condition and Actions part of ECA rule.
|
hint
|
The hint is a description of the widget that is displayed as a tooltip for a user. The hint property has multilingual support.
This property can be used in the Action part of ECA rule.
|
styleClass
|
This property can be used in the Action part of ECA rule.
|
Function
|
Description
|
---|---|
loadStoreFromURL
|
The loadStoreFromURL function loads a list of choices that are available for selection from a URL.
This property can be used in the Action part of ECA rule.
|
showErrorMessage
|
The showMessage function displays an error message on a GUI.
This property can be used in the Action part of ECA rule.
|
isFocusable
|
This property can be used in the Condition part of ECA rule.
|
focus
|
This property can be used in the Action part of ECA rule.
|