Intbox"

From Documentation
 
(3 intermediate revisions by the same user not shown)
Line 10: Line 10:
 
= Employment/Purpose =
 
= Employment/Purpose =
  
An <tt>intbox</tt> is used to let users input integer data.
+
An <code>intbox</code> is used to let users input integer data.
  
 
= Example =
 
= Example =
Line 28: Line 28:
  
 
== Format ==
 
== Format ==
You are able to format the field by providing specifying the attribute with a formatting string. The default value is <tt>null</tt>.
+
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" >
 
<source lang="xml" >
Line 34: Line 34:
 
</source>
 
</source>
  
  Since 8.5.2
+
{{versionSince| 8.5.2}}
 
You can provide a locale to format the number by specify the String starts with "locale:"
 
You can provide a locale to format the number by specify the String starts with "locale:"
  
Line 42: Line 42:
  
 
== Constraint ==
 
== Constraint ==
You could specify what value to accept for input controls by use of the <tt>constraint </tt>property.  
+
You could specify what value to accept for input controls by use of the <code>constraint </code>property.  
It could be a combination of <tt>no positive</tt>, <tt>no negative</tt>, <tt>no zero</tt>, <tt>no empty</tt>.
+
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.
 
To specify two or more constraints, use comma to separate them as follows.
Line 70: Line 70:
 
=Supported Events=
 
=Supported Events=
  
{| border="1" | width="100%"
+
{| class='wikitable' | width="100%"
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
Line 85: Line 85:
 
=Use Cases=
 
=Use Cases=
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
Line 97: Line 97:
 
|}
 
|}
  
=Version History=
+
 
{{LastUpdated}}
 
{| border='1px' | width="100%"
 
! Version !! Date !! Content
 
|-
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
|}
 
  
 
{{ZKComponentReferencePageFooter}}
 
{{ZKComponentReferencePageFooter}}

Latest revision as of 01:47, 29 May 2023

Intbox

Employment/Purpose

An intbox is used to let users input integer data.

Example

ZKComRef Intbox.png

While input invalid data:

ZKComRef Intbox2.png

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

Properties

Format

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"/>

Constraint

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"/>

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

Inherited Functions

Please refer to NumberInputElement for inherited functions.

Supported Events

Name
Event Type
None None

Supported Children

*NONE

Use Cases

Version Description Example Location
3.6 Leading zero in Intbox http://www.zkoss.org/forum/listComment/10271
3.6 Constraint Intbox to accept only digits http://www.zkoss.org/forum/listComment/4603




Last Update : 2023/05/29

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