For a description and a complete list of UI Objects, see
UI Objects.
Radio button that allows the user to select a value.
Multiple radio buttons are grouped using the same ID.
Can be used with a submit button.
Requires an ID.
For a tutorial on using this object, see Working with Forms
Parameters
- id: the object's ID, used by UISets
- position: the object's position. Use the pixels or rows and columns coordinates format
- label: the text label next to the button. Can contain HTML tags
- value: value to be sent if selected
- css: optional. Defines the CSS style for the label
Syntax
(radiobutton!id <position>; <label>; <value>; [<css>])
E.g.
(radiobutton!radiogroup1 r1c1; label; one)
UI Attributes
Common attributes
Name
|
Value
|
Description
|
pos
|
x<x>y<y>
|
Position specified as x/y coordinates. E.g. x-5y10
|
r<r>c<c>
|
Position specified as row/column. E.g. r1c2
|
visible
|
true
|
Default. Show the object
|
false
|
Hide the object
|
blink
|
true | slow
|
Blink the object at a slow speed
|
fast
|
Blink the object at a fast speed
|
false
|
Stop the blinking
|
opacity
|
0.0 ... 1.0
|
Object opacity from 0 (not visible) to 1 (fully visible)
|
Field attributes
Name
|
Value
|
Description
|
enabled
|
true
|
Field is enabled
|
false
|
Field is disabled
|
autosend
|
true
|
Automatically sends the value on changes. It's the default behaviour when there are no submit objects on the page or in a parent container (if the field is inside a container).
|
false
|
Won't send the value on changes. It's the default behaviour when there's a submit object on the page or in a parent container.
|
focus
|
true
|
Focus the field. Only a single object should have this attribute at "true".
|
false
|
Reset focus
|
rollback
|
true
|
Restores the previously saved value.
|
rollbackenabled
|
true
|
Automatically restores the previous value on an error (if the value isn't valid or the remote request resolved in an error).
|
false
|
Won't restore the value on errors.
|
error
|
true
|
Manually shows an error feedback on the field (won't modify the current field value).
|
false
|
Hides the error visualization.
|
Radiobutton attributes
Name
|
Value
|
Description
|
value
|
string
|
Radiobutton value
|