Decimalbox"
From Documentation
(→Format) |
|||
| (21 intermediate revisions by 8 users not shown) | |||
| Line 3: | Line 3: | ||
= Decimalbox = | = Decimalbox = | ||
| − | *Demonstration: [http://www.zkoss.org/zkdemo/ | + | *Demonstration: [http://www.zkoss.org/zkdemo/input/form_sample Decimalbox ] |
*Java API: <javadoc>org.zkoss.zul.Decimalbox</javadoc> | *Java API: <javadoc>org.zkoss.zul.Decimalbox</javadoc> | ||
*JavaScript API: <javadoc directory="jsdoc">zul.inp.Decimalbox</javadoc> | *JavaScript API: <javadoc directory="jsdoc">zul.inp.Decimalbox</javadoc> | ||
| + | *Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Decimalbox | Decimalbox]] | ||
= Employment/Purpose = | = Employment/Purpose = | ||
| Line 13: | Line 14: | ||
= Example = | = Example = | ||
| + | [[Image:ZKComRef_Decimalbox_Examples.PNG]] | ||
| + | <source lang="xml" > | ||
| + | <decimalbox value="155"/> | ||
| + | </source> | ||
| + | =Properties= | ||
| + | == Format == | ||
| + | You are able to format the field by providing specifying the attribute with a formatting string. The default value is <code>null</code>. | ||
| − | = | + | <source lang="xml" > |
| + | <decimalbox format="#,##0.##"/> | ||
| + | </source> | ||
| − | {| | + | {{versionSince| 8.5.2}} |
| − | ! < | + | You can provide a locale to format the number by specifying a value starting with "locale:", e.g. [https://en.wikipedia.org/wiki/Indian_numbering_system Indian numbering system]: |
| − | + | ||
| − | + | <source lang="xml" > | |
| − | + | <decimalbox format="locale:en-In"/> | |
| − | + | </source> | |
| + | |||
| + | Ref: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat | ||
| + | |||
| + | <!-- https://tracker.zkoss.org/browse/ZK-3704 --> | ||
| + | |||
| + | == Constraint == | ||
| + | You could specify what value to accept for input controls by the use of the <code>constraint </code>property. | ||
| + | It could be a combination of <code>no positive</code>, <code>no negative</code>, <code>no zero</code>, <code>no empty</code>. | ||
| + | |||
| + | To specify two or more constraints, use comma to separate them as follows. | ||
| + | |||
| + | <source lang="xml" > | ||
| + | <decimalbox constraint="no negative,no empty"/> | ||
| + | </source> | ||
| − | + | If you prefer to display different message to the default one, you can append the error message to the constraint with a colon. | |
| − | + | <source lang="xml" > | |
| − | + | <decimalbox constraint="no negative: it shall not be negative"/> | |
| − | + | </source> | |
| − | + | 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. | ||
| − | + | <source lang="xml" > | |
| − | + | <decimalbox constraint="no negative: ${c:l('err.num.negative')}"/> | |
| − | + | </source> | |
| − | + | =Inherited Functions= | |
| − | + | Please refer to [[ZK_Component_Reference/Base_Components/NumberInputElement| NumberInputElement]] for inherited functions. | |
| − | |||
| − | | | ||
| − | + | =Supported Events= | |
| + | {| class='wikitable' | width="100%" | ||
| + | ! <center>Name</center> | ||
| + | ! <center>Event Type</center> | ||
| + | |- | ||
| + | | None | ||
| + | | None | ||
|} | |} | ||
| + | *Inherited Supported Events: [[ZK_Component_Reference/Base_Components/NumberInputElement#Supported_Events | NumberInputElement]] | ||
=Supported Children= | =Supported Children= | ||
| Line 52: | Line 83: | ||
*NONE | *NONE | ||
| − | =Use | + | =Use Cases= |
| − | {| | + | {| class='wikitable' | width="100%" |
! Version !! Description !! Example Location | ! Version !! Description !! Example Location | ||
|- | |- | ||
| − | | | + | | |
| | | | ||
| | | | ||
| Line 63: | Line 94: | ||
=Version History= | =Version History= | ||
| − | + | {{LastUpdated}} | |
| − | {| | + | {| class='wikitable' | width="100%" |
! Version !! Date !! Content | ! Version !! Date !! Content | ||
|- | |- | ||
| − | | | + | | |
| − | | | + | | |
| − | | | + | | |
|} | |} | ||
{{ZKComponentReferencePageFooter}} | {{ZKComponentReferencePageFooter}} | ||
Latest revision as of 02:29, 12 May 2022
Decimalbox
- Demonstration: Decimalbox
- Java API: Decimalbox
- JavaScript API: Decimalbox
- Style Guide: 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.2 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')}"/>
Inherited Functions
Please refer to NumberInputElement for inherited functions.
Supported Events
| None | None |
- Inherited Supported Events: NumberInputElement
Supported Children
*NONE
Use Cases
| Version | Description | Example Location |
|---|---|---|
Version History
| Version | Date | Content |
|---|---|---|