diff --git a/spring-webflow-reference/src/spring-faces.xml b/spring-webflow-reference/src/spring-faces.xml index 5e53fbb5..f033f855 100644 --- a/spring-webflow-reference/src/spring-faces.xml +++ b/spring-webflow-reference/src/spring-faces.xml @@ -127,6 +127,51 @@ .xhtml ]]> + + For optimal page-loading performance, the Spring Faces component library includes a few special components: + includeStyles and includeScripts. These components will eagerly load the neccessary + CSS stylesheets and JavaScript files at the position they are placed in your JSF view template. In accordance + with the recommendations of the Yahoo Performance Guildlines, these two tags should be placed in the head + section of any page that uses the Spring Faces components. For example: + + + + + + + Spring Faces: Hotel Booking Sample Application + + + + + + +... + +]]> + + + This shows the opening of a typical Facelets XHTML layout template that uses these components to force the loading of + the needed CSS and JavaScript resources at the ideal position. + + + The includeStyles component includes the necessary resources for the Dojo widget theme. By default, it includes + the resources for the "tundra" theme. An alternate theme may be selected by setting the optional "theme" and "themePath" attributes + on the includeStyles component. For example: + + +]]> + + + will try to load a CSS stylesheet at "/styles/foobar/foobar.css" using the Spring JavaScript ResourceServlet. + Configuring Web Flow to render JSF views @@ -566,7 +611,7 @@ Enhancing The User Experience With Rich Web Forms - JSF and Web Flow combine to provide and extensive server-side validation model for your web application, but + JSF and Web Flow combine to provide an extensive server-side validation model for your web application, but excessive roundtrips to the server to execute this validation and return error messages can be a tedious experience for your users. Spring Faces provides a number of client-side rich validation controls that can enhance the user experience by applying simple validations that give immediate feedback. Some simple