Apache MyFaces Trinidad - <tr:convertColor>

Foundation

Project Documentation

Summary

Tag name: <tr:convertColor>

type: org.apache.myfaces.trinidad.Color
Converts an strings to and from java.awt.Color objects. The set of patterns used for conversion can be overriden.

Example(s):

<tr:inputColor id="sicConv" chooseId="cpConv"
  label="Enter or select color from palette below"
  value="#{color.colorValue1}">
  <tr:convertColor  patterns="rrr-ggg-bbb #RRGGBB" transparentAllowed="false" />
</tr:inputColor>
<tr:chooseColor id="cpConv"
  colorData="#{requestContext.colorPalette.default49}"/>

Attributes

Name	Type	Supports EL?	Description
messageDetailConvert	String	Yes	Custom error message to be used, for creating detail part of faces message, when users input does not match the specified pattern. Parameters: {0} the label that identifies the component {1} value entered by the user {2} the pattern the converter is expecting
patterns	String[]	Yes	The set of acceptable patterns, as a whitespace sepa rated list. The first pattern in the list will be used for formatting java.awt.Color values. All patterns will be tried in order to convert Strings back into java.awt.Colors. If no patterns are set, the default is "#RRGGBB r,g,b".
transparentAllowed	boolean	Yes	Whether the converter should allow generation of a " transparent" color (a black color with an alpha of zero). The converter uses a String version of "transparent" that is translated for the user's locale.

Name

Type

Supports EL?

Description

messageDetailConvert

String

Yes

Custom error message to be used, for creating detail part of faces message, when users input does not match the specified pattern.

Parameters:

{0} the label that identifies the component
{1} value entered by the user
{2} the pattern the converter is expecting

patterns

String[]

Yes

The set of acceptable patterns, as a whitespace sepa rated list. The first pattern in the list will be used for formatting java.awt.Color values. All patterns will be tried in order to convert Strings back into java.awt.Colors. If no patterns are set, the default is "#RRGGBB r,g,b".

transparentAllowed

boolean

Yes

Whether the converter should allow generation of a " transparent" color (a black color with an alpha of zero). The converter uses a String version of "transparent" that is translated for the user's locale.