Difference between revisions of "Keypad"

From HSYCO
Jump to navigation Jump to search
Line 15: Line 15:
 
*'''id''': the object's ID, used by UISets
 
*'''id''': the object's ID, used by UISets
 
*'''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 date field
+
*'''min''': the smallest accepted value
 +
*'''max''': the largest accepted value
 +
*'''digits''': the number of required digits; leave empty to accept a variable number of digits
 +
*'''decimals''': the maximum number of decimal digits; leave blank for integer numbers
 +
*'''type''': set to "input" for ordinary data; set to "password" to hide the digits
 +
*'''label''': the label shown at the top of the keypad panel
 +
*'''css''': optional. Defines the CSS style for the keypad field
  
 
== Syntax ==
 
== Syntax ==
  (keypad!id <position>; [<css>])
+
  (keypad!id <pos>; <min>; <max>; <digits>; <decimals>; <type>; [<label>]; [<css>])
 
E.g.
 
E.g.
  (keypad!mydate r1c1; width:100px)
+
  (keypad!mykeypad x3y20; 0; 100; 2;; input; Label;)
  
 
== UI Attributes ==
 
== UI Attributes ==
Line 32: Line 38:
 
|-
 
|-
  
|rowspan="2"|notnull
+
|min
|true
+
|number
|Value can't be null
+
|The smallest accepted value
 
|-
 
|-
|false
+
 
|Default. Value can be null
+
|max
 +
|number
 +
|The largest accepted value
 
|-
 
|-
  
|fromdate
+
|digits
|date in the "yyyymmdd" format
+
|number
|Minimum selectable date
+
|The number of required digits; leave empty to accept a variable number of digits
 
|-
 
|-
  
|todate
+
|decimals
|date in the "yyyymmdd" format
+
|number
|Maximum selectable date
+
|The maximum number of decimal digits; leave blank for integer numbers
 
|-
 
|-
  
 +
|rowspan="2"|ktype
 +
|input
 +
|Show the digits
 +
|-
 +
|password
 +
|Hide the digit
 +
|-
 +
 +
|label
 +
|string
 +
|The label shown at the top of the keypad panel
 +
|-
 
|}
 
|}

Revision as of 16:46, 23 January 2014

Note  For a description and a complete list of UI Objects, see UI Objects.

Keypad field that allows the user to input a numeric value. Clicking on the field will open a popup with a keypad panel. Can be used with a submit button.

The keypad performs range and number of digits validation of the input data.

Requires an ID.

For a tutorial on using this object, see Working with Forms

UI Object keypad.png

Parameters

  • id: the object's ID, used by UISets
  • position: the object's position. Use the pixels or rows and columns coordinates format
  • min: the smallest accepted value
  • max: the largest accepted value
  • digits: the number of required digits; leave empty to accept a variable number of digits
  • decimals: the maximum number of decimal digits; leave blank for integer numbers
  • type: set to "input" for ordinary data; set to "password" to hide the digits
  • label: the label shown at the top of the keypad panel
  • css: optional. Defines the CSS style for the keypad field

Syntax

(keypad!id <pos>; <min>; <max>; <digits>; <decimals>; <type>; [<label>]; [<css>])

E.g.

(keypad!mykeypad x3y20; 0; 100; 2;; input; Label;)

UI Attributes

Common attributes

Name Value Description
pos x<x>y<y> Position specified as x/y coordinates. E.g. x-5y10
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)
rotation 0 ... 360 Object rotation in degrees. Images are rotated around the center point, all other objects are rotated around the top left corner

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.

Input attributes

Name Value Description
min number The smallest accepted value
max number The largest accepted value
digits number The number of required digits; leave empty to accept a variable number of digits
decimals number The maximum number of decimal digits; leave blank for integer numbers
ktype input Show the digits
password Hide the digit
label string The label shown at the top of the keypad panel