From richfaces-svn-commits at lists.jboss.org Mon Mar 31 08:31:49 2008 Content-Type: multipart/mixed; boundary="===============2062792012165534884==" 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: r7457 - trunk/docs/userguide/en/src/main/docbook/modules. Date: Mon, 31 Mar 2008 08:31:49 -0400 Message-ID: --===============2062792012165534884== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: msorokin Date: 2008-03-31 08:31:49 -0400 (Mon, 31 Mar 2008) New Revision: 7457 Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml Log: http://jira.jboss.com/jira/browse/RF-2408 Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover= .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/modules/RFCarchitectover.xml 2= 008-03-31 12:29:32 UTC (rev 7456) +++ trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2= 008-03-31 12:31:49 UTC (rev 7457) @@ -1558,7 +1558,684 @@ + = +
+ Standard controls skinning + The feature is designed to unify the look and feel of standard= HTML element and RichFaces components. = + Skinning can be applied to all controls on a page basing on elemen= t' = + name and attribute type (where applicable). Also this feature + provides a set of CSS styles so that skinning can be applied = + assigning rich-* classes to particular elements or to container of= elements that nests controls. + = + = + = + + Standard controls skinning feature provides 2 levels of skinning: + = + + + + Basic provides customization only basic style properties + = + + Appling the level of skinning is based on detecting User Age= nt. Basic level of skinning is applied: + + + + + Advanced= extends basic level introducing = + broader number of style properties and is applied to browser= s with rich visual styling capability of controls + + + = + = + +Appling the level of skinning is based on detecting User Agent. If User Ag= ent is not detected, Advanced level is used. = + + + To the following browsers Basic level of skinning is applied: + = + = + + Standard controls skinning feature provides 2 levels of skinning, = while skinning is based on detecting User Agent. If User Agent is not detec= ted, Advanced level is used. + = + + + + Basic provides customization only basic style properties. = + + + To the following browsers Basic level of skinning is applied: + = + + Internet Explorer 6 + Internet Explorer 7 in BackCompat mode (seedo= cument.compatMode property in MSDN) + Opera + Safari + = + + = + + + + Advancedextends basic level introducing broader = + number of style properties and is applied to browsers with r= ich visual styling capability of controls + + + The following browsers support Advanced level of skinning: = + = + + Mozilla Firefox + Internet Explorer 7 in Standards-compliant mode ( CSS1= Compat) mode + + = + + = + = + = + + = + These are the elements that affected by skinning: + + + input + select + textarea + keygen + isindex + legend + fieldset + hr + a (together with a:hover, a:visited "pse= udo"-elements) = + + = + + Skinning can be initialized in two ways: = + + + + adding org.richfaces.CONTROL_SKINNING parmeter to web.xml. Va= lues: "enable" and "disable". + This way implies that skinning style classes are applied to element= s by element name and type attribute (where applicable). No additional step= s required from an application developer. = + Please find below the table that contains the list of element to w= hich skinning a applicable. + + + + + adding org.richfaces.CONTROL_SKINNING_CLASSES parameter to web= .xml file. Possible values "enable" and "disable". + Implementation of this method implies the provision of several styl= e classes for different types of elements. = + The style classes have predefined names. Application developer shou= ld manually assign classes to controls that needs skinning or assign class = to an element that contains controls. = + + + = + = + + By setting org.richfaces.CONTROL_SKINNING_CLASSES to "enable&q= uot; you are provided with style classes applicable to: + + = + + + + Basic elements nested inside element having rich-container clas= s, e.g.: + + + Example: + + + + + + Elements that has class name corresponding to one of the basic = elements name/type mapped by the following scheme = + rich-<elementName>[-<elementType>]. See the example: + + + Example: + = + = + = + + Note: + + a elements have classes based on "link" and pseudo = class name, e.g.: rich-link, rich-link-hover, rich-link-visited + + = + + = + = +
+ = + Basic level + = + = + + Html Elements Skin Bindings for input, select, textarea, butto= n, keygen, isindex, legend + + + + CSS Properties + Skin parameters + + + + = + + font-size + generalSizeFont + + + font-family + generalFamilyFont + + + color + controlTextColor + + + +
= + = + = + + Html Elements Skin Bindings for fieldset + + + + CSS Properties + Skin parameters + + + = + + = + + border-color + panelBorderColor + + + +
+ = + = + = + + Html Elements Skin Bindings for hr + + + + CSS Properties + Skin parameters + + + = + = + + border-color + panelBorderColor + + + +
+ = + + Html Elements Skin Bindings for a + + + + CSS Properties + Skin parameters + + + = + = + + = + + color + generalLinkColor + + = + + +
+ = + + Html Elements Skin Bindings for a:hover + + + + CSS Properties + Skin parameters + + + = + = + + color + hoverLinkColorgeneralLinkColor + = + + +
+ = + = + + Html Elements Skin Bindings for a:visited + + + + CSS Properties + Skin parameters + + + = + = + + color + visitedLinkColor + = + + +
+ = + = + = + = + + Rich Elements Skin Bindings for .rich-input, .rich-select, .r= ich-textarea, .rich-button, .rich-keygen, .rich-isindex, .rich-legend, .ric= h-link + + + + CSS Properties + Skin parameters + + + + + + font-size + generalSizeFont + + + font-family + generalFamilyFont + + + color + controlTextColor + + + +
+ = + = + = + = + + Rich Elements Skin Bindings for .rich-fieldset + + + + CSS Properties + Skin parameters + + + = + + border-color + panelBorderColor + + + +
+ = + = + + Rich Elements Skin Bindings for .rich-hr + + + + CSS Properties + Skin parameters + + + = + + + border-color + panelBorderColor + + + +
+ = + = + + Rich Elements Skin Bindings for .rich-link + + + + CSS Properties + Skin parameters + + + = + = + + color + generalLinkColor + + + +
+ = + = + = + = + + Rich Elements Skin Bindings for .rich-link:hover + + + + CSS Properties + Skin parameters + + + = + = + + color + hoverLinkColor + + = + + +
= + = + = + = + + Rich Elements Skin Bindings for .rich-link:visited + + + + CSS Properties + Skin parameters + + + = + + = + + color + visitedLinkColor + + = + + +
= + = + = + = + = +
+ = + = +
+ = + Advanced level = + = + + = + + + Html Elements Skin Bindings for input, select, textarea, butt= on, keygen, isindex + + + + CSS properties + Skin parameters + + + + + border-width + 1px + + + border-color + panelBorderColor + + + color + controlTextColor + + = + = + = + = + + +
= + = + = + = + Html Elements Skin Bindings for *|button + + + + CSS properties + Skin parameters + + + + = + = + + border-color + panelBorderColor + + = + + font-size + generalSizeFont + + = + + font-family + generalFamilyFont + + = + + color + headerTextColor + + = + + background-color + headerBackgroundColor + + = + + background-image + org.richfaces.renderkit.html.images.ButtonBackgroundIma= ge + + = + = + + +
= + = + = + = + + Html Elements Skin Bindings for button[type=3Dbutton], butt= on[type=3Dreset], button[type=3Dsubmit], input[type=3Dreset], input[type=3D= submit], input[type=3Dbutton] + + + + CSS properties + Skin parameters + + + + = + + border-color + panelBorderColor + + = + + font-size + generalSizeFont + = + = + = + = + + font-family + generalFamilyFont + + = + + color + headerTextColor + = + = + = + + background-color + headerBackgroundColor + + = + + background-image + org.richfaces.renderkit.html.images.ButtonBackgroundIma= ge + = + + +
= + = + = + = + + Html Elements Skin Bindings for *|textarea + + + + CSS properties + Skin parameters + + + + + + border-color + panelBorderColor + = + = + + font-size + generalSizeFont + + = + + font-family + generalFamilyFont + = + = + = + = + + color + controlTextColor + + = + + background-color + controlBackgroundColor + = + = + = + = + + background-image + org.richfaces.renderkit.html.images.InputBackgroundImag= e + + + +
= + = + = + = + = + + Html Elements Skin Bindings for textarea[type=3Dtextarea]= , input[type=3Dtext], input[type=3Dpassword], select + + + + CSS properties + Skin parameters + + + = + + border-color + panelBorderColor + + = + + font-size + generalSizeFont + = + = + = + = + = + + font-family + generalFamilyFont + + = + + color + controlTextColor + = + = + = + = + = + + background-color + controlBackgroundColor + + = + + background-image + org.richfaces.renderkit.html.images.InputBackgroundImag= e + = + = + + +
+ = + = +
= + = +
+ = + =