Description
Converter which modifies a string by changing the input text into upper case, lower case, capitalized. The input string can be optionally trimmed and truncated at some max length. Ellipses (...) can be added to a truncated string.
API
component-family | Converter |
component-class | org.apache.myfaces.custom.convertStringUtils.StringConverter |
tag-class | org.apache.myfaces.custom.convertStringUtils.StringConverterTag |
Usage
<h:outputText value="#{backingBean.customer.name}"> <s:convertStringUtils format="capitalize" trim="true"/> </h:outputText> <h:outputText value="#{backingBean.customer.description}"> <s:convertStringUtils trim="true" maxLength="64" appendEllipsesDuringOutput="true"/> </h:outputText> <h:inputText value="#{backingBean.customer.stateCode}"> <s:convertStringUtils format="uppercase" /> </h:inputText>
Syntax
<s:convertStringUtils/>
format - (optional) one of uppercase|lowercase|capitalize.
maxLength - (optional) maximum length of the output string. Strings longer than maxLength will be truncated.
trim - (optional) boolean value (true|false) determining if the string will be trimmed before other operations are applied. Default is false.
appendEllipsesDuringInput - (optional) boolean value (true|false). If true ellipsis (...) will be append to the string if it is truncated. Default is false.
appendEllipsesDuringOutput - (optional) boolean value (true|false). If true ellipsis (...) will be append to the string if it is truncated. Default is false.