From richfaces-svn-commits at lists.jboss.org Wed Dec 31 06:37:08 2008 Content-Type: multipart/mixed; boundary="===============1042404446238132580==" MIME-Version: 1.0 From: richfaces-svn-commits at lists.jboss.org To: richfaces-svn-commits at lists.jboss.org Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r12081 - trunk/docs/userguide/en/src/main/docbook/included. Date: Wed, 31 Dec 2008 06:37:04 -0500 Message-ID: --===============1042404446238132580== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: atsebro Date: 2008-12-31 06:37:01 -0500 (Wed, 31 Dec 2008) New Revision: 12081 Modified: trunk/docs/userguide/en/src/main/docbook/included/messages.xml Log: RF-4433: describing new feature Modified: trunk/docs/userguide/en/src/main/docbook/included/messages.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/docs/userguide/en/src/main/docbook/included/messages.xml 2008-12-= 31 10:13:35 UTC (rev 12080) +++ trunk/docs/userguide/en/src/main/docbook/included/messages.xml 2008-12-= 31 11:37:01 UTC (rev 12081) @@ -71,138 +71,72 @@ =
Details of Usage - The component has the same behavior as standard= - <h:message> - component except next features: <= itemizedlist> - - It's ajaxRend= ered. It means that - the component is reRende= red after Ajax - request automatically wi= thout - outputPanel usage. - - - The component opti= onally provides - "passed" state= which - will be shown if no mess= age to be - displayed. - - - Provides possibili= ty to add some marker to - message. By default, a m= arker element - isn't shown. - - + The <rich:messa= ges> component is considered as JSF HTML <h:message>, = + extended with following features: + + Ajax support (the componen= t does not require to be wrapped in <a= 4j:outputPanel> in order to be rendered during Aja= x requests); + possibilty to add graphica= l markers (pictograms) to reinforce a message for both "passed" o= r "failed" states; + set of predefined CSS clas= ses for customizing messages appearance. = = + - The component provides two parts to be optionall= y defined: marker and - informational label before the marker for ev= ery message. - Set of facet which can be used for a marker def= ining: - - - "passedMa= rker" - . This facet = is provided to - allow setting a marker t= o be displayed - if there is no message.<= /para> - - - - "errorMar= ker" - . This facet = is provided to - allow setting a marker t= o be displayed - if there is a message wi= th a severity - class of - "ERROR". - - - - "fatalMar= ker" - . This facet = is provided to - allow setting a marker t= o be displayed - if there is a message wi= th a severity - class of - "FATAL". - - - - "infoMark= er" - . This facet = is provided to - allow setting a marker t= o be displayed - if there is a message wi= th a severity - class of - "INFO". - - - - "warnMark= er" - . This facet = is provided to - allow setting a marker t= o be displayed - if there is an message w= ith a severity - class of - "WARN". - - - + There are two optional parts that could be defined f= or every message: marker and text label. The set of facets, which can be us= ed for a marker definition, is shown below: + = + + Facets + + + + Facet + Description + + + + + errorMarker + Defines marker for "Er= ror" message severity class + + + fatalError + Defines marker for "Fa= tal" message severity class + + + infoError + Defines marker for "In= fo" message severity class + + + warnError + Defines marker for "Wa= rn" message severity class + + + passedError + Defines marker if there is = no message + + + +
+ = + The following example shows different variants of cu= stomization of the component. = - The following example shows different variants o= f customization of the - component. - Example: - + + - - + + - - + + - = - -... -]]> + +]]> + = + The <rich:messa= ges> component keeps all messages for all componen= ts even after only one ajax-validated component was updated. = = =
= -
- Facets - - Facets - - - - Facet - Descrip= tion - - - - - errorMa= rker - Redefin= es the content for the marker if there is message with a severity class of = "ERROR" - - - fatalEr= ror - Redefin= es the content for the marker if there is message with a severity class of = "FATAL" - - - infoErr= or - Redefin= es the content for the marker if there is message with a severity class of = "INFO" - - - warnErr= or - Redefin= es the content for the marker if there is message with a severity class of = "WARN" - - - passedE= rror - Redefin= es the content for the marker if there is no message - - - -
-
- -
+
Look-and-Feel Customization = For skinnability implementation, the components = use a --===============1042404446238132580==--