From richfaces-svn-commits at lists.jboss.org Tue Oct 30 08:13:27 2007 Content-Type: multipart/mixed; boundary="===============0499482264940105812==" 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: r3616 - trunk/docs/userguide/en/src/main/docbook/included. Date: Tue, 30 Oct 2007 08:13:27 -0400 Message-ID: --===============0499482264940105812== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: vkorluzhenko Date: 2007-10-30 08:13:26 -0400 (Tue, 30 Oct 2007) New Revision: 3616 Modified: trunk/docs/userguide/en/src/main/docbook/included/panel.xml trunk/docs/userguide/en/src/main/docbook/included/panelBar.xml trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.xml trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.xml Log: http://jira.jboss.com/jira/browse/RF-920 - checked and added skins fixed er= rors in description of classes. Modified: trunk/docs/userguide/en/src/main/docbook/included/panel.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/panel.xml 2007-10-30 = 12:10:21 UTC (rev 3615) +++ trunk/docs/userguide/en/src/main/docbook/included/panel.xml 2007-10-30 = 12:13:26 UTC (rev 3616) @@ -172,7 +172,7 @@
Skin Parameters Redefinition - Skin parameters for the panel + Skin parameters redefinition for a whole component @@ -193,7 +193,7 @@
- Parameters for a header element + Skin parameters redefinition for a header element @@ -230,7 +230,7 @@
- Parameters for a body element + Skin parameters redefinition for a body element @@ -257,8 +257,9 @@
Definition of Custom Style Classes + On the screenshot there are classes names that define styles for= component elements.
- Style classes of panel + Style classes = @@ -266,7 +267,7 @@
- On the screenshot, there are classes names that define specified= elements. + =
Classes names that define a component appearance @@ -279,15 +280,15 @@ rich-panel - Defines styles for a wrapper <div> element of a = panel + Defines styles for a wrapper <div> element of a = component rich-panel-header - Defines styles for header element of a panel + Defines styles for a header element rich-panel-body - Defines styles for a panel body + Defines styles for a body elemnt Modified: trunk/docs/userguide/en/src/main/docbook/included/panelBar.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/panelBar.xml 2007-10-= 30 12:10:21 UTC (rev 3615) +++ trunk/docs/userguide/en/src/main/docbook/included/panelBar.xml 2007-10-= 30 12:13:26 UTC (rev 3616) @@ -46,9 +46,9 @@ Creating the Component with a Page TagHere is a simple example as it could be used on a page: = - - Example: - + + Example: + @@ -65,9 +65,9 @@
Creating the Component Dynamically Using Java = - - Example: - + + Example: +
Details of Usage - As it was mentioned above,= panelBar is used for grouping any - content on the client, thus its customization deals only with = specification of sizes and - styles for rendering. + As it was mentioned above, + panelBar is used for grouping any content= on the client, thus its + customization deals only with specification of sizes and style= s for rendering. "width" and @@ -106,12 +106,36 @@ it's described for its children).
+
+ Skin Parameters Redefinition +
+ Skin parameter redefinition for a whole component</tit= le> + <tgroup cols=3D"2"> + <thead> + <row> + <entry>Skin parameter</entry> + <entry>CSS properties</entry> + </row> + </thead> + <tbody> + <row> + <entry>headerBackgroundColor</entry> + <entry>border-color</entry> + </row> + </tbody> + </tgroup> + </table> + </section> + + <section> <title>Definition of Custom Style Classes - There is one predefined class for the panelBar, which is - applicable to the whole component, specifying padding, borders= , and etc. + There is one predefined class for the + <rich:panelBar> + , which is applicable to a whole component, specify= ing padding, borders, and + etc.
- Custom style class of panelBar + Style class = @@ -120,7 +144,7 @@
- Classes names that define a component appearance + Class name that define a component appearance @@ -131,15 +155,17 @@ rich-panelbar - Defines styles for a wrapper <div> e= lement of a panelbar + Defines styles for a wrapper <div> el= ement of a + component - =
- Other classes responsible for elements rendering are describ= ed for child panelBarItem - elements and could be found in the components chapters. - = + Other classes responsible for elements rendering are describ= ed for child + <rich:panelBarItem> + elements and could be found in the components chap= ters. + Style component classes @@ -152,35 +178,35 @@ styleClass - applicable to the whole panel together with= headers + Applicable to a whole component (together w= ith headers) headerClass - applicable to headers elements + Applicable to a header element contentClass - applicable to panels + Applicable to a content
In order to redefine styles for all - <rich:panelBar> - components on a page using CSS, it's enough to cr= eate classes with the - same names and define necessary properties in them. - = + <rich:panelBar> + components on a page using CSS, it's enough t= o create classes with + the same names and define necessary properties in them. + To change styles of particular - <rich:panelBar> - components, define your own style classes in the corre= sponding - <rich:panelBar> - attributes. + <rich:panelBar> + components, define your own style classes in the c= orresponding + <rich:panelBar> + attributes. CSS code piece used on a page: = - - Example: - + + Example: + When using headerClass and headerClassActive attributes the = declaration of headerClass should precede the one of headerClassActive: = - - Example: - + + Example: + ... ]]> - Hence, padding for all panelBars is cha= nged on a page as well as - a font for particular panelBarItems conte= nt. + Hence, padding for all + <rich:panelBar> + is changed on a page as well as a font for particu= lar + + <rich:panelBarItem> + content.
Relevant Resources Links Here you can see the example of <rich:panelBar> usa= ge and sources for the given example. - + >Here you can see the example of + <rich:panelBar> + usage and sources for the given example.
= Modified: trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.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/panelBarItem.xml 2007= -10-30 12:10:21 UTC (rev 3615) +++ trunk/docs/userguide/en/src/main/docbook/included/panelBarItem.xml 2007= -10-30 12:13:26 UTC (rev 3616) @@ -75,8 +75,13 @@
Details of Usage - The "label" attribute defines text to be represented. If you can use the - "label" facet,= you can even not use the "label"= attribute. + The + "label" + attribute defines text to be represented. If you can use= the + "label" + facet, you can even not use the + "label" + attribute. Example: @@ -89,10 +94,11 @@ ... ]]> - As it was mentioned above,= panelBarItem is used for grouping any - content inside within one panelBar, thus its cu= stomization deals only - with specification of sizes and styles for rendering. - panelBar could contain any number of child + As it was mentioned above, + panelBarItem is used for grouping any content i= nside within one + panelBar, thus its customization deals only w= ith specification of sizes + and styles for rendering. + panelBar could contain any number of child panelBarItem components inside, which content i= s uploaded onto the client and headers are controls to open the corresponding child element.
@@ -114,32 +120,32 @@
Skin Parameters Redefinition - Skin parameters for the panel content appearance + Skin parameters redefinition for a content - Skin parameters for a hint + Skin parameters CSS properties - panelTextColor + generalTextColor color - generalBackgroundColor - background-color + preferableDataSizeFont + font-size - border - tableBorderColor + preferableDataFamilyFont + font-family
- Parameters for panel header appearance + Skin parameters redefinition for a header element (active or = inactive) @@ -149,25 +155,41 @@ + headerTextColor + color + + headerBackgroundColor - border + background-color + + headerSizeFont + font-size + + + headerWeightFont + font-weight + + + headerFamilyFont + font-family +
Definition of Custom Style Classes + On the screenshot there are classes names that define styles for= component elements.
- PanelBarItem style classes + Style classes
- There are three predefined classes for the panelBarIte= m shown on the - screenshot and described in the table below + Classes names that define a component appearance @@ -180,22 +202,24 @@ rich-panelbar-header - Defines styles for a wrapper <div> element of a = panelbar item header + Defines styles for a wrapper <div> element of a h= eader + element - = + rich-panelbar-header-act - Defines styles for a wrapper <div> element of an= acting panelbar item header + Defines styles for a wrapper <div> element of an = active header + element - = + rich-panelbar-content - Defines styles for a panelbar item content + Defines styles for a content
- = + Style component classes @@ -208,27 +232,27 @@ headerClass - applicable to header elements + Applicable to a header element contentClass - applicable to panel elements + Applicable to a content
- = + In order to redefine styles for all - <rich:panelBarItem> - components on a page using CSS, it's enough to create= classes with the + <rich:panelBarItem> + components on a page using CSS, it's enough to crea= te classes with the same names and define necessary properties in them. - = + To change styles of particular - <rich:panelBarItem> - components, define your own style classes in the correspon= ding - <rich:panelBarItem> - attributes. + <rich:panelBarItem> + components, define your own style classes in the corresp= onding + <rich:panelBarItem> + attributes. CSS code piece used on a page: = @@ -243,7 +267,7 @@ } ... ]]> - The component is defined in the following way: + The component is defined in the following way: = Example: @@ -256,7 +280,11 @@ ... ]]> - Hence, a font size of all panelBarItem head= ers is changed on a page - as well as a font for the particular panelBarItem content. + Hence, a font size of all + <rich:panelBarItem> + headers is changed on a page as well as a font for the p= articular + <rich:panelBarItem> + content.
Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenu.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/panelMenu.xml 2007-10= -30 12:10:21 UTC (rev 3615) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenu.xml 2007-10= -30 12:13:26 UTC (rev 3616) @@ -234,9 +234,8 @@ = = -
- Look-and-Feel Customization + Definition of Custom Style Classes = As this component is just a wrapper for its children its provide= the only "rich-panel-menu" class for wrapper div element. To redefi= ne appearance of Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.= 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/panelMenuGroup.xml 20= 07-10-30 12:10:21 UTC (rev 3615) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenuGroup.xml 20= 07-10-30 12:13:26 UTC (rev 3616) @@ -255,12 +255,12 @@ Skin Parameters Redefinition = - Skin parameters redefinition for table element of the first l= evel group + Skin parameters redefinition for a table element of the first= level group = - Parameters for table element of the first level group + Skin parameters = CSS properties @@ -301,12 +301,12 @@
= - Skin parameters redefinition for table element of the second = and next levels groups + Skin parameters redefinition for a table element of second an= d next levels groups = - Parameters for table element of the second and next lev= els groups + Skin parameters = CSS properties @@ -347,12 +347,12 @@
= - Skin parameter redefinition for wrapped div element of the fi= rst level group + Skin parameters redefinition for wrapper div element of the f= irst level group = - Parameter for wrapped div element of the first level gr= oup + Skin parameters = CSS properties @@ -372,7 +372,7 @@ =
Definition of Custom Style Classes - + On the screenshot there are classes names that define styles for= component elements.
Classes names = @@ -383,10 +383,8 @@
= - On the screenshot, there are classes names defining specified el= ements. -
- Classes names that define an upper level nodes + Classes names that define an upper level groups = @@ -426,7 +424,7 @@
= - Classes names that define a second and lower level nodes</tit= le> + <title>Classes names that define a second and lower level groups</ti= tle> = <tgroup cols=3D"2"> <thead> Modified: trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.x= ml =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/panelMenuItem.xml 200= 7-10-30 12:10:21 UTC (rev 3615) +++ trunk/docs/userguide/en/src/main/docbook/included/panelMenuItem.xml 200= 7-10-30 12:13:26 UTC (rev 3616) @@ -263,7 +263,7 @@ <tgroup cols=3D"2"> <thead> <row> - <entry>Parameters for table element item of first level</entry> + <entry>Skin parameters</entry> = <entry>CSS properties</entry> </row> @@ -304,7 +304,7 @@ </table> = <table> - <title>General skin parameter redefinition for disabled item + Skin parameter redefinition for a disabled item = @@ -330,7 +330,7 @@ =
Definition of Custom Style Classes - + On the screenshot there are classes names that define styles for= component elements.
Classes names = @@ -341,9 +341,7 @@
= - On the screenshot, there are classes names defining specified el= ements. - -
+
Classes names that define first level items = --===============0499482264940105812==--