Longbox"

From Documentation
(11 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
= Longbox =
 
= Longbox =
  
*Demonstration: [http://www.zkoss.org/zkdemo/userguide/#f2 Longbox]
+
*Demonstration: [http://www.zkoss.org/zkdemo/input/form_sample Longbox]
 
*Java API: <javadoc>org.zkoss.zul.Longbox</javadoc>
 
*Java API: <javadoc>org.zkoss.zul.Longbox</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.inp.Longbox</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.inp.Longbox</javadoc>
 +
*Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Longbox | Longbox]]
  
 
= Employment/Purpose =
 
= Employment/Purpose =
Line 16: Line 17:
  
 
<source lang="xml" >
 
<source lang="xml" >
  <window title="Longbox Demo" border="normal" width="200px">
+
  <window title="Longbox Demo" border="normal" width="400px">
     long box:<longbox/>
+
     long box:<longbox width="250px"/>
 
  </window>
 
  </window>
 
</source>
 
</source>
 +
=Properties=
  
=Supported events=
+
== 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" >
 +
<longbox format="#,##0"/>
 +
</source>
 +
 
 +
  Since 8.5.2
 +
You can provide a locale to format the number by specify the String starts with "locale:"
 +
 
 +
<source lang="xml" >
 +
<longbox format="locale:zh-TW"/>
 +
</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" >
 +
<longbox 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" >
 +
<intbox 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" >
 +
<longbox 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%"
 
{| border="1" | width="100%"
Line 30: Line 74:
 
| None
 
| None
 
|}
 
|}
 +
*Inherited Supported Events: [[ZK_Component_Reference/Base_Components/NumberInputElement#Supported_Events | NumberInputElement]]
  
 
=Supported Children=
 
=Supported Children=
Line 35: Line 80:
 
  *NONE
 
  *NONE
  
=Use cases=
+
=Use Cases=
  
 
{| border='1px' | width="100%"
 
{| border='1px' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
| 5.0+
+
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
Line 46: Line 91:
  
 
=Version History=
 
=Version History=
 
+
{{LastUpdated}}
 
{| border='1px' | width="100%"
 
{| border='1px' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
| 5.x.x
+
| &nbsp;
| x/x/20xx
+
| &nbsp;
| Initialization
+
| &nbsp;
 
|}
 
|}
  
 
{{ZKComponentReferencePageFooter}}
 
{{ZKComponentReferencePageFooter}}

Revision as of 08:47, 13 June 2018

Longbox

Employment/Purpose

A longbox is used to let users input long data.

Example

ZKComRef longbox.jpg

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

Properties

Format

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

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

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

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

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

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

Version History

Last Update : 2018/06/13


Version Date Content
     



Last Update : 2018/06/13

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