ICEfaces ACE Components 3.3.0
Java API Documentation

org.icefaces.ace.component.menu
Class MenuBase

java.lang.Object
  extended by javax.faces.component.UIComponent
      extended by javax.faces.component.UIComponentBase
          extended by org.icefaces.ace.component.menu.AbstractMenu
              extended by org.icefaces.ace.component.menu.MenuBase
All Implemented Interfaces:
java.util.EventListener, javax.faces.component.PartialStateHolder, javax.faces.component.StateHolder, javax.faces.component.TransientStateHolder, javax.faces.event.ComponentSystemEventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListenerHolder, IMenu
Direct Known Subclasses:
Menu

public class MenuBase
extends AbstractMenu
implements IMenu

Menu is a navigation component with various customized modes like multi tiers, overlay and nested menus.

For more information, see the Menu Wiki Documentation.


Nested Class Summary
protected static class MenuBase.PropertyKeys
           
 
Field Summary
static java.lang.String COMPONENT_TYPE
           
static java.lang.String RENDERER_TYPE
           
 
Fields inherited from class javax.faces.component.UIComponent
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY
 
Constructor Summary
MenuBase()
           
 
Method Summary
 java.lang.String getAt()
          Return the value of the at property.
 java.lang.String getBackLabel()
          Return the value of the backLabel property.
 java.lang.String getEffect()
          Return the value of the effect property.
 int getEffectDuration()
          Return the value of the effectDuration property.
 java.lang.String getFamily()
           
 int getMaxHeight()
          Return the value of the maxHeight property.
 MenuModel getModel()
          Return the value of the model property.
 java.lang.String getMy()
          Return the value of the my property.
 java.lang.String getPosition()
          Return the value of the position property.
 java.lang.String getStyle()
          Return the value of the style property.
 java.lang.String getStyleClass()
          Return the value of the styleClass property.
 java.lang.String getTrigger()
          Return the value of the trigger property.
 java.lang.String getTriggerEvent()
          Return the value of the triggerEvent property.
 java.lang.String getType()
          Return the value of the type property.
 java.lang.String getWidgetVar()
          Return the value of the widgetVar property.
 int getZindex()
          Return the value of the zindex property.
 boolean isTiered()
          Return the value of the tiered property.
 void setAt(java.lang.String at)
          Set the value of the at property.
 void setBackLabel(java.lang.String backLabel)
          Set the value of the backLabel property.
 void setEffect(java.lang.String effect)
          Set the value of the effect property.
 void setEffectDuration(int effectDuration)
          Set the value of the effectDuration property.
 void setMaxHeight(int maxHeight)
          Set the value of the maxHeight property.
 void setModel(MenuModel model)
          Set the value of the model property.
 void setMy(java.lang.String my)
          Set the value of the my property.
 void setPosition(java.lang.String position)
          Set the value of the position property.
 void setStyle(java.lang.String style)
          Set the value of the style property.
 void setStyleClass(java.lang.String styleClass)
          Set the value of the styleClass property.
 void setTiered(boolean tiered)
          Set the value of the tiered property.
 void setTrigger(java.lang.String trigger)
          Set the value of the trigger property.
 void setTriggerEvent(java.lang.String triggerEvent)
          Set the value of the triggerEvent property.
 void setType(java.lang.String type)
          Set the value of the type property.
 void setWidgetVar(java.lang.String widgetVar)
          Set the value of the widgetVar property.
 void setZindex(int zindex)
          Set the value of the zindex property.
 
Methods inherited from class org.icefaces.ace.component.menu.AbstractMenu
buildMenuFromModel, isBuiltFromModel, isDynamic, markAsBuiltFromModel, processDecodes, setTransientRecursive, shouldBuildFromModel
 
Methods inherited from class javax.faces.component.UIComponentBase
addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent
 
Methods inherited from class javax.faces.component.UIComponent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE
See Also:
Constant Field Values

RENDERER_TYPE

public static final java.lang.String RENDERER_TYPE
See Also:
Constant Field Values
Constructor Detail

MenuBase

public MenuBase()
Method Detail

getFamily

public java.lang.String getFamily()
Specified by:
getFamily in class javax.faces.component.UIComponent

setAt

public void setAt(java.lang.String at)

Set the value of the at property.

Contents: When position is dynamic, this attribute specifies the corner of trigger element to align with the menu. The format is "<left|right> <top|bottom>" (examples: "left top", "right bottom").

Specified by:
setAt in interface IMenu

getAt

public java.lang.String getAt()

Return the value of the at property.

Contents: When position is dynamic, this attribute specifies the corner of trigger element to align with the menu. The format is "<left|right> <top|bottom>" (examples: "left top", "right bottom"). Default = 'left bottom'.

Specified by:
getAt in interface IMenu

setBackLabel

public void setBackLabel(java.lang.String backLabel)

Set the value of the backLabel property.

Contents: Label for the 'back' link (only applies to sliding menus).

Specified by:
setBackLabel in interface IMenu

getBackLabel

public java.lang.String getBackLabel()

Return the value of the backLabel property.

Contents: Label for the 'back' link (only applies to sliding menus). Default = 'Back'.

Specified by:
getBackLabel in interface IMenu

setEffect

public void setEffect(java.lang.String effect)

Set the value of the effect property.

Contents: Sets the effect for the menu display, default value is FADE. Possible values are "FADE", "SLIDE", "NONE". Use "NONE" to disable animation at all.

Specified by:
setEffect in interface IMenu

getEffect

public java.lang.String getEffect()

Return the value of the effect property.

Contents: Sets the effect for the menu display, default value is FADE. Possible values are "FADE", "SLIDE", "NONE". Use "NONE" to disable animation at all. Default = 'fade'.

Specified by:
getEffect in interface IMenu

setEffectDuration

public void setEffectDuration(int effectDuration)

Set the value of the effectDuration property.

Contents: Sets the effect duration in milliseconds.

Specified by:
setEffectDuration in interface IMenu

getEffectDuration

public int getEffectDuration()

Return the value of the effectDuration property.

Contents: Sets the effect duration in milliseconds. Default = '400'.

Specified by:
getEffectDuration in interface IMenu

setMaxHeight

public void setMaxHeight(int maxHeight)

Set the value of the maxHeight property.

Contents: Maximum height (in pixels) for the menu (only applies to sliding menus).

Specified by:
setMaxHeight in interface IMenu

getMaxHeight

public int getMaxHeight()

Return the value of the maxHeight property.

Contents: Maximum height (in pixels) for the menu (only applies to sliding menus). Default = '200'.

Specified by:
getMaxHeight in interface IMenu

setModel

public void setModel(MenuModel model)

Set the value of the model property.

Contents: org.icefaces.ace.model.MenuModel instance to create menus programmatically. For the menuitem and submenu components, use explicit ids, and avoid long processing in the getter method for this property, as it will be called multiple times, in every lifecycle. If using MyFaces, see wiki page for some known issues.

Specified by:
setModel in interface IMenu

getModel

public MenuModel getModel()

Return the value of the model property.

Contents: org.icefaces.ace.model.MenuModel instance to create menus programmatically. For the menuitem and submenu components, use explicit ids, and avoid long processing in the getter method for this property, as it will be called multiple times, in every lifecycle. If using MyFaces, see wiki page for some known issues.

Specified by:
getModel in interface IMenu
Specified by:
getModel in class AbstractMenu

setMy

public void setMy(java.lang.String my)

Set the value of the my property.

Contents: When position is dynamic, this attribute specifies the corner of the menu to align with the trigger element. The format is "<left|right> <top|bottom>" (examples: "left top", "right bottom").

Specified by:
setMy in interface IMenu

getMy

public java.lang.String getMy()

Return the value of the my property.

Contents: When position is dynamic, this attribute specifies the corner of the menu to align with the trigger element. The format is "<left|right> <top|bottom>" (examples: "left top", "right bottom"). Default = 'left top'.

Specified by:
getMy in interface IMenu

setPosition

public void setPosition(java.lang.String position)

Set the value of the position property.

Contents: Sets the way the menu is placed on the page. When "static", the menu is displayed in the normal flow. When set to "dynamic", the menu is only displayed near the trigger component when the triggerEvent occurs. For the latter case, it is required to specify a trigger component.

Specified by:
setPosition in interface IMenu

getPosition

public java.lang.String getPosition()

Return the value of the position property.

Contents: Sets the way the menu is placed on the page. When "static", the menu is displayed in the normal flow. When set to "dynamic", the menu is only displayed near the trigger component when the triggerEvent occurs. For the latter case, it is required to specify a trigger component. Default = 'static'.

Specified by:
getPosition in interface IMenu

setStyle

public void setStyle(java.lang.String style)

Set the value of the style property.

Contents: Style of the main container element.

Specified by:
setStyle in interface IMenu

getStyle

public java.lang.String getStyle()

Return the value of the style property.

Contents: Style of the main container element.

Specified by:
getStyle in interface IMenu

setStyleClass

public void setStyleClass(java.lang.String styleClass)

Set the value of the styleClass property.

Contents: Style class of the main container element.

Specified by:
setStyleClass in interface IMenu

getStyleClass

public java.lang.String getStyleClass()

Return the value of the styleClass property.

Contents: Style class of the main container element.

Specified by:
getStyleClass in interface IMenu

setTiered

public void setTiered(boolean tiered)

Set the value of the tiered property.

Contents: Sets the tiered mode, when set to true menu will be rendered in different tiers.

Specified by:
setTiered in interface IMenu

isTiered

public boolean isTiered()

Return the value of the tiered property.

Contents: Sets the tiered mode, when set to true menu will be rendered in different tiers.

Specified by:
isTiered in interface IMenu

setTrigger

public void setTrigger(java.lang.String trigger)

Set the value of the trigger property.

Contents: Server-side id of the component that will trigger the dynamic menu when the triggerEvent occurs. Used when position is dynamic. It is also possible to specify a client-side id of a plain HTML element on the page.

Specified by:
setTrigger in interface IMenu

getTrigger

public java.lang.String getTrigger()

Return the value of the trigger property.

Contents: Server-side id of the component that will trigger the dynamic menu when the triggerEvent occurs. Used when position is dynamic. It is also possible to specify a client-side id of a plain HTML element on the page.

Specified by:
getTrigger in interface IMenu

setTriggerEvent

public void setTriggerEvent(java.lang.String triggerEvent)

Set the value of the triggerEvent property.

Contents: Event that will trigger the menu to show, when position is dynamic. The possible values are "click", "mouseenter", "dblclick", and "rtclick".

Specified by:
setTriggerEvent in interface IMenu

getTriggerEvent

public java.lang.String getTriggerEvent()

Return the value of the triggerEvent property.

Contents: Event that will trigger the menu to show, when position is dynamic. The possible values are "click", "mouseenter", "dblclick", and "rtclick". Default = 'click'.

Specified by:
getTriggerEvent in interface IMenu

setType

public void setType(java.lang.String type)

Set the value of the type property.

Contents: Type of menu, valid values are "plain", "tiered" and "sliding".

Specified by:
setType in interface IMenu

getType

public java.lang.String getType()

Return the value of the type property.

Contents: Type of menu, valid values are "plain", "tiered" and "sliding". Default = 'plain'.

Specified by:
getType in interface IMenu

setWidgetVar

public void setWidgetVar(java.lang.String widgetVar)

Set the value of the widgetVar property.

Contents: Javascript variable name of the wrapped widget.

Specified by:
setWidgetVar in interface IMenu

getWidgetVar

public java.lang.String getWidgetVar()

Return the value of the widgetVar property.

Contents: Javascript variable name of the wrapped widget.

Specified by:
getWidgetVar in interface IMenu

setZindex

public void setZindex(int zindex)

Set the value of the zindex property.

Contents: zindex property to control overlapping with other elements.

Specified by:
setZindex in interface IMenu

getZindex

public int getZindex()

Return the value of the zindex property.

Contents: zindex property to control overlapping with other elements. Default = '1'.

Specified by:
getZindex in interface IMenu

ICEfaces ACE Components 3.3.0
Java API Documentation

Copyright 2013 ICEsoft Technologies Canada Corp., All Rights Reserved.