com.haulmont.cuba.web.gui.components.mainwindow

Class WebSideMenu

java.lang.Object

com.haulmont.bali.events.EventRouter

com.haulmont.cuba.web.gui.components.WebAbstractComponent<com.haulmont.cuba.web.toolkit.ui.CubaSideMenu>

com.haulmont.cuba.web.gui.components.mainwindow.WebSideMenu

All Implemented Interfaces:

Component, Component.BelongToFrame, Component.Focusable, Component.HasCaption, Component.HasIcon, Component.HasXmlDescriptor, Component.Wrapper, SideMenu

public class WebSideMenu
extends WebAbstractComponent<com.haulmont.cuba.web.toolkit.ui.CubaSideMenu>
implements SideMenu

Nested Class Summary

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.mainwindow.SideMenu

SideMenu.MenuItem

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.Component

Component.ActionOwner, Component.ActionsHolder, Component.Alignment, Component.BelongToFrame, Component.Buffered, Component.ChildEditableController, Component.Collapsable, Component.Container, Component.Disposable, Component.Editable, Component.EditableChangeEvent, Component.EditableChangeListener, Component.EditableChangeNotifier, Component.ExpandedStateChangeEvent, Component.ExpandedStateChangeListener, Component.Focusable, Component.HasBorder, Component.HasButtonsPanel, Component.HasCaption, Component.HasFormatter, Component.HasIcon, Component.HasInputPrompt, Component.HasNamedComponents, Component.HasPresentations, Component.HasRowsCount, Component.HasSettings, Component.HasValue, Component.HasXmlDescriptor, Component.LayoutClickEvent, Component.LayoutClickListener, Component.LayoutClickNotifier, Component.Margin, Component.MouseEventDetails, Component.OrderedContainer, Component.OuterMargin, Component.SecuredActionsHolder, Component.ShortcutAction, Component.ShortcutNotifier, Component.ShortcutTriggeredEvent, Component.Spacing, Component.UiPermissionAware, Component.Validatable, Component.ValueChangeEvent, Component.ValueChangeListener, Component.Wrapper

Field Summary

Fields inherited from class com.haulmont.cuba.web.gui.components.WebAbstractComponent

ICON_STYLE, UNIT_SYMBOLS

Fields inherited from interface com.haulmont.cuba.gui.components.mainwindow.SideMenu

NAME

Fields inherited from interface com.haulmont.cuba.gui.components.Component

AUTO_SIZE, AUTO_SIZE_PX, UNITS_PERCENTAGE, UNITS_PIXELS

Constructor Summary

Constructors

Constructor and Description
WebSideMenu()

Method Summary

Modifier and Type	Method and Description
void	addMenuItem(SideMenu.MenuItem menuItem) Add menu item to the end of root items list.
void	addMenuItem(SideMenu.MenuItem menuItem, int index) Add menu item to specified position in the root items list.
SideMenu.MenuItem	createMenuItem(java.lang.String id) Create new menu item.
SideMenu.MenuItem	createMenuItem(java.lang.String id, java.lang.String caption) Create new menu item.
SideMenu.MenuItem	createMenuItem(java.lang.String id, java.lang.String caption, java.lang.String icon, java.util.function.Consumer<SideMenu.MenuItem> command) Create new menu item.
SideMenu.MenuItem	getMenuItem(java.lang.String id)
SideMenu.MenuItem	getMenuItemNN(java.lang.String id)
java.util.List<SideMenu.MenuItem>	getMenuItems()
SideMenu.MenuItem	getSelectedItem()
Component	getSidePanel()
Button	getSidePanelToggleButton()
int	getTabIndex() Gets the tabulator index of the HasTabIndex component.
boolean	hasMenuItems()
boolean	isSelectOnClick()
boolean	isShowSingleExpandedMenu()
void	loadMenuConfig() Load menu structure from MenuConfig
void	removeAllMenuItems() Remove all the root menu items.
void	removeMenuItem(int index) Remove menu item from the root items list by index.
void	removeMenuItem(SideMenu.MenuItem menuItem) Remove menu item from the root items list.
void	setSelectedItem(SideMenu.MenuItem selectedItem) Set selected item.
void	setSelectOnClick(boolean selectOnClick) Enable or disable automatic selected styling by click.
void	setShowSingleExpandedMenu(boolean singleExpandedMenu) Set true for collapsing a submenu when another parent menu item is clicked
void	setSidePanel(Component sidePanel) Bind side panel for show/hide action.
void	setSidePanelToggleButton(Button toggleButton) Bind show/hide side panel action to button.
void	setTabIndex(int tabIndex) Sets the tabulator index of the Focusable component.

Methods inherited from class com.haulmont.cuba.web.gui.components.WebAbstractComponent

addStyleName, assignAutoDebugId, getAlignment, getCaption, getComponent, getComponentEnabledFlag, getComponentVisibleFlag, getComposition, getDebugId, getDescription, getFrame, getHeight, getHeightUnits, getIcon, getId, getParent, getStyleName, getWidth, getWidthUnits, getXmlDescriptor, isEnabled, isEnabledItself, isResponsive, isVisible, isVisibleItself, removeStyleName, requestFocus, setAlignment, setCaption, setDebugId, setDescription, setEnabled, setFrame, setHeight, setIcon, setId, setParent, setResponsive, setStyleName, setVisible, setWidth, setXmlDescriptor, unwrap, unwrapComposition

Methods inherited from class com.haulmont.bali.events.EventRouter

addListener, addListener, fireEvent, hasListeners, removeListener, removeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.haulmont.cuba.gui.components.Component.BelongToFrame

getFrame, setFrame

Methods inherited from interface com.haulmont.cuba.gui.components.Component.Focusable

isFocusable, setFocusable

Methods inherited from interface com.haulmont.cuba.gui.components.Component

addStyleName, getAlignment, getDebugId, getHeight, getHeightUnits, getId, getParent, getStyleName, getWidth, getWidthUnits, isEnabled, isEnabledItself, isResponsive, isVisible, isVisibleItself, removeStyleName, requestFocus, setAlignment, setDebugId, setEnabled, setHeight, setHeightAuto, setHeightFull, setId, setParent, setResponsive, setSizeAuto, setSizeFull, setStyleName, setVisible, setWidth, setWidthAuto, setWidthFull, unwrap, unwrapComposition

Constructor Detail

WebSideMenu

public WebSideMenu()

Method Detail

loadMenuConfig

public void loadMenuConfig()

Description copied from interface: SideMenu

Load menu structure from MenuConfig

Specified by:

loadMenuConfig in interface SideMenu

setSidePanelToggleButton

public void setSidePanelToggleButton(Button toggleButton)

Description copied from interface: SideMenu

Bind show/hide side panel action to button.

Specified by:

setSidePanelToggleButton in interface SideMenu

Parameters:

toggleButton - button that should trigger show/hide of side panel

getSidePanelToggleButton

public Button getSidePanelToggleButton()

Specified by:

getSidePanelToggleButton in interface SideMenu

Returns:

side panel toggle button

setSidePanel

public void setSidePanel(Component sidePanel)

Description copied from interface: SideMenu

Bind side panel for show/hide action.

Specified by:

setSidePanel in interface SideMenu

Parameters:

sidePanel - side panel

getSidePanel

public Component getSidePanel()

Specified by:

getSidePanel in interface SideMenu

Returns:

side panel

isSelectOnClick

public boolean isSelectOnClick()

Specified by:

isSelectOnClick in interface SideMenu

Returns:

true if an item becomes selected by click

setSelectOnClick

public void setSelectOnClick(boolean selectOnClick)

Description copied from interface: SideMenu

Enable or disable automatic selected styling by click.

Specified by:

setSelectOnClick in interface SideMenu

Parameters:

selectOnClick - enable/disable option

getSelectedItem

public SideMenu.MenuItem getSelectedItem()

Specified by:

getSelectedItem in interface SideMenu

Returns:

currently selected item

setSelectedItem

public void setSelectedItem(SideMenu.MenuItem selectedItem)

Description copied from interface: SideMenu

Set selected item.

Specified by:

setSelectedItem in interface SideMenu

Parameters:

selectedItem - new selected item

createMenuItem

public SideMenu.MenuItem createMenuItem(java.lang.String id)

Description copied from interface: SideMenu

Create new menu item. Does not add item to menu. Id must be unique for whole menu.

Specified by:

createMenuItem in interface SideMenu

Parameters:

id - item id

Returns:

menu item instance

createMenuItem

public SideMenu.MenuItem createMenuItem(java.lang.String id,
                                        java.lang.String caption)

Description copied from interface: SideMenu

Create new menu item. Does not add item to menu. Id must be unique for whole menu.

Specified by:

createMenuItem in interface SideMenu

Parameters:

id - item id

caption - item caption

Returns:

menu item instance

createMenuItem

public SideMenu.MenuItem createMenuItem(java.lang.String id,
                                        java.lang.String caption,
                                        @Nullable
                                        java.lang.String icon,
                                        @Nullable
                                        java.util.function.Consumer<SideMenu.MenuItem> command)

Description copied from interface: SideMenu

Create new menu item. Does not add item to menu. Id must be unique for whole menu.

Specified by:

createMenuItem in interface SideMenu

Parameters:

id - item id

caption - item caption

icon - icon

command - command

Returns:

menu item instance

addMenuItem

public void addMenuItem(SideMenu.MenuItem menuItem)

Description copied from interface: SideMenu

Add menu item to the end of root items list.

Specified by:

addMenuItem in interface SideMenu

Parameters:

menuItem - menu item

addMenuItem

public void addMenuItem(SideMenu.MenuItem menuItem,
                        int index)

Description copied from interface: SideMenu

Add menu item to specified position in the root items list.

Specified by:

addMenuItem in interface SideMenu

Parameters:

menuItem - menu item

index - target index

removeMenuItem

public void removeMenuItem(SideMenu.MenuItem menuItem)

Description copied from interface: SideMenu

Remove menu item from the root items list.

Specified by:

removeMenuItem in interface SideMenu

Parameters:

menuItem - menu item

removeAllMenuItems

public void removeAllMenuItems()

Description copied from interface: SideMenu

Remove all the root menu items.

Specified by:

removeAllMenuItems in interface SideMenu

removeMenuItem

public void removeMenuItem(int index)

Description copied from interface: SideMenu

Remove menu item from the root items list by index.

Specified by:

removeMenuItem in interface SideMenu

Parameters:

index - index

getMenuItem

public SideMenu.MenuItem getMenuItem(java.lang.String id)

Specified by:

getMenuItem in interface SideMenu

Parameters:

id - item id

Returns:

item from the menu tree by its id

getMenuItemNN

public SideMenu.MenuItem getMenuItemNN(java.lang.String id)

Specified by:

getMenuItemNN in interface SideMenu

Parameters:

id - item id

Returns:

item from the menu tree by its id

getMenuItems

public java.util.List<SideMenu.MenuItem> getMenuItems()

Specified by:

getMenuItems in interface SideMenu

Returns:

root menu items

hasMenuItems

public boolean hasMenuItems()

Specified by:

hasMenuItems in interface SideMenu

Returns:

true if the menu has items

getTabIndex

public int getTabIndex()

Description copied from interface: Component.Focusable

Gets the tabulator index of the HasTabIndex component.

Specified by:

getTabIndex in interface Component.Focusable

Returns:

tab index set for the HasTabIndex component

setTabIndex

public void setTabIndex(int tabIndex)

Description copied from interface: Component.Focusable

Sets the tabulator index of the Focusable component. The tab index property is used to specify the order in which the fields are focused when the user presses the Tab key. Components with a defined tab index are focused sequentially first, and then the components with no tab index.

Specified by:

setTabIndex in interface Component.Focusable

Parameters:

tabIndex - tab index

setShowSingleExpandedMenu

public void setShowSingleExpandedMenu(boolean singleExpandedMenu)

Description copied from interface: SideMenu

Set true for collapsing a submenu when another parent menu item is clicked

Specified by:

setShowSingleExpandedMenu in interface SideMenu

isShowSingleExpandedMenu

public boolean isShowSingleExpandedMenu()

Specified by:

isShowSingleExpandedMenu in interface SideMenu

Returns:

true if a submenu is collapsing when another parent menu item is clicked