Nov 30

 Checkbox

A checkbox is a specific type of two-states button that can be either checked or unchecked. Checkboxes let a user select an option. Examples: “I agree to terms and conditions” etc. checked and unchecked options.

Properties

Property Description
Caption The caption is the text that the end user sees on the button. This property can be bound to any variable or another widget.
Name The name is a unique identifier for the button. Special characters and spaces are not allowed in widget name.
Accessibility
Hint Any text you enter for this property will be shown as a tooltip when the mouse hovers over this widget for 1.5 seconds. It can be bound to a variable or another widget.
Tab Index The tab index attribute specifies the tab order of an element. You can use this property to change the default tabbing order for widget access using the tab key. The value can range from 0 to 32767. The default is 0 and -1 makes the element non-focusable.

NOTE: In Safari browsers, by default, Tab highlights only text fields. To enable Tab functionality, in Safari Browser from Preferences -> Advanced -> Accessibility set the option “Press Tab to highlight each item on a webpage”.

Shortcut Key Alphabet to act as a Shortcut key. The shortcut key property specifies a key to click the button. The way to activate the shortcut key varies from browser to browser (see below for details).
Layout
Width The width of your widget can be specified in em, pt, px or % (i.e 50px, 75%).
Height The height of your widget can be specified in em, pt, px or % (i.e 50px, 75%).
Default Value
Value This is the default value to display value for an editor widget. Note that the display value is just what the user sees initially, and is not always the dataValue returned by the widget.
Checked Value This property defines the value of the widget when the element is in the checked state. The default value is boolean value true. If specified, the value will be of string type.
Unchecked Value This property defines the value of the widget when the element is in the unchecked state.
Validation
Required A required editor in wm.LiveForm may refuse to save without a required field.
Behavior
Show Showing determines whether or not a component is visible. It is a bindable property.
Load on Demand
(visible only when show property is bound to a variable)
When this property is set and show property is bound, the initialization of the widget will be deferred till the widget becomes visible. This behavior improves the load time. Use this feature with caution, as it has a downside (as we will not be able to interact with the widget through script until the widget is initialized). When show property is not bound the widget will be initialized immediately.
Disabled If the disabled property is true (checked) the widget becomes display-only and user input will not be accepted. It can also set programmatically by binding it to a boolean type variable.

Shortcut key: The shortcut key property specifies a shortcut key to check the checkbox. The way of accessing the shortcut key is varying in different browsers:

Browser Shortcut key Trigger
Internet Explorer [Alt] + shortcut key
Chrome [Alt] + shortcut key (Windows/Linux)
[Control] [Alt] + shortcut key (MAC)
Firefox [Alt] [Shift] + shortcut key (Windows/Linux)
[Control] [Alt] + shortcut key (MAC)

Events

Event Description
Change This event handler is called each time your element’s value changes.
On focus This event handler is called each time your element is focused.
On blur This event handler is called each time your focus leaves your element.
Mouse Events
On click It is an HTML button. It is used to generate a click event. For example, save button.
On mouse enter This event handler is called whenever the mouse enters the widget.
On mouse leave This event handler is called whenever the mouse leaves the widget.
Touch Events
On tap This event handler is called whenever the widget is tapped.

 
We use cookies to provide you with a better experience. By using our website you agree to the use of cookies as described in our Privacy Policy.