From Documentation

Jump to: navigation, search




A longbox is used to let users input long data.


ZKComRef longbox.jpg

 <window title="Longbox Demo" border="normal" width="400px">
     long box:<longbox width="250px"/>



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

<longbox format="#,##0"/>


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.

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

Version History

Last Update : 2010/12/2

Version Date Content

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