# rich

## Tag dropDownMenu

- Description:
    The <rich:dropDownMenu> component is used for creating a drop-down, hierarchical menu. It can be used with the <rich:toolbar> component to create menus in an application's toolbar.

- Component Information
  Info | Value
  --- | ---
  Component Type | `org.richfaces.DropDownMenu`
  Handler Class | None
  Renderer Type | `org.richfaces.DropDownMenuRenderer`
  Description | The <rich:dropDownMenu> component is used for creating a drop-down, hierarchical menu. It can be used with the <rich:toolbar> component to create menus in an application's toolbar.

- Attributes
  Name | Required | Type | Description
  --- | --- | --- | ---
  `binding` | `false` | `javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`) | The value binding expression used to wire up this component to a component property of a JavaBean class
  `dir` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
  `direction` | `false` | `javax.el.ValueExpression` (must evaluate to `org.richfaces.component.Positioning`) | Set the direction of the popup. Possible values are: auto, topLeft, topRight, bottomLeft, bottomRight, autoLeft, autoRight, topAuto, bottomAuto Default value is auto
  `disabled` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating that this element must never receive focus or be included in a subsequent submit. Default value - "false"
  `hideDelay` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Delay (in ms) between losing focus and menu closing Default value is "300"
  `horizontalOffset` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Sets the horizontal offset between popup element and the conjunction point Default value is 0
  `id` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
  `jointPoint` | `false` | `javax.el.ValueExpression` (must evaluate to `org.richfaces.component.Positioning`) | Set the corner attachment point with which the popup should be connected. Possible values are: auto, topLeft, topRight, bottomLeft, bottomRight, autoLeft, autoRight, topAuto, bottomAuto Default value is auto
  `label` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The text label for the menu item. Alternatively, use the label facet to define content for the label
  `lang` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Code describing the language used in the generated markup for this component.
  `mode` | `false` | `javax.el.ValueExpression` (must evaluate to `org.richfaces.component.Mode`) | Sets the submission mode for all menu items of the menu except those where this attribute redefined. Possible value are 'ajax','client' and 'server' Default value is 'server'
  `onclick` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is clicked over this element.
  `ondblclick` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is double clicked over this element.
  `ongrouphide` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The client-side script method to be called when a child menuGroup is hidden
  `ongroupshow` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The client-side script method to be called when a child menuGroup is expanded
  `onhide` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The client-side code executed after the popup disappears.
  `onitemclick` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The client-side script method to be called when a menu item is clicked
  `onkeydown` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is pressed down over this element.
  `onkeypress` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is pressed and released over this element.
  `onkeyup` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is released over this element.
  `onmousedown` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is pressed down over this element.
  `onmousemove` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved within this element.
  `onmouseout` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved away from this element.
  `onmouseover` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved onto this element.
  `onmouseup` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is released over this element.
  `onshow` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The client-side code executed after the popup is shown.
  `popupWidth` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Sets minimum width for all lists that will appear.
  `rendered` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.
  `showDelay` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Delay (in ms) between observing the showEvent and menu opening Default value is "50"
  `showEvent` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines an event on the parent element to display the menu Default value is 'contextmenu'
  `style` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) to be applied when this component is rendered.
  `styleClass` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
  `title` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Advisory title information about markup elements generated for this component.
  `verticalOffset` | `false` | `javax.el.ValueExpression` (must evaluate to `int`) | Sets the vertical offset between popup element and the conjunction point Default value is 0

Output generated by Vdldoc View Declaration Language Documentation Generator.