<section role="NotInToc" id="rich_panelMenuItem">
   <title>
				&lt;
				rich:panelMenuItem
				&gt;
				<emphasis role="since">
         <superscript> available since <emphasis role="version">3.1.0</emphasis>
         </superscript>
      </emphasis>
   </title>
   <section>
        <title>Description</title>
        <para>The <emphasis role="bold">
            <property>&lt;rich:panelMenuItem&gt;</property>
        </emphasis> component is used to define a single item inside popup list.</para>
        <figure>
            <title>
            <emphasis role="bold">
                <property>&lt;rich:panelMenuItem&gt;</property>
            </emphasis> component</title>
        <mediaobject>
            <imageobject>
                <imagedata fileref="images/panelMenuItem_init.png"/>
            </imageobject>
        </mediaobject>
        </figure>
    </section>
   <section>
        <title>Key Features</title>
        <itemizedlist>
            <listitem>
            <para>Highly customizable look-and-feel</para>
         </listitem>
            <listitem>
            <para>Different submission modes</para>
         </listitem>
            <listitem>
            <para>Optionally supports any content inside</para>
         </listitem>
            <listitem>
            <para>Custom and predefined icons supported</para>
         </listitem>
            <listitem>
            <para>Support for disabling</para>
         </listitem>
        </itemizedlist>
    </section>
   <section>
                    <title>Details of Usage</title>

                    <para>All attributes except <emphasis>
                                        <property>"label"</property>
                              </emphasis> are optional. The <emphasis>
                                        <property>"label"</property>
                              </emphasis> attribute defines text to be represented.</para>
                    <para>The <emphasis>
                                        <property>"mode"</property>
                              </emphasis> attribute could be used with three possible parameters:</para>

                    <itemizedlist>
                              <listitem>
                                        <para>
               <code>Server</code> (default)</para>
                              </listitem>
                    </itemizedlist>

                    <para>Regular form submission request is used.</para>

                    <itemizedlist>
                              <listitem>
                                        <para>
                                                  <code>Ajax</code>
                                        </para>
                              </listitem>
                    </itemizedlist>

                    <para>Ajax submission is used for switching.</para>

                    <itemizedlist>
                              <listitem>
                                        <para>
                                                  <code>None</code>
                                        </para>
                              </listitem>
                    </itemizedlist>

                    <para>
         <emphasis>
                                        <property>"Action"</property>
                              </emphasis> and <emphasis>
                                        <property>"actionListener"</property>
                              </emphasis> attributes are ignored. Items don't fire any
                              submits itself. Behavior is fully defined by the components nested
                              into items.</para>

                    <para>Here is an example for value "none":</para>

                    <para>
                              <emphasis role="bold">Example:</emphasis>
                    </para>
                    <programlisting role="XML"><![CDATA[...
<rich:panelMenu>
		...
       <rich:panelMenuItem mode="none" onclick="document.location.href='http://labs.jboss.com/jbossrichfaces/">
       			<h:outputLink value="http://labs.jboss.com/jbossrichfaces/">
               		<h:outputText value="RichFaces Home Page"></h:outputText>
            	</h:outputLink>
      	</rich:panelMenuItem>
      	...
</rich:panelMenu>
...]]></programlisting>

                    <para>There are two icon-related attributes. The <emphasis>
                                        <property>"icon"</property>
                              </emphasis> attribute defines an icon. The <emphasis>
                                        <property>"iconDisabled"</property>
                              </emphasis> attribute defines an icon for a disabled item.</para>

                    <para>Default icons are shown on the picture below:</para>

                    <figure>
                              <title>Default icons</title>

                              <mediaobject>
                                        <imageobject>
                                                  <imagedata fileref="images/panelMenuItem2.png"/>
                                        </imageobject>
                              </mediaobject>
                    </figure>

                    <para>Here is an example:</para>

                    <para>
                              <emphasis role="bold">Example:</emphasis>
                    </para>
                    <programlisting role="XML"><![CDATA[...
      <rich:panelMenu>
            ...
            <rich:panelMenuItem value="Item 1.1" icon="chevronUp" />
            ...	
      </rich:panelMenu>
...]]></programlisting>
                    <para> As the result the picture is shown below:</para>

                    <figure>
                              <title>Using an <emphasis>
                                                  <property>"icon"</property>
                                        </emphasis> attribute</title>

                              <mediaobject>
                                        <imageobject>
                                                  <imagedata fileref="images/panelMenuItem3.png"/>
                                        </imageobject>
                              </mediaobject>
                    </figure>

                    <para>It's also possible to define a path to the icon. Simple code is
                              placed below.</para>

                    <programlisting role="XML"><![CDATA[...
<rich:panelMenu>
		...
		<rich:panelMenuItem value="Item 1.1" icon="\images\img1.png" />
      	...	
</rich:panelMenu>
...]]></programlisting>
                    <para> Information about the <emphasis>
                                        <property>"process"</property>
                    </emphasis> attribute usage you can find in the 
                              <link linkend="process"> "Decide what to process" </link> guide section. </para>
          </section>
   <section>
      <title>Reference Data</title>
      <para>
         <ulink url="&tlddoc;rich/panelMenuItem.html">Table of 
							&lt;rich:panelMenuItem&gt; 
							 attributes</ulink>.
						</para>
      <table>
                    <title>Component Identification Parameters</title>

                    <tgroup cols="2">
                              <thead>
                                        <row>
                                                  <entry>Name</entry>

                                                  <entry>Value</entry>
                                        </row>
                              </thead>

                              <tbody>
                                        <row>
                                                  <entry>component-type</entry>

                                                  <entry>org.richfaces.PanelMenuItem</entry>
                                        </row>

                                        <row>
                                                  <entry>component-class</entry>

                                                  <entry>org.richfaces.component.html.HtmlPanelMenuItem</entry>
                                        </row>

                                        <row>
                                                  <entry>component-family</entry>

                                                  <entry>org.richfaces.PanelMenuItem</entry>
                                        </row>

                                        <row>
                                                  <entry>renderer-type</entry>

                                                  <entry>org.richfaces.PanelMenuItemRenderer</entry>
                                        </row>

                                        <row>
                                                  <entry>tag-class</entry>

                                                  <entry>org.richfaces.taglib.PanelMenuItemTag</entry>
                                        </row>
                              </tbody>
                    </tgroup>
          </table>
      <table id="tab_cn_pMI">
                              <title>Classes names that define the first level items</title>

                              <tgroup cols="2">
                                        <thead>
                                                  <row>
                                                  <entry>Class name</entry>

                                                  <entry>Description</entry>
                                                  </row>
                                        </thead>

                                        <tbody>
                                                  <row>
                                                  <entry>rich-pmenu-top-item</entry>

                                                  <entry>Defines styles for a top panel
                                                  menu item</entry>
                                                  </row>

                                                  <row>
                                                  <entry>rich-pmenu-top-item-icon</entry>

                                                  <entry>Defines styles for a top panel
                                                  menu item icon</entry>
                                                  </row>

                                                  <row>
                                                  <entry>rich-pmenu-top-item-label</entry>

                                                  <entry>Defines styles for a top panel
                                                  menu item label</entry>
                                                  </row>

                                        </tbody>
                              </tgroup>
                    </table>
      <table>
                              <title>Classes names that define the second and lower level items</title>

                              <tgroup cols="2">
                                        <thead>
                                                  <row>
                                                  <entry>Class name</entry>

                                                  <entry>Description</entry>
                                                  </row>
                                        </thead>

                                        <tbody>
                                                  <row>
                                                  <entry>rich-pmenu-item</entry>

                                                  <entry>Defines styles for a panel menu
                                                  item</entry>
                                                  </row>

                                                  <row>
                                                  <entry>rich-pmenu-item-icon</entry>

                                                  <entry>Defines styles for a panel menu
                                                  item icon</entry>
                                                  </row>

                                                  <row>
                                                  <entry>rich-pmenu-item-label</entry>

                                                  <entry>Defines styles for a panel menu
                                                  item label</entry>
                                                  </row>

                                        </tbody>
                              </tgroup>
                    </table>
      <table>
                              <title>Classes names that define items state</title>

                              <tgroup cols="2">
                                        <thead>
                                                  <row>
                                                  <entry>Class name</entry>

                                                  <entry>Description</entry>
                                                  </row>
                                        </thead>

                                        <tbody>
                                                  <row>
                                                  <entry>rich-pmenu-item-selected</entry>

                                                  <entry>Defines styles for a panel menu
                                                  selected item</entry>
                                                  </row>

                                                  <row>
                                                  <entry>rich-pmenu-disabled-element</entry>

                                                  <entry>Defines styles for a disabled
                                                  panel menu item</entry>
                                                  </row>

                                                  <row>
                                                  <entry>rich-pmenu-hovered-element</entry>

                                                  <entry>Defines styles for a hovered
                                                  panel menu item</entry>
                                                  </row>
                                        </tbody>
                              </tgroup>
                    </table>
							You can find all necessary information about style classes redefinition in 
						<link linkend="customstyles">Definition of Custom Style Classes</link> 
							section.
						</section>
   <section>
                    <title>Relevant Resources Links</title>
                    <para> Some additional information about usage of component can be found on this <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/panelMenu.jsf?c=panelMenu&amp;tab=usage">LiveDemo page</ulink>. </para>
          </section>
</section>