From Documentation



An intbox is used to let users input integer data.


ZKComRef Intbox.png

While input invalid data:

ZKComRef Intbox2.png

 <window title="Intbox Demo" border="normal" width="200px">
     int box:<intbox/>



You are able to format the field by providing specifying the attribute with a formatting string. The default value is null.

<intbox format="#,##0"/>
 Since 8.5.2

You can provide a locale to format the number by specify the String starts with "locale:"

<intbox format="locale:zh-TW"/>


You could specify what value to accept for input controls by 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.

<intbox 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.

<intbox constraint="no negative: it shall not be negative"/>


  • 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.
<intbox constraint="no negative: ${c:l('err.num.negative')}"/>

Inherited Functions

Please refer to NumberInputElement for inherited functions.

Supported Events

Event Type
None None

Supported Children


Use Cases

Version Description Example Location
3.6 Leading zero in Intbox
3.6 Constraint Intbox to accept only digits

Version History

Last Update : 2022/01/12

Version Date Content

Last Update : 2022/01/12

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.