Decimalbox"

From Documentation
m ((via JWB))
 
(2 intermediate revisions by the same user not shown)
Line 23: Line 23:
  
 
== 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 29: Line 29:
 
</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 specifying a value starting with "locale:", e.g. [https://en.wikipedia.org/wiki/Indian_numbering_system Indian numbering system]:
  
 
<source lang="xml" >
 
<source lang="xml" >
<decimalbox format="locale:zh-TW"/>
+
<decimalbox format="locale:en-In"/>
 
</source>
 
</source>
 +
 +
Ref: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat
 +
 +
<!-- https://tracker.zkoss.org/browse/ZK-3704 -->
  
 
== Constraint ==
 
== Constraint ==
You could specify what value to accept for input controls by the use of the <tt>constraint </tt>property.  
+
You could specify what value to accept for input controls by the 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.

Latest revision as of 02:29, 12 May 2022

Decimalbox

Employment/Purpose

An edit box for holding big decimal value .

Example

ZKComRef Decimalbox Examples.PNG

 <decimalbox value="155"/>

Properties

Format

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

<decimalbox format="#,##0.##"/>

Since 8.5.2 You can provide a locale to format the number by specifying a value starting with "locale:", e.g. Indian numbering system:

<decimalbox format="locale:en-In"/>

Ref: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat


Constraint

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

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

<decimalbox 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.
<decimalbox 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 : 2022/05/12


Version Date Content
     



Last Update : 2022/05/12

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