Decimalbox
Decimalbox
- Demonstration: Decimalbox
- Java API: org.zkoss.zul.Decimalbox
- JavaScript API: zul.inp.Decimalbox
Employment/Purpose
An edit box for holding big decimal value .
Example
<decimalbox value="155"/>
Properties
Format
You are able to format the field by providing specifying the attribute
with a formatting string. The default value is null
.
<decimalbox format="#,##0.##"/>
since 8.5 You can provide a locale to format the number by specifying a value starting with “locale:”, e.g. Indian numbering system:
<decimalbox format="locale:en-In"/>
Ref: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat
Constraint
You could specify what value to accept for input controls by the use of
the constraint
property. It could be a combination of no positive
,
no negative
, no zero
, no empty
.
To specify two or more constraints, use comma to separate them as follows.
<decimalbox constraint="no negative,no empty"/>
If you prefer to display different message to the default one, you can append the error message to the constraint with a colon.
<decimalbox constraint="no negative: it shall not be negative"/>
Notes:
- The error message, if specified, must be the last element and start with colon.
- To support multiple languages, you could use the 「l」 function as depicted in the Internationalization chapter.
<decimalbox constraint="no negative: ${c:l('err.num.negative')}"/>
min & max constraint
since 10.2
<spinner constraint="min -2 max 6"/>
Inherited Functions
Please refer to NumberInputElement for inherited functions.
Supported Events
Name |
Event Type |
---|---|
None |
None |
- Inherited Supported Events: NumberInputElement
Supported Children
*NONE