Author: artdaw Date: 2008-03-24 13:38:11 -0400 (Mon, 24 Mar 2008) New Revision: 7135 Modified: trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml Log: http://jira.jboss.com/jira/browse/RF-1216 - Some classes, event attribute 'onselect' were added Modified: trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml 2008-03-24 17:37:33 UTC (rev 7134) +++ trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml 2008-03-24 17:38:11 UTC (rev 7135) @@ -33,10 +33,10 @@ <entry>renderer-type</entry> <entry>org.richfaces.renderkit.ComboBoxRenderer</entry> </row> - <!--row> + <row> <entry>tag-class</entry> - <entry></entry> - </row--> + <entry>org.richfaces.taglib.ComboBoxTag</entry> + </row> </tbody> </tgroup> </table> @@ -91,7 +91,7 @@ <itemizedlist> <listitem> Using the <emphasis role="bold"><property>&lt;f:selectItem /&gt;</property></emphasis> or <emphasis role="bold"> - <property>&lt;f:selectItems /&gt;</property></emphasis> components + <property>&lt;f:selectItems /&gt;</property></emphasis> facets </listitem> </itemizedlist> <para> @@ -189,7 +189,7 @@ <emphasis role="bold">Example:</emphasis> </para> <programlisting role="XML"><![CDATA[... -<rich:comboBox value="#{bean.state}" suggestionValues="#{bean.suggestions}" disabled="true" /> +<rich:comboBox value="#{bean.state}" suggestionValues="#{bean.suggestions}" defaultLabel="Select a city..." disabled="true" /> ...]]></programlisting> <para>This is a result:</para> <figure> @@ -203,12 +203,25 @@ </mediaobject> </figure> - <para> + <!--para> The <emphasis role="bold"><property>&lt;rich:comboBox&gt;</property></emphasis> component provides the possibility to use specific event attribute <emphasis><property> &quot;onlistcall&quot;</property></emphasis> which is fired before the list opening. - </para> + </para--> <para> + The <emphasis role="bold"><property>&lt;rich:comboBox&gt;</property></emphasis> component provides to use + specific event attributes: + <itemizedlist> + <listitem> + <emphasis><property> &quot;onlistcall&quot;</property></emphasis>which is fired before the list opening and gives you a possibility to cancel list popup/update + </listitem> + <listitem> + <emphasis><property> &quot;onselect&quot;</property></emphasis>which gives you a possibility to send AJAX request when item is selected + </listitem> + </itemizedlist> + </para> + + <para> The <emphasis role="bold"><property>&lt;rich:comboBox&gt;</property></emphasis> component allows to use sizes attributes: <itemizedlist> <listitem> @@ -221,18 +234,7 @@ </itemizedlist> </para> - <!--para> - The <emphasis role="bold"><property>&lt;rich:comboBox&gt;</property></emphasis> component provides to use - specific event attributes: - <itemizedlist> - <listitem> - <emphasis><property> &quot;onlistcall&quot;</property></emphasis> is fired before the list opening - </listitem> - <listitem> - <emphasis><property> &quot;onchange&quot;</property></emphasis> is fired both with onselected and after the input value changed - </listitem> - </itemizedlist> - </para--> + @@ -646,16 +648,29 @@ </row> </thead> <tbody> - + <row> + <entry>rich-combobox-shell</entry> + <entry>Defines styles for a wrapper &lt;div&gt; element of a list</entry> + </row> + <row> + <entry>rich-combobox-list-position</entry> + <entry>Defines position of a list</entry> + </row> + <row> <entry>rich-combobox-list-decoration</entry> <entry>Defines styles for a list</entry> </row> + <row> + <entry>rich-combobox-list-scroll</entry> + <entry>Defines styles for a list scrolling</entry> + </row> </tbody> </tgroup> </table> + <table> - <title>Classes names that define button representation</title> + <title>Classes names that define font representation</title> <tgroup cols="2"> <thead> <row> @@ -665,44 +680,51 @@ </thead> <tbody> <row> - <entry>rich-combobox-button</entry> - <entry>Defines styles for a button</entry> + <entry>rich-combobox-font</entry> + <entry>Defines styles for a font</entry> </row> <row> - <entry>rich-combobox-button-inactive</entry> - <entry>Defines styles for an inactive button</entry> + <entry>rich-combobox-font-inactive</entry> + <entry>Defines styles for an inactive font</entry> </row> <row> - <entry>rich-combobox-button-disabled</entry> - <entry>Defines styles for a button in disabled state</entry> + <entry>rich-combobox-font-disabled</entry> + <entry>Defines styles for a disabled font</entry> </row> + </tbody> + </tgroup> + </table> + + <table> + <title>Classes names that define input field representation</title> + <tgroup cols="2"> + <thead> <row> - <entry>rich-combobox-button-hovered</entry> - <entry>Defines styles for a hovered button</entry> + <entry>Class name</entry> + <entry>Description</entry> </row> + </thead> + <tbody> + <row> - <entry>rich-combobox-button-background</entry> - <entry>Defines styles for a button background</entry> + <entry>rich-combobox-input</entry> + <entry>Defines styles for an input field</entry> </row> <row> - <entry>rich-combobox-button-background-disabled</entry> - <entry>Defines styles for a disabled button background</entry> + <entry>rich-combobox-input-disabled</entry> + <entry>Defines styles for an input field in disabled state</entry> </row> <row> - <entry>rich-combobox-button-background-inactive</entry> - <entry>Defines styles for an inactive button background</entry> + <entry>rich-combobox-input-inactive</entry> + <entry>Defines styles for an inactive input field</entry> </row> - <row> - <entry>rich-combobox-button-pressed-background</entry> - <entry>Defines styles for a pressed button background</entry> - </row> - + </tbody> </tgroup> </table> - + <table> - <title>Classes names that define font representation</title> + <title>Classes names that define item representation</title> <tgroup cols="2"> <thead> <row> @@ -712,22 +734,19 @@ </thead> <tbody> <row> - <entry>rich-combobox-font</entry> - <entry>Defines styles for a font</entry> + <entry>rich-combobox-item</entry> + <entry>Defines styles for an item</entry> </row> <row> - <entry>rich-combobox-font-inactive</entry> - <entry>Defines styles for an inactive font</entry> + <entry>rich-combobox-item-selected</entry> + <entry>Defines styles for a selected item</entry> </row> - <row> - <entry>rich-combobox-font-disabled</entry> - <entry>Defines styles for a disabled font</entry> - </row> - </tbody> + </tbody> </tgroup> </table> + <table> - <title>Classes names that define input field representation</title> + <title>Classes names that define button representation</title> <tgroup cols="2"> <thead> <row> @@ -736,25 +755,52 @@ </row> </thead> <tbody> - <row> - <entry>rich-combobox-input</entry> - <entry>Defines styles for an input text</entry> + <entry>rich-combobox-button</entry> + <entry>Defines styles for a button</entry> </row> <row> - <entry>rich-combobox-input-disabled</entry> - <entry>Defines styles for an input text in disabled state</entry> + <entry>rich-combobox-button-inactive</entry> + <entry>Defines styles for an inactive button</entry> </row> <row> - <entry>rich-combobox-input-inactive</entry> - <entry>Defines styles for an inactive input text</entry> + <entry>rich-combobox-button-disabled</entry> + <entry>Defines styles for a button in disabled state</entry> </row> - + <row> + <entry>rich-combobox-button-hovered</entry> + <entry>Defines styles for a hovered button</entry> + </row> + <row> + <entry>rich-combobox-button-background</entry> + <entry>Defines styles for a button background</entry> + </row> + <row> + <entry>rich-combobox-button-background-disabled</entry> + <entry>Defines styles for a disabled button background</entry> + </row> + <row> + <entry>rich-combobox-button-background-inactive</entry> + <entry>Defines styles for an inactive button background</entry> + </row> + <row> + <entry>rich-combobox-button-pressed-background</entry> + <entry>Defines styles for a pressed button background</entry> + </row> + <row> + <entry>rich-combobox-button-icon</entry> + <entry>Defines styles for a button icon</entry> + </row> + <row> + <entry>rich-combobox-button-icon-inactive</entry> + <entry>Defines styles for an inactive button icon</entry> + </row> </tbody> </tgroup> </table> + <table> - <title>Classes names that define item representation</title> + <title>Classes names that define shadow representation</title> <tgroup cols="2"> <thead> <row> @@ -764,14 +810,26 @@ </thead> <tbody> <row> - <entry>rich-combobox-item</entry> - <entry>Defines styles for an item</entry> + <entry>rich-combobox-shadow</entry> + <entry>Defines styles for a wrapper &lt;div&gt; element of a shadow</entry> </row> <row> - <entry>rich-combobox-item-selected</entry> - <entry>Defines styles for a selected item</entry> + <entry>rich-combobox-shadow-tl</entry> + <entry>Defines styles for a top-left element of a shadow</entry> </row> - </tbody> + <row> + <entry>rich-combobox-shadow-tr</entry> + <entry>Defines styles for a top-right element of a shadow</entry> + </row> + <row> + <entry>rich-combobox-shadow-bl</entry> + <entry>Defines styles for a bottom-left element of a shadow</entry> + </row> + <row> + <entry>rich-combobox-shadow-br</entry> + <entry>Defines styles for a bottom-right element of a shadow</entry> + </row> + </tbody> </tgroup> </table>