Decimalbox

{{ZKComponentReferencePageHeader}}

= Decimalbox =

*Demonstration: [http://www.zkoss.org/zkdemo/input/form_sample Decimalbox ]
*Java API: <javadoc>org.zkoss.zul.Decimalbox</javadoc>
*JavaScript API: <javadoc directory="jsdoc">zul.inp.Decimalbox</javadoc>
*Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Decimalbox | Decimalbox]]

= Employment/Purpose =

An edit box for holding big decimal value .

= Example =

[[Image:ZKComRef_Decimalbox_Examples.PNG]] 

<source lang="xml" >
 <doublebox 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 <tt>null</tt>.

<source lang="xml" >
<decimalbox format="#,##0.##"/>
</source>
== Constraint ==
You could specify what value to accept for input controls by use of the <tt>constraint </tt>property. 
It could be a combination of <tt>no positive</tt>, <tt>no negative</tt>, <tt>no zero</tt>, <tt>no empty</tt>.

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=

{| border="1" | 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=

 *NONE

=Use Cases=

{| border='1px' | width="100%"
! Version !! Description !! Example Location
|-
| &nbsp;
| &nbsp;
| &nbsp;
|}

=Version History=
{{LastUpdated}}
{| border='1px' | width="100%"
! Version !! Date !! Content
|-
| &nbsp;
| &nbsp;
| &nbsp;
|}

{{ZKComponentReferencePageFooter}}