Differences between revisions 1 and 2
Revision 1 as of 2008-02-12 08:54:11
Size: 5022
Editor: 62
Comment: Clone page MyFacesComponents
Revision 2 as of 2008-02-12 09:10:26
Size: 5090
Editor: 62
Comment: Remove obsolete info
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Note: currently these pages are in transition between the 1.0.9 "myfaces-extensions" and the current HEAD. "myfaces-extensions" are renamed "Tomahawk" in the HEAD. New material should describe the situation for Tomahawk 1.1.0, i.e., the version the current HEAD is working to. = The Official Tomahawk Site =
Line 3: Line 3:
For more information, go to: http://myfaces.apache.org/tomahawk/index.html. The official site for the Tomahawk library can be found at http://myfaces.apache.org/tomahawk/index.html.

This page is a community-maintained page that contains additional information and errata (corrections) for information on the above site.
Line 124: Line 126:

== Historical Information ==

The very early releases (pre 1.1.0) of the above components were called "myfaces-extensions", not Tomahawk.

The Official Tomahawk Site

The official site for the Tomahawk library can be found at http://myfaces.apache.org/tomahawk/index.html.

This page is a community-maintained page that contains additional information and errata (corrections) for information on the above site.

Configuring your JSP or JSPX pages to use MyFaces components

  • ["MyFaces 1.1.0 Tomahawk Components"]: Using MyFaces 1.1.0 Tomahawk Components in your pages

  • ["MyFaces 1.0.9 Extension Components"]: Using MyFaces 1.0.9 Extension Components in your pages

In any case, the actual prefix or XML namespace you use is for you to decide. The prefix or XML namespace does not have to be x, resp. t, but merely has to be unique in the XML document, and used consistently within that XML document. The prefix x, resp. t is merely a suggestion by the MyFaces authors, but is used by most developers nevertheless.

Note that in the above examples of the XML compliant syntax, the xml:lang attribute describes the language of the XML document itself, !not! of the rendered HTML document.

  • ["Use Facelets with MyFaces"] or ["Use_Facelets_with_Tomahawk"]: To use custom myfaces components with facelets, you must also create a tomahawk.taglib.xml facelets configuration file.

Validators

  • ["validateCreditCard"]: validate that a String is a valid credit card number
  • ["validateISBN"]: validate that a String is a valid ISBN number
  • ["validateRegExpr"]: general validator that checks compliance with a regular expression
  • ["validateEmail"]: validate that a String is an email address
  • ["validateEqual"]
  • ["validateCompareTo"]: validate that the current component value compares to another component's value in a certain way. (validateEqual contains a subset of this component's functionality.)

Components

Tomahawk offers an extended versions of the standard components, and a number of more advanced additional components. To see tomahawk examples in action, go to: http://www.irian.at/myfaces/home.jsf

Extended Version of Standard Components

All standard components have an equivalent version in Tomahawk. These extended versions feature additional attributes.

Extended features:

  • ["User-role Awareness"] Render the component visible and/or enabled based on the user-roles of the current user.
  • ["DisplayValueOnly"] Toggle between output/input mode

  • ["forceId"] Do not let JSF generate an assembled id of the ids of the component and its parents, instead use the provided id.
  • ["ExtendedMessagesSupport"] Messages automatically replace the id of the message with the corresponding label or column header.

The following standard components have been additionally enhanced:

Advanced Additional Components

Sandbox:

The sandbox is growing really fast and the list below is terribly outdated. You really need to download the nightly build to see all the exciting stuff it contains. Daily builds of sandbox examples can be found at: http://www.irian.at/myfaces.jsf (go to "MyFaces Sandbox Examples latest build")

Specials

Historical Information

The very early releases (pre 1.1.0) of the above components were called "myfaces-extensions", not Tomahawk.

Tomahawk (last edited 2009-09-20 23:00:38 by localhost)