Convert Number sub tag (ICU4J)

Convert Number sub tag (ICU4J)

The <hx:convertNumber> tag extends the <f:convertNumber> tag by supporting additional capabilities in how the pattern attribute can be interpreted.

<hx:convertNumber> uses the ICU4J internationalization library implementation. ICU4J is a set of Java™ libraries that supports unicode, software globalization, and internationalization.

Parent tags

This tag is used as a child of the following tags:

<h:inputText>

<h:outputText>

Rendering

This component has no visual rendering. No HTML is rendered.

Properties and All Attributes views

The Properties view for a component shows the most common set of attributes you can set on a component, and, depending on the component, you might also see options for adding controls, actions, or other components. To open the Properties view, click

Window | Show View | Properties.

These common attributes for the Convert Number sub tag:

The All Attributes view shows a table of all the attributes you can set on a component, which includes those attributes you can access from the Properties view. To switch to the All Attributes view, click the
All Attributes icon in the upper right corner of the Properties view.

Table 1. Convert Number attributes

Attribute name

Description

currencyCode

ISO 4217 currency code, applied only when formatting currencies.

currencySymbol

Currency symbol, applied only when formatting currencies.

groupingUsed

Flag specifying whether formatted output will contain grouping separators. Default value is true.

integerOnly

Flag specifying whether only the integer part of the value will be formatted and parsed.

locale

Locale whose predefined styles for dates and times are used during formatting or parsing. If not specified, the locale returned by FacesContext.getViewRoot().getLocale() is used.

maxFractionDigits

Maximum number of digits that will be formatted in the fractional portion of the output.

maxIntegerDigits

Maximum number of digits that will be formatted in the integer portion of the output.

minFractionDigits

Minimum number of digits that will be formatted in the fractional portion of the output.

minIntegerDigits

Minimum number of digits that will be formatted in the integer portion of the output.

pattern

Becomes active if you select a custom type number field. Custom formatting pattern which determines how the string should be parsed.

type

The type of the dialog box. A modal dialog box blocks input (keyboard or mouse) to the window under the dialog ( fill out the dialog and press OK or CANCEL before you may do anything else in the page). A modeless dialog box does not block input to the window "under" the dialog.

Note: More than one modeless dialog box may be displayed at a time. If more than one modal dialog box is displayed at a time, the boxes stack on top of each other and only the top dialog is active.

Attribute name	Description
currencyCode	ISO 4217 currency code, applied only when formatting currencies.
currencySymbol	Currency symbol, applied only when formatting currencies.
groupingUsed	Flag specifying whether formatted output will contain grouping separators. Default value is true.
integerOnly	Flag specifying whether only the integer part of the value will be formatted and parsed.
locale	Locale whose predefined styles for dates and times are used during formatting or parsing. If not specified, the locale returned by FacesContext.getViewRoot().getLocale() is used.
maxFractionDigits	Maximum number of digits that will be formatted in the fractional portion of the output.
maxIntegerDigits	Maximum number of digits that will be formatted in the integer portion of the output.
minFractionDigits	Minimum number of digits that will be formatted in the fractional portion of the output.
minIntegerDigits	Minimum number of digits that will be formatted in the integer portion of the output.
pattern	Becomes active if you select a custom type number field. Custom formatting pattern which determines how the string should be parsed.
type	The type of the dialog box. A modal dialog box blocks input (keyboard or mouse) to the window under the dialog ( fill out the dialog and press OK or CANCEL before you may do anything else in the page). A modeless dialog box does not block input to the window "under" the dialog. Note: More than one modeless dialog box may be displayed at a time. If more than one modal dialog box is displayed at a time, the boxes stack on top of each other and only the top dialog is active.