Author: smukhina Date: 2007-09-04 10:55:48 -0400 (Tue, 04 Sep 2007) New Revision: 2737 Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataFilterSlider/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataGrid/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataLists/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/dragSupport/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/dropDownMenu/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/gmap/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/htmlCommandLink/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSlider/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSpinner/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/repeat/usage.xhtml trunk/samples/richfaces-demo/src/main/webapp/richfaces/separator/usage.xhtml Log: http://jira.jboss.com/jira/browse/RF-524 language is checked Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -8,11 +8,11 @@ <ui:composition template="/templates/component-sample.xhtml"> <ui:define name="sample"> <p> - Additionally to the listeners provided by JSF specification, RichFaces add one more: + Additionally to the listeners provided by the JSF specification, RichFaces adds one more: Ajax Listener (a4j:ajaxListener). Ajax Listener is invoked before the Render Response - phase. Instead of Action Listener of Value Change Listener which are not invoked when - Validation of Update Model phases failed, Ajax Listener is guarantied to be invoked - for each Ajax Response. Hence, it is a good place to update the list of re-rendered + phase. Instead of Action Listener or Value Change Listener which is not invoked when + Validation of the Update Model phases fails, Ajax Listener is guarantied to be invoked + for each Ajax Response. Hence, it is a good way to update a list of re-rendered components, for example. </p> <p> @@ -22,7 +22,7 @@ </p> <p> - <b>type</b> attribute defines the fully qualified Java class name for listener. This + <b>type</b> attribute defines the fully qualified Java class name for the listener. This class should implement org.ajax4jsf.events.AjaxListener interface. You can access to the source of the event (Ajax component) using event.getSource() call. </p> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataFilterSlider/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataFilterSlider/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataFilterSlider/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -11,7 +11,7 @@ <p>The Slider component can be used to filter any UIData object or can be used independently to send its values to the backing bean. It - has 2 modes, the first mode stores the UIData object on session so user interaction will work smoothly. The second just sends the + has 2 modes, the first mode stores the UIData object on session, so as user interaction will work smoothly. The second just sends the previous and new values as a "sliderEvent" to the backing bean.</p> <div class="sample-container"> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataGrid/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataGrid/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataGrid/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -13,7 +13,7 @@ <p>The component takes a list from a model and outputs it the same way as with &lt;h:PanelGrid&gt; for inline data. To define grid properties and styles, use the same definitions as for &lt;h:panelGrid&gt;.<br /> - The folowing example shows the dataGrid component in use: + The following example shows the dataGrid component in use: </p> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataLists/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataLists/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataLists/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -13,8 +13,7 @@ <p>Data Lists components allows to generate DL, DT and DD lists using lists from the model bean. <br /> - The folowing example shows the dataList component in use. Two another comopnents - has the same usage. + The following example shows the dataList component in use. Two another components could be used in the same way. </p> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -14,7 +14,7 @@ enables row and column spans for columns, a flexible layout for a header and a footer. DataTable supports "master-detail" pattern and allows to show the combination of a master table and detail sub-tables.<br /> - The folowing example shows the dataTable component in use: + The following example shows the dataTable component in use: </p> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/dragSupport/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/dragSupport/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/dragSupport/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -23,21 +23,21 @@ </p> <p>Drag Indicator is a special visual representation of a dragged object. It contains - a drag marker and a drag label by default, but you can freely define the layout you want using + a drag marker and a drag label by default, but you can freely define the necessary layout using a "single" facet for drag-n-drop of a single object or "multiple" for drag-n-drop on the group of objects</p> <p> - <i>Note: The parent component for dragSupport and dropSupport should be designed to render + <i>Note: The parent component for dragSupport and dropSupport should be designed to render its children and has two attribute &quot;onmouseover&quot; and &quot;onmouseout&quot;. You can use &lt;a4j:outputPanel&gt; as - an container if the component is not satisfy this requirements. Use &lt;a4j:outputPanel&gt; layout="block" - to wrap the component with a block type layout. We will work to eliminate this restriction in the + a container if the component is not satisfy this requirements. Use &lt;a4j:outputPanel&gt; layout="block" + to wrap the component with a block type layout. We will work to eliminate this restriction in future.</i> </p> <p>The following example demonstrates the drag-n-drop functionality on practice. The left list - contains the examples of Ajax frameworks. Do you know them? The demo helps you to sort them. + contains the examples of Ajax frameworks. Do you know them? The demo helps you to sort them out. Drag one and drag over the headers of three panels. If the draggable framework is suitable for a certain framework family, it will be accepted. Otherwise, the drag indicator shows the "reject" icon.</p> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/dropDownMenu/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/dropDownMenu/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/dropDownMenu/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -10,8 +10,8 @@ - <p>RichFaces Drop Down menu is a component that allows orginize the hierarchical menu - similar to one that almost every desktop application have. + <p>RichFaces Drop Down menu is a component that allows to organize the hierarchical menu + similar to one that almost every desktop application has. </p> <div class="sample-container"> @@ -22,17 +22,17 @@ </ui:include> </div> - <p>The drop down menu has label that always appears on the page and invisible panel - that appears by particular client side event (onmouseover, onclick etc). The event is - defined with 'event' attribute.</p> - <p>Drop Down Menu can contains set of Menu Items, Menu Groups and Menu Separators. - Group plays the role of label for secondary levels on the menu. Separator is represented with - horizontal lines between the items or groups. Item is a active element that might produce + <p>The drop down menu has a label that always appears on the page and invisible panel + that appears with a particular client side event (onmouseover, onclick etc). The event is + defined with an 'event' attribute.</p> + <p>Drop Down Menu can contains a set of Menu Items, Menu Groups and Menu Separators. + Group plays a role of label for secondary levels on the menu. Separator is represented with + horizontal lines between the items or groups. An item is an active element that might produce Ajax or non-Ajax requests. The submittion mode is defined with 'submitMode' attribute that has three possible options - "server", "ajax" or "none". Mode "none" does not produce any request, but - allows developers to provide own functionality inside the menu item with inline content. + allows you to provide your own functionality inside the menu item with an inline content. </p> - <p>You can place the block of drop down menus horizontally or vertially how it is shown below. + <p>You can place a block of drop down menus horizontally or vertially how it is shown below. </p> <div class="sample-container"> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/gmap/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/gmap/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/gmap/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -10,15 +10,15 @@ <p>The - Richfaces Gmap component is a wrapper for standard Google Map widgets. You can use the whole set of + Richfaces Gmap component is a wrapper for the standard Google Map widgets. You can use the whole set of functionality Google Map API provides for you. See <a target="_blank" href="http://www.google.com/apis/maps/documentation/"> - Google Maps API Version 2 Documentation</a> for Google Map API fetures. + Google Maps API Version 2 Documentation</a> for Google Map API features. </p> <p> Gmap has built-in Ajax capability. You do not need to uptade the component using reRender to see the changes. RichFaces Gmap component is good together with Ajax4jsf jsFunction - component that allows to invoke the server side data and return it in a JSON format. + component that allows to invoke the server side data and convert it into a JSON format. </p> <ui:include src="/richfaces/gmap/examples/mapUsage.xhtml"/> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/htmlCommandLink/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/htmlCommandLink/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/htmlCommandLink/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -12,15 +12,15 @@ </p> <p> - h:commandLink renderer generates the javascript code that is used to submit the form when the link + h:commandLink renderer generates the JavaScript code that is used to submit a form when a link is clicked. However, if the h:commandLink is rendered outside of the form, for example, when - you point to it with reRender, the wrong code is generated that causes the broken functionality. + you point to it with reRender, the wrong code is generated that causes incorrect functionality. This issue could be solved by a4j:form usage. </p> - <p>But another problem that the link should render hidden inputs - for its parameters encoding. And this fields will not be generated if the link was not initially rendered and - then updated via ajax. So this problems solves with the a4j:htmlCommandLink usage. Nesessary fields encodes - even when link is not rendered initially. So it may be ajax updated and parameters will work correctly. + <p>But another problem is that the link should render hidden inputs + for its parameters encoding. And these fields are not generated if the link is not initially rendered and + then updated via Ajax. Such problems could be solved with the a4j:htmlCommandLink usage. Necessary fields are encoded + even when the link is not rendered initially. Hence it may be Ajax updated and parameters work correctly. </p> <rich:insert highlight="xhtml" src="/richfaces/htmlCommandLink/snippets/commandLinkProblem.xhtml"></rich:insert> </ui:define> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSlider/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSlider/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSlider/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -8,7 +8,7 @@ <ui:composition template="/templates/component-sample.xhtml"> <ui:define name="sample"> <p> - InputNumberSlider is highly customizable components used to define numeric input in a given range. User can use slider or just type in input field. + InputNumberSlider is a highly customizable component that is used to define numeric input in a given range. You can use a slider or just type some text into an input field. </p> <div class="sample-container" > <ui:include src="/richfaces/inputNumberSlider/examples/sliderUsage.xhtml"/> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSpinner/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSpinner/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/inputNumberSpinner/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -8,7 +8,7 @@ <ui:composition template="/templates/component-sample.xhtml"> <ui:define name="sample"> <p> - InputNumberSpinner is a highly customizable component used to define numeric input in a given range. A user can use a spinner control or just type in an input field. + InputNumberSpinner is a highly customizable component that is used to define a numeric input in a given range. A user can use a spinner control or just type some text into an input field. </p> <div class="sample-container" > <ui:include src="/richfaces/inputNumberSpinner/examples/spinnerUsage.xhtml"/> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/repeat/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/repeat/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/repeat/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -15,7 +15,7 @@ Additionally to facelets &lt;ui:repeat&gt; component it allows to update a set of its children instead of the whole using AJAX reuqests. <br /> - The folowing example shows the repeat component in use. + The following example shows the repeat component in use. There you could explore how to make updatable the only two concrete cells of the table using Ajax Keys. </p> Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/separator/usage.xhtml =================================================================== --- trunk/samples/richfaces-demo/src/main/webapp/richfaces/separator/usage.xhtml 2007-09-04 14:50:47 UTC (rev 2736) +++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/separator/usage.xhtml 2007-09-04 14:55:48 UTC (rev 2737) @@ -7,8 +7,8 @@ <ui:composition template="/templates/component-sample.xhtml"> <ui:define name="sample"> <p> - Separator is used to draw a horizontal line on a page. You may specify different types of a line, possible values are "beveled" (default), "dotted", "dashed", "double" and "solid". - You also may specify width, height and alignment for the separator. + Separator is used to draw a horizontal line on a page. You may specify different types of a line, the possible values are "beveled" (default), "dotted", "dashed", "double" and "solid". + You also can specify width, height and alignment for the separator. </p> <div class="sample-container">