Difference between revisions of "Input"
Jump to navigation
Jump to search
Line 6: | Line 6: | ||
For a tutorial on using this object, see [[Working with Forms]] | For a tutorial on using this object, see [[Working with Forms]] | ||
+ | |||
+ | [[File:UI Object input.png]] | ||
== Parameters == | == Parameters == | ||
Line 11: | Line 13: | ||
*'''position''': the object's position. Use the pixels or rows and columns coordinates format | *'''position''': the object's position. Use the pixels or rows and columns coordinates format | ||
*'''css''': optional. Defines the CSS style for the input field | *'''css''': optional. Defines the CSS style for the input field | ||
+ | *'''type''': optional. Defines the input type: | ||
+ | ** input - default behaviour | ||
+ | ** multiline - for input fields with more than a line. Use the height attribute on the css parameter to set the size | ||
+ | ** password - hides typed characters | ||
== Syntax == | == Syntax == | ||
− | (input!id <position>; <css>) | + | (input!id <position>; [<css>]; [<type>]) |
+ | E.g. | ||
+ | (input!myinput r1c1; color:blue; password) | ||
== UI Attributes == | == UI Attributes == | ||
{{UI Object Attributes (Common)}} | {{UI Object Attributes (Common)}} | ||
{{UI Object Attributes (Field)}} | {{UI Object Attributes (Field)}} |
Revision as of 11:45, 22 January 2014
Input field that allows the user to input a text. 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
- css: optional. Defines the CSS style for the input field
- type: optional. Defines the input type:
- input - default behaviour
- multiline - for input fields with more than a line. Use the height attribute on the css parameter to set the size
- password - hides typed characters
Syntax
(input!id <position>; [<css>]; [<type>])
E.g.
(input!myinput r1c1; color:blue; password)
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. |