|
|||
TAG LIBRARIES: <netui> | <netui-data> | <netui-template> | |||
DETAIL: Syntax | Description | Attributes | Example | Implementing Class: org.apache.beehive.netui.tags.html.FormatString |
A formatter used to format strings.
Syntax |
<netui:formatString
[country="country"]
[language="language"]
pattern="pattern"
[truncate="truncate"] />
Description |
A formatter used to format strings.
The <netui:formatString> tag formats the output of its parent tag. For example:
<netui:label value="{pageFlow.phone}"> <netui:formatString pattern="phone number: (###) ###-####"/> </netui:label>
<netui:formatString> uses the following pattern syntax:
The # character is a placeholder for individual characters in the String to be formatted, while other characters are treated as literals. For example:
String "5555555555" with pattern "(###)###-####" would result in: (555)555-5555.
The * character displays all remaining characters in the String. For example:
String "123456" with pattern "#-*!" would result in: 1-23456!
If a result with a '#' or '*' character showing is desired, the '#' or '*' needs to be escaped with the '$' character. For example:
String "ABCD" with pattern "$#-####" would result in: #-ABCD.
To show a '$' in the result, the '$' character needs to be escaped. For example:
String "1234" with pattern "$$#,###" would result in: $1,234
If the truncate
attribute is set to "true", characters in the String that exceed the pattern
will be dropped. Otherwise, they will be appended to the end of the formatted String.
Attributes | |||||||
country |
|
||||||
language |
|
||||||
pattern |
|
||||||
truncate |
|
Example |
In this sample, the String "2125555555" will be formatted to this form: (212)555-5555.
<netui:label value="2125555555"> <netui:formatString pattern="phone (###) ###-####"/> </netui:label>
|
|||
TAG LIBRARIES: <netui> | <netui-data> | <netui-template> | |||
DETAIL: Syntax | Description | Attributes | Example | Implementing Class: org.apache.beehive.netui.tags.html.FormatString |