Author: artdaw Date: 2008-03-24 13:49:04 -0400 (Mon, 24 Mar 2008) New Revision: 7139 Modified: trunk/docs/userguide/en/src/main/docbook/included/pickList.xml Log: http://jira.jboss.com/jira/browse/RF-2174 - component review Modified: trunk/docs/userguide/en/src/main/docbook/included/pickList.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/pickList.xml 2008-03-24 17:40:45 UTC (rev 7138) +++ trunk/docs/userguide/en/src/main/docbook/included/pickList.xml 2008-03-24 17:49:04 UTC (rev 7139) @@ -56,7 +56,7 @@ <programlisting role="XML"><![CDATA[... <rich:pickList value="#{pickBean.listValues}"> <f:selectItem itemValue="Bentley" itemLabel="Bentley"/> - <f:selectItem itemValue="Audi" itemLabel="Audi"/> + <f:selectItems value="#{pickBean.testList}"/> </rich:pickList> ...]]></programlisting> </section> @@ -73,9 +73,6 @@ </section> <section> <title>Details of Usage</title> - - <!--maintenance of component orderingList--> - <para>The <emphasis role="bold"> <property>&lt;rich:pickList&gt;</property> </emphasis> component consists of <itemizedlist> @@ -87,14 +84,12 @@ </itemizedlist> </para> - <!-- attributes of component orderingList --> - <para> - The <emphasis> - <property> &quot;value&quot;</property> - </emphasis> - attribute is used to access the values of a target list. The <emphasis> - <property> &quot;selectItems&quot;</property></emphasis> facet is used to access the values of a source list. + The <emphasis><property>&quot;value&quot;</property></emphasis> attribute is used to access the values of a target list. + </para> + <para> + The <emphasis role="bold"><property>&lt;f:selectItem /&gt;</property></emphasis> or <emphasis role="bold"> + <property>&lt;f:selectItems /&gt;</property></emphasis> facets are used to access the values of a source list. </para> <para> <emphasis role="bold">Example:</emphasis> @@ -106,47 +101,17 @@ <f:selectItems value="#{pickBean.testList}"/> </rich:pickList> ...]]></programlisting> + <para> - The <emphasis role="bold"> - <property>&lt;rich:pickList&gt;</property></emphasis> - component provides resizing of lists by using such attributes as: - <itemizedlist> - <listitem> - <emphasis> - <property> &quot;listsHeight&quot;</property></emphasis> defines height of the lists. - - </listitem> - <listitem> - <emphasis> - <property> &quot;sourceListWidth&quot;</property></emphasis> defines width of a source list. - - </listitem> - <listitem> - <emphasis> - <property> &quot;targetListWidth&quot;</property></emphasis> defines width of a target list. - - </listitem> - </itemizedlist> + The <emphasis> <property> &quot;switchByClick&quot;</property></emphasis> attribute provides an option to copy and remove items between lists by one click. + Default value of this attribute is &quot;false&quot;, so you need a double click to copy, remove items from one list to another. </para> <para> - <emphasis role="bold">Example:</emphasis> - </para> - <programlisting role="XML"><![CDATA[... -<rich:pickList listsHeight="#{pickBean.listsHeight}" sourceListWidth="#{pickBean.sourceListWidth}" targetListWidth="#{pickBean.targetListWidth}" value="#{pickBean.listValues}"> - <f:selectItem itemValue="Bentley" itemLabel="Bentley"/> - <f:selectItem itemValue="Audi" itemLabel="Audi"/> - <f:selectItems value="#{pickBean.testList}"/> -</rich:pickList> - ...]]></programlisting> - - <para> - Lables of <property>move controls</property> can be defined with - <emphasis> - <property> &quot;copyAllControlLabel&quot;</property></emphasis>, <emphasis> - <property> &quot;copyControlLabel&quot;</property></emphasis>, + Lables of the <property>move controls</property> can be defined with + <emphasis><property> &quot;copyAllControlLabel&quot;</property></emphasis>, + <emphasis><property> &quot;copyControlLabel&quot;</property></emphasis>, <emphasis> <property> &quot;removeControlLabel&quot;</property></emphasis>, <emphasis> <property> &quot;removeAllControlLabel&quot;</property></emphasis> attributes. - </para> <para> <emphasis role="bold">Example:</emphasis> @@ -160,8 +125,8 @@ </rich:pickList> ...]]></programlisting> <para> - If you want not to display labels on the buttons of move controls you need to set - <emphasis> <property> &quot;showButtonsLabel&quot;</property></emphasis> to<property> &quot;false&quot;</property>. + If you don&apos;t want to display labels on the buttons of move controls you need to set + <emphasis> <property> &quot;showButtonsLabel&quot;</property></emphasis> to &quot;false&quot;. </para> <figure> <title>Move control buttons without labels</title> @@ -172,14 +137,42 @@ </mediaobject> </figure> - <para> - <emphasis> <property> &quot;switchByClick&quot;</property></emphasis> provides an option to copy and remove a list item by one click, - default the value of this attribute is <property> &quot;false&quot;</property> , and you need a double click to copy, remove a list item. - </para> + - <!-- ordering control set--> + <para> + The <emphasis role="bold"> + <property>&lt;rich:pickList&gt;</property></emphasis> + component provides resizing of lists by using such attributes as: + <itemizedlist> + <listitem> + <emphasis> + <property> &quot;listsHeight&quot;</property></emphasis> defines height of the lists. + + </listitem> + <listitem> + <emphasis> + <property> &quot;sourceListWidth&quot;</property></emphasis> defines width of a source list. + + </listitem> + <listitem> + <emphasis> + <property> &quot;targetListWidth&quot;</property></emphasis> defines width of a target list. + + </listitem> + </itemizedlist> + </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... +<rich:pickList listsHeight="#{pickBean.listsHeight}" sourceListWidth="#{pickBean.sourceListWidth}" targetListWidth="#{pickBean.targetListWidth}" value="#{pickBean.listValues}"> + <f:selectItem itemValue="Bentley" itemLabel="Bentley"/> + <f:selectItem itemValue="Audi" itemLabel="Audi"/> + <f:selectItems value="#{pickBean.testList}"/> +</rich:pickList> + ...]]></programlisting> <table> <title>Keyboard usage for elements selection</title>