omnifaces

 - 

Available since OmniFaces 1.0

Collection of EL functions for string manipulation: of:abbreviate(), of:capitalize(), of:concat(), of:prettyURL(), of:encodeURL(), of:encodeURI(), of:encodeBase64(), of:escapeJS(), of:stripTags() and of:formatX().

Instead of of:formatX(), you can also use <o:outputFormat>.

Feature request

If you know more useful methods/functions which you think should be added to this OmniFaces utility class so that everyone can benefit from a "standard" Faces utility library, feel free to post a feature request.

Demo

Abbreviate a long string: Lorem ipsum dolor si...

Capitalize a string: Left

Concat 2 strings: leftright

Regex-replace a string: ”Lorem” ”ipsum” ”dolor” ”sit” ”amet”, ”consectetur” ”adipiscing” ”elit”.

Regex-match a string: true

Following functions deal with the following string: "STRING with díãçrïtìcs"

  • Create a pretty URL (part): string-with-diacritics check link URL (don't click :) )
  • URL-encode with UTF-8: STRING+with+d%C3%AD%C3%A3%C3%A7r%C3%AFt%C3%ACcs click link
  • Escape for usage in JavaScript: STRING with d\u00ed\u00e3\u00e7r\u00eft\u00eccs click to see alert

Format strings in EL:

  • one two
  • one two three four
  • one two three four five six
  • one two three four five six seven eight
  • one two three four five six seven eight nine ten

Strip tags from a string: string with some HTML

Demo source code
<c:set var="string1" value="Lorem ipsum dolor sit amet, consectetur adipiscing elit." />
<c:set var="string2" value="left" />
<c:set var="string3" value="right" />
<c:set var="string4" value="STRING with díãçrïtìcs" />
<c:set var="string5" value="&lt;p&gt;string &lt;strong class='class'&gt;with &lt;em attr&gt;some&lt;/em&gt;&lt;/strong&gt; &lt;abbr&gt;HTML&lt;/abbr&gt;&lt;/p&gt;" />

<p>
    Abbreviate a long string: #{of:abbreviate(string1, 20)}
</p>
<p>
    Capitalize a string: #{of:capitalize(string2)}
</p>
<p>
    Concat 2 strings: #{of:concat(string2, string3)}
</p>
<p>
    Regex-replace a string: #{of:replaceAll(string1, '\\b', '&#x201D;')}
</p>
<p>
    Regex-match a string: #{of:matches(string2, '\\p{IsLatin}+')}
</p>

<p>
    Following functions deal with the following string: "#{string4}"
</p>
<ul>
    <li>
        Create a pretty URL (part): #{of:prettyURL(string4)} 
        <a href="#{of:prettyURL(string4)}">check link URL</a> (don't click :) )
    </li>
    <li>
        URL-encode with UTF-8: #{of:encodeURL(string4)} 
        <a href="#{request.requestURI}?test=#{of:encodeURL(string4)}">click link</a>
    </li>
    <li>
        Escape for usage in JavaScript: #{of:escapeJS(string4)} 
        <a href="javascript:alert('#{of:escapeJS(string4)}')">click to see alert</a>
    </li>
</ul>

<p>
    Format strings in EL:
</p>
<ul>
    <li>#{of:format1('one {0}', 'two')}</li>
    <li>#{of:format2('one {0} three {1}', 'two', 'four')}</li>
    <li>#{of:format3('one {0} three {1} five {2}', 'two', 'four', 'six')}</li>
    <li>#{of:format4('one {0} three {1} five {2} seven {3}', 'two', 'four', 'six', 'eight')}</li>
    <li>#{of:format5('one {0} three {1} five {2} seven {3} nine {4}', 'two', 'four', 'six', 'eight', 'ten')}</li>
</ul>

<p>
    Strip tags from a string: #{of:stripTags(string5)}
</p>
Documentation & Sources

VDL documentation

API documentation

Java source code