com.foreach.across.modules.bootstrapui.components.builder

Class NavComponentBuilder<SELF extends NavComponentBuilder<SELF>>

java.lang.Object

com.foreach.across.modules.web.ui.ViewElementBuilderSupport<T,SELF>

com.foreach.across.modules.web.ui.elements.builder.ContainerViewElementBuilderSupport<T,SELF>

com.foreach.across.modules.web.ui.elements.builder.AbstractNodeViewElementBuilder<T,SELF>

com.foreach.across.modules.bootstrapui.elements.builder.AbstractHtmlSupportingNodeViewElementBuilder<T,SELF>

com.foreach.across.modules.bootstrapui.elements.builder.AbstractLinkSupportingNodeViewElementBuilder<com.foreach.across.modules.web.ui.elements.NodeViewElement,SELF>

com.foreach.across.modules.bootstrapui.components.builder.NavComponentBuilder<SELF>

All Implemented Interfaces:

com.foreach.across.modules.web.ui.elements.builder.HtmlViewElementBuilder<com.foreach.across.modules.web.ui.elements.NodeViewElement,SELF>, com.foreach.across.modules.web.ui.ViewElementBuilder<com.foreach.across.modules.web.ui.elements.NodeViewElement>

Direct Known Subclasses:

BreadcrumbNavComponentBuilder, DefaultNavComponentBuilder, PanelsNavComponentBuilder

public abstract class NavComponentBuilder<SELF extends NavComponentBuilder<SELF>>
extends AbstractLinkSupportingNodeViewElementBuilder<com.foreach.across.modules.web.ui.elements.NodeViewElement,SELF>

Abstract base class for rendering Menu items to nav-like structures.

Since:

1.0.0

Author:

Arne Vandamme

See Also:

DefaultNavComponentBuilder, PanelsNavComponentBuilder, BreadcrumbNavComponentBuilder

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NavComponentBuilder.Separator Possible values for attribute ATTR_INSERT_SEPARATOR.

Nested classes/interfaces inherited from class com.foreach.across.modules.web.ui.ViewElementBuilderSupport

com.foreach.across.modules.web.ui.ViewElementBuilderSupport.ElementOrBuilder

Field Summary

Fields

Modifier and Type	Field and Description
static String	ATTR_ICON If this attribute exists its value must be a ViewElement or ViewElementBuilder.
static String	ATTR_ICON_ONLY If set to true and the item has an ATTR_ICON attribute set, only the icon element will be rendered if the menu item is at the top level.
static String	ATTR_INSERT_SEPARATOR Can be set to a value of NavComponentBuilder.Separator.
static String	ATTR_ITEM_VIEW_ELEMENT Holds the custom ViewElement or ViewElementBuilder that should be used to render the list item for that Menu.
static String	ATTR_KEEP_AS_GROUP If set to true this group will always be rendered as a group (dropdown) even if there is only a single item.
static String	ATTR_KEEP_GROUP_ITEM If set to true the label for the group will never be replaced by the label of the selected item.
static String	ATTR_LINK_VIEW_ELEMENT Holds the custom ViewElement or ViewElementBuilder that should be used to render the link inside the list item of that Menu.
static String	CTX_CURRENT_MENU_ITEM If a custom ViewElementBuilder is being used for rendering (part of) a Menu, the ViewElementBuilderContext will contain the Menu being rendered as an attribute with this name.

Fields inherited from class com.foreach.across.modules.web.ui.ViewElementBuilderSupport

customTemplate, name

Constructor Summary

Constructors

Constructor and Description
NavComponentBuilder()

Method Summary

Modifier and Type	Method and Description
protected void	addHtmlAttributes(com.foreach.across.modules.web.ui.elements.NodeViewElement node, Map<String,Object> attributes)
protected void	addIconAndText(com.foreach.across.modules.web.ui.elements.AbstractNodeViewElement node, com.foreach.across.modules.web.menu.Menu item, String resolvedTitle, boolean iconAllowed, boolean iconOnly, com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)
protected LinkViewElement	addItemLink(com.foreach.across.modules.web.ui.elements.NodeViewElement container, com.foreach.across.modules.web.menu.Menu item, boolean iconAllowed, boolean iconOnly, com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)
protected boolean	addViewElementIfAttributeExists(com.foreach.across.modules.web.menu.Menu item, String attributeName, com.foreach.across.modules.web.ui.elements.ContainerViewElement container, com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)
protected abstract com.foreach.across.modules.web.ui.elements.NodeViewElement	buildMenu(com.foreach.across.modules.web.menu.Menu menu, com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)
protected com.foreach.across.modules.web.ui.elements.NodeViewElement	createElement(com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)
SELF	filter(java.util.function.Predicate<com.foreach.across.modules.web.menu.Menu> predicate) Set a predicate that menu items should match before they will be rendered.
protected com.foreach.across.modules.web.menu.Menu	findFirstIncludedChild(com.foreach.across.modules.web.menu.Menu menu)
protected com.foreach.across.modules.web.menu.Menu	findItemToRender(com.foreach.across.modules.web.menu.Menu item)
protected com.foreach.across.modules.web.menu.Menu	getFirstNonGroupSelectedItem(com.foreach.across.modules.web.menu.Menu menu)
static String	htmlAttribute(String attributeName) Turns this regular attribute name into a HTML attribute name for a Menu attribute by adding the right prefix.
protected java.util.stream.Stream<com.foreach.across.modules.web.menu.Menu>	includedItems(com.foreach.across.modules.web.menu.Menu menu)
SELF	keepGroupsAsGroup(boolean keepGroupsAsGroup) Set to true if the behaviour for groups should be to keep them as group unless they have a ATTR_KEEP_AS_GROUP set.
SELF	menu(com.foreach.across.modules.web.menu.Menu menu) Set the fixed menu to render.
SELF	menu(String menuName) Set the name of the menu to render.
protected int	numberOfChildrenToInclude(com.foreach.across.modules.web.menu.Menu menu)
protected boolean	shouldIncludeItem(com.foreach.across.modules.web.menu.Menu item)
protected boolean	shouldKeepAsGroup(com.foreach.across.modules.web.menu.Menu item)

Methods inherited from class com.foreach.across.modules.bootstrapui.elements.builder.AbstractLinkSupportingNodeViewElementBuilder

buildLink, linkBuilder

Methods inherited from class com.foreach.across.modules.bootstrapui.elements.builder.AbstractHtmlSupportingNodeViewElementBuilder

escapeHtml, isEscapeHtml, resolveTextElement, toTextElement

Methods inherited from class com.foreach.across.modules.web.ui.elements.builder.AbstractNodeViewElementBuilder

apply, attribute, attributes, clearAttributes, css, htmlId, removeAttribute, removeCss

Methods inherited from class com.foreach.across.modules.web.ui.elements.builder.ContainerViewElementBuilderSupport

add, add, addAll, addFirst, addFirst, sort

Methods inherited from class com.foreach.across.modules.web.ui.ViewElementBuilderSupport

build, configure, customTemplate, name, postProcess, postProcessor, registerWebResources

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.foreach.across.modules.web.ui.elements.builder.HtmlViewElementBuilder

data, removeData

Methods inherited from interface com.foreach.across.modules.web.ui.ViewElementBuilder

andThen, build, map, map

Field Detail

ATTR_ICON

public static final String ATTR_ICON

If this attribute exists its value must be a ViewElement or ViewElementBuilder. If so the resulting ViewElement will be added before the item text.

See Also:

Constant Field Values

ATTR_ICON_ONLY

public static final String ATTR_ICON_ONLY

If set to true and the item has an ATTR_ICON attribute set, only the icon element will be rendered if the menu item is at the top level. This attribute will be inherited from the group.

Note that the actual title will still be added wrapped in a span with class nav-item-title. This supports for example collapsing navbars where the title should be visible anyway.

See Also:

Constant Field Values

ATTR_ITEM_VIEW_ELEMENT

public static final String ATTR_ITEM_VIEW_ELEMENT

Holds the custom ViewElement or ViewElementBuilder that should be used to render the list item for that Menu. The custom element should take care of all possible child menu items.

See Also:

Constant Field Values

ATTR_LINK_VIEW_ELEMENT

public static final String ATTR_LINK_VIEW_ELEMENT

Holds the custom ViewElement or ViewElementBuilder that should be used to render the link inside the list item of that Menu. In case of a group item, the custom element should handle toggling the dropdown.

See Also:

Constant Field Values

ATTR_KEEP_AS_GROUP

public static final String ATTR_KEEP_AS_GROUP

If set to true this group will always be rendered as a group (dropdown) even if there is only a single item. The default behaviour would be to then just render that item.

See Also:

Constant Field Values

ATTR_KEEP_GROUP_ITEM

public static final String ATTR_KEEP_GROUP_ITEM

If set to true the label for the group will never be replaced by the label of the selected item. This attribute is only relevant if the builder is @ DefaultNavComponentBuilder configured with DefaultNavComponentBuilder.replaceGroupBySelectedItem().

See Also:

Constant Field Values

ATTR_INSERT_SEPARATOR

public static final String ATTR_INSERT_SEPARATOR

Can be set to a value of NavComponentBuilder.Separator. Determines where a separator should be added if the item is rendered in a dropdown.

See Also:

Constant Field Values

CTX_CURRENT_MENU_ITEM

public static final String CTX_CURRENT_MENU_ITEM

If a custom ViewElementBuilder is being used for rendering (part of) a Menu, the ViewElementBuilderContext will contain the Menu being rendered as an attribute with this name.

See Also:

Constant Field Values

Constructor Detail

NavComponentBuilder

public NavComponentBuilder()

Method Detail

menu

public SELF menu(String menuName)

Set the name of the menu to render. The Menu should be available as an attribute with that name on the ViewElementBuilderContext.

NOTE: this value will be ignored if menu(Menu) was set.

Parameters:

menuName - name of the menu attribute

Returns:

current builder

menu

public SELF menu(com.foreach.across.modules.web.menu.Menu menu)

Set the fixed menu to render.

Parameters:

menu - to render

Returns:

current builder

filter

public SELF filter(@NonNull
                   java.util.function.Predicate<com.foreach.across.modules.web.menu.Menu> predicate)

Set a predicate that menu items should match before they will be rendered. By default all menu items will match.

Parameters:

predicate - to match

Returns:

current builder

keepGroupsAsGroup

public SELF keepGroupsAsGroup(boolean keepGroupsAsGroup)

Set to true if the behaviour for groups should be to keep them as group unless they have a ATTR_KEEP_AS_GROUP set. Default is not to keep them as group but to replace them by the item if there is only one.

Returns:

current builder

createElement

protected com.foreach.across.modules.web.ui.elements.NodeViewElement createElement(com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)

Specified by:

createElement in class com.foreach.across.modules.web.ui.ViewElementBuilderSupport<com.foreach.across.modules.web.ui.elements.NodeViewElement,SELF extends NavComponentBuilder<SELF>>

buildMenu

protected abstract com.foreach.across.modules.web.ui.elements.NodeViewElement buildMenu(com.foreach.across.modules.web.menu.Menu menu,
                                                                                        com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)

includedItems

protected java.util.stream.Stream<com.foreach.across.modules.web.menu.Menu> includedItems(com.foreach.across.modules.web.menu.Menu menu)

shouldIncludeItem

protected boolean shouldIncludeItem(com.foreach.across.modules.web.menu.Menu item)

findItemToRender

protected com.foreach.across.modules.web.menu.Menu findItemToRender(com.foreach.across.modules.web.menu.Menu item)

findFirstIncludedChild

protected com.foreach.across.modules.web.menu.Menu findFirstIncludedChild(com.foreach.across.modules.web.menu.Menu menu)

addHtmlAttributes

protected void addHtmlAttributes(com.foreach.across.modules.web.ui.elements.NodeViewElement node,
                                 Map<String,Object> attributes)

shouldKeepAsGroup

protected boolean shouldKeepAsGroup(com.foreach.across.modules.web.menu.Menu item)

getFirstNonGroupSelectedItem

protected com.foreach.across.modules.web.menu.Menu getFirstNonGroupSelectedItem(com.foreach.across.modules.web.menu.Menu menu)

addItemLink

protected LinkViewElement addItemLink(com.foreach.across.modules.web.ui.elements.NodeViewElement container,
                                      com.foreach.across.modules.web.menu.Menu item,
                                      boolean iconAllowed,
                                      boolean iconOnly,
                                      com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)

addIconAndText

protected void addIconAndText(com.foreach.across.modules.web.ui.elements.AbstractNodeViewElement node,
                              com.foreach.across.modules.web.menu.Menu item,
                              String resolvedTitle,
                              boolean iconAllowed,
                              boolean iconOnly,
                              com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)

addViewElementIfAttributeExists

protected boolean addViewElementIfAttributeExists(com.foreach.across.modules.web.menu.Menu item,
                                                  String attributeName,
                                                  com.foreach.across.modules.web.ui.elements.ContainerViewElement container,
                                                  com.foreach.across.modules.web.ui.ViewElementBuilderContext builderContext)

Returns:

true if an element was added

numberOfChildrenToInclude

protected int numberOfChildrenToInclude(com.foreach.across.modules.web.menu.Menu menu)

htmlAttribute

public static String htmlAttribute(String attributeName)

Turns this regular attribute name into a HTML attribute name for a Menu attribute by adding the right prefix.

Parameters:

attributeName - to convert

Returns:

attribute name for HTML attribute