From richfaces-svn-commits at lists.jboss.org Thu Jan 13 21:24:52 2011 Content-Type: multipart/mixed; boundary="===============7120711488332981820==" 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: r21014 - modules/docs/trunk/Component_Reference/src/main/docbook/en-US. Date: Thu, 13 Jan 2011 21:24:52 -0500 Message-ID: <201101140224.p0E2Oqve004721@svn01.web.mwc.hst.phx2.redhat.com> --===============7120711488332981820== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: SeanRogers Date: 2011-01-13 21:24:51 -0500 (Thu, 13 Jan 2011) New Revision: 21014 Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Compo= nent_Reference-Menus_and_toolbars.xml Log: Revised dropdownmenu based on review RFPL-973 Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/cha= p-Component_Reference-Menus_and_toolbars.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 --- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Comp= onent_Reference-Menus_and_toolbars.xml 2011-01-14 01:03:54 UTC (rev 21013) +++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Comp= onent_Reference-Menus_and_toolbars.xml 2011-01-14 02:24:51 UTC (rev 21014) @@ -48,10 +48,10 @@
Basic usage - The <rich:dropDownMenu> component only requir= es the value attribute for basic usage. Use the value attribute to define the text label that appears as the tit= le of the menu. Clicking on the title drops the menu down. + The <rich:dropDownMenu> component only requir= es the label attribute for basic usage. Use the label attribute to define the text label that appears as the tit= le of the menu. Clicking on the title drops the menu down. - Alternatively, use the label facet to define the me= nu title. If the label facet is used, the value= attribute is not necessary. + Alternatively, use the label facet to define the me= nu title. If the label facet is used, the label= attribute is not necessary.
= @@ -62,23 +62,86 @@ = - - =
Expanding and collapsing the menu - By default, the menu drops down when the title is clicked. To drop dow= n with a different event, use the event attribute to def= ine the event instead. + By default, the menu drops down when the title is clicked. To drop dow= n with a different event, use the eventShow attribute to= define the event instead. + Menus can be navigated using the keyboard. Additionally, menus can be = navigated programmatically using the JavaScript API. The= JavaScript API allows the following methods: + + + + show() + + + The show() method shows the menu. + + + + + hide() + + + The hide() method hides the menu. + + + + + activateItem(menuItemId) + + + The activateItem(menuItemId) activates the= menu item with the menuItemId identifier. + + + + + Use the mode attribute to determine how the menu re= quests are submitted: @@ -94,7 +157,7 @@ - client causes the action and <= varname>actionListener items to be ignored, and the behavior is f= ully defined by the nested components instead of responses from submissions. + client causes the action and <= varname>actionListener items to be ignored, and the behavior is f= ully defined by the nested components or custom JavaScript instead of respo= nses from submissions. @@ -142,13 +205,13 @@
<sgmltag><rich:menuItem></sgmltag> - The <rich:menuItem> component represents a si= ngle item in a menu control. + The <rich:menuItem> component represents a si= ngle item in a menu control. The <rich:menuItem> c= omponent can be also be used as a seperate component without a parent menu = component, such as on a toolbar. =
Basic usage - The <rich:menuItem> component requires the <= varname>value attribute for basic usage. The value attribute is the text label for the menu item. + The <rich:menuItem> component requires the <= varname>label attribute for basic usage. The label attribute is the text label for the menu item.
= @@ -247,8 +310,12 @@ Alternatively, define facets with the names icon a= nd iconDisabled to set the icons. If facets are defined,= the icon and iconDisabled attributes= are ignored. + + The <rich:menuGroup> component can be positi= oned using the jointPoint and direction attributes, the same as the parent menu control. For details on the jointPoint and direction attributes, refe= r to . +
= + =
Reference data --===============7120711488332981820==--