com.infragistics.faces.menu.component.html
Class HtmlMenuItem

java.lang.Object
  javax.faces.component.UIComponent
      javax.faces.component.UIComponentBase
          com.infragistics.faces.shared.component.DataRepeater
              com.infragistics.faces.menu.component.MenuItem
                  com.infragistics.faces.menu.component.html.HtmlMenuItem

All Implemented Interfaces:

javax.faces.component.ActionSource, javax.faces.component.NamingContainer, javax.faces.component.StateHolder, javax.faces.component.ValueHolder

public class HtmlMenuItem

extends MenuItem

Represents an individual menu item that can contain nested menu items.

Bound and unbound mode
Just like menus, menu items supports bound as well as unbound mode. In unbound mode, menu items are created declaratively (in a JSP page) or added programmatically.
In bound mode (whenever the dataSource property points to a valid data model of a backing bean) menu items are automatically created, one node for each row of the data model.

Look and Feel
The look and feel of each menu item can be individually defined.

An icon can also be displayed next to a menu item by calling MenuItem.setIconUrl(String) and MenuItem.setHoverIconUrl(String).
Emits ActionEvent whenever clicked-on

Field Summary

static java.lang.String	COMPONENT_FAMILY
static java.lang.String	COMPONENT_TYPE
static java.lang.String	RENDERER_TYPE

Fields inherited from class com.infragistics.faces.shared.component.DataRepeater

DATA_ROW

Fields inherited from interface javax.faces.component.NamingContainer

SEPARATOR_CHAR

Constructor Summary

HtmlMenuItem()

Method Summary

java.lang.String	getFamily()
java.lang.String	getHoverStyleClass() Returns the name of the css class applied to the component when the mouse is over it
java.lang.String	getHref() Returns the href (url) to navigate-to whenever the user clicks on the command If both action and href are specified, href is used
java.lang.String	getStyle() Returns the default Style applied to the component
java.lang.String	getStyleClass() Returns the name of the css class applied to the component
java.lang.String	getTarget() Returns the target frame and/or window that will receive the result of this action
void	restoreState(javax.faces.context.FacesContext context, java.lang.Object state)
java.lang.Object	saveState(javax.faces.context.FacesContext context)
void	setHoverStyleClass(java.lang.String cssClass) Sets the name of the css class applied to the component when the mouse cursor is over it
void	setHref(java.lang.String href) Sets the href (url) to navigate-to whenever the node is clicked-on
void	setStyle(java.lang.String style) Sets the default style applied to the component
void	setStyleClass(java.lang.String cssClass) Sets the name of the css class applied to the component
void	setTarget(java.lang.String target) Sets the target frame and/or window that will receive the result of this action

Methods inherited from class com.infragistics.faces.menu.component.MenuItem

addActionListener, broadcast, getAction, getActionListener, getActionListeners, getConverter, getHoverIconUrl, getIconUrl, getLocalValue, getMenu, getShortcut, getSiblings, getTooltip, getValue, isDisabled, isImmediate, isRoot, queueEvent, removeActionListener, setAction, setActionListener, setConverter, setDisabled, setHoverIconUrl, setIconUrl, setImmediate, setShortcut, setTooltip, setValue

Methods inherited from class com.infragistics.faces.shared.component.DataRepeater

dataBind, encodeBegin, encodeEnd, export, getDataKeyName, getDataKeyValue, getDataSource, getTemplateItems, popDataRow, processUpdates, processValidators, pushDataRow, setDataKeyName, setDataSource, setValueBinding

Methods inherited from class javax.faces.component.UIComponentBase

decode, encodeChildren, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacet, getFacets, getFacetsAndChildren, getId, getParent, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, processDecodes, processRestoreState, processSaveState, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COMPONENT_FAMILY

public static java.lang.String COMPONENT_FAMILY

COMPONENT_TYPE

public static java.lang.String COMPONENT_TYPE

RENDERER_TYPE

public static java.lang.String RENDERER_TYPE

Constructor Detail

HtmlMenuItem

public HtmlMenuItem()

Method Detail

getFamily

public java.lang.String getFamily()

Overrides:

getFamily in class MenuItem

getHoverStyleClass

public java.lang.String getHoverStyleClass()

Returns the name of the css class applied to the component when the mouse is over it

Returns:

the name of a css class

getHref

public java.lang.String getHref()

Returns the href (url) to navigate-to whenever the user clicks on the command If both action and href are specified, href is used

Returns:

the href property

getStyle

public java.lang.String getStyle()

Returns the default Style applied to the component

Returns:

the css style

getStyleClass

public java.lang.String getStyleClass()

Returns the name of the css class applied to the component

Returns:

the name of a css class

getTarget

public java.lang.String getTarget()

Returns the target frame and/or window that will receive the result of this action

Returns:

the target property

setHoverStyleClass

public void setHoverStyleClass(java.lang.String cssClass)

Sets the name of the css class applied to the component when the mouse cursor is over it

Parameters:

cssClass -

setHref

public void setHref(java.lang.String href)

Sets the href (url) to navigate-to whenever the node is clicked-on

Parameters:

href -

setStyle

public void setStyle(java.lang.String style)

Sets the default style applied to the component

Parameters:

style -

setStyleClass

public void setStyleClass(java.lang.String cssClass)

Sets the name of the css class applied to the component

Parameters:

cssClass -

setTarget

public void setTarget(java.lang.String target)

Sets the target frame and/or window that will receive the result of this action

Parameters:

target -

restoreState

public void restoreState(javax.faces.context.FacesContext context,
                         java.lang.Object state)

Specified by:

restoreState in interface javax.faces.component.StateHolder

Overrides:

restoreState in class MenuItem

saveState

public java.lang.Object saveState(javax.faces.context.FacesContext context)

Specified by:

saveState in interface javax.faces.component.StateHolder

Overrides:

saveState in class MenuItem