com.vaadin.flow.component.applayout

Class AppLayout

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.applayout.AppLayout

All Implemented Interfaces:

AttachNotifier, DetachNotifier, HasElement, RouterLayout, Serializable

@Tag(value="vaadin-app-layout")
 @NpmPackage(value="@vaadin/vaadin-app-layout",
            version="2.2.0")
 @JsModule(value="@vaadin/vaadin-app-layout/src/vaadin-app-layout.js")
public class AppLayout
extends Component
implements RouterLayout

Server-side component for the <vaadin-app-layout> element. Provides a quick and easy way to get a common application layout.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AppLayout.Section Sections in the component that can be used as primary.

Constructor Summary

Constructors

Constructor and Description
AppLayout()

Method Summary

Modifier and Type	Method and Description
void	addToDrawer(Component... components) Adds the components to the drawer slot of this AppLayout.
void	addToNavbar(boolean touchOptimized, Component... components) Adds the components to the navbar slot of this AppLayout.
void	addToNavbar(Component... components) Adds the components to the navbar slot of this AppLayout.
protected void	afterNavigation() Called after a navigation event.
Component	getContent()
AppLayout.Section	getPrimarySection()
boolean	isDrawerOpened() Whether the drawer is opened (visible) or not.
boolean	isOverlay() Note: This property is controlled via CSS and can not be changed directly.
void	remove(Component... components) Removes the child components from the parent.
void	setContent(Component content) Sets the displayed content.
void	setDrawerOpened(boolean drawerOpened) Server-side API for showing and hiding the drawer.
void	setPrimarySection(AppLayout.Section primarySection) Defines whether navbar or drawer will come first visually.
void	showRouterLayoutContent(HasElement content) Shows the content of the layout which is the router target component annotated with a @Route.

Methods inherited from class com.vaadin.flow.component.Component

addListener, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onAttach, onDetach, onEnabledStateChanged, set, setElement, setId, setVisible

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.flow.router.RouterLayout

removeRouterLayoutContent

Methods inherited from interface com.vaadin.flow.component.HasElement

getElement

Methods inherited from interface com.vaadin.flow.component.AttachNotifier

addAttachListener

Methods inherited from interface com.vaadin.flow.component.DetachNotifier

addDetachListener

Constructor Detail

AppLayout

public AppLayout()

Method Detail

getPrimarySection

@Synchronize(value="primary-section-changed")
public AppLayout.Section getPrimarySection()

Returns:

value for the primarySection property. Default is AppLayout.Section.NAVBAR.

See Also:

setPrimarySection(Section)

setPrimarySection

public void setPrimarySection(AppLayout.Section primarySection)

Defines whether navbar or drawer will come first visually.

• If AppLayout.Section.NAVBAR, the navbar takes the full available width and moves the drawer down. This is the default.
• If AppLayout.Section.DRAWER is set, then the drawer will move the navbar, taking the full available height.

Parameters:

primarySection - new value for the primarySection property. Not null.

Throws:

NullPointerException - if primarySection is null.

isDrawerOpened

@Synchronize(value="drawer-opened-changed")
public boolean isDrawerOpened()

Whether the drawer is opened (visible) or not. Its default value depends on the viewport:

• true for desktop size views
• false for mobile size views

Returns:

true if the drawer is opened (visible). false otherwise.

setDrawerOpened

public void setDrawerOpened(boolean drawerOpened)

Server-side API for showing and hiding the drawer.

Parameters:

drawerOpened - new value for the drawerOpened property.

See Also:

isDrawerOpened(), for a component that allows the user to open and close the drawer.

isOverlay

@Synchronize(value="overlay-changed")
public boolean isOverlay()

Note: This property is controlled via CSS and can not be changed directly.

Returns:

true if drawer is an overlay on top of the content. false otherwise.

getContent

public Component getContent()

Returns:

the displayed content

setContent

public void setContent(Component content)

Sets the displayed content.

Parameters:

content - Component to display in the content area

addToDrawer

public void addToDrawer(Component... components)

Adds the components to the drawer slot of this AppLayout.

Parameters:

components - Components to add to the drawer slot.

Throws:

NullPointerException - if any of the components is null or if the components array is null.

addToNavbar

public void addToNavbar(Component... components)

Adds the components to the navbar slot of this AppLayout.

Parameters:

components - Components to add to the navbar slot.

Throws:

NullPointerException - if any of the components is null or if the components array is null.

addToNavbar

public void addToNavbar(boolean touchOptimized,
                        Component... components)

Adds the components to the navbar slot of this AppLayout.

Parameters:

touchOptimized - if true, the components will be moved to the bottom navbar area on mobile devices.

components - Components to add to the navbar slot.

Throws:

NullPointerException - if any of the components is null or if the components array is null.

remove

public void remove(Component... components)

Removes the child components from the parent. Components can be in any slot or be the main content.

Parameters:

components - Components to remove.

showRouterLayoutContent

public void showRouterLayoutContent(HasElement content)

Shows the content of the layout which is the router target component annotated with a @Route.

Note implementors should not care about old @Route content, since it's handled separately by RouterLayout.removeRouterLayoutContent(HasElement) which by default simply removes the old content.

Specified by:

showRouterLayoutContent in interface RouterLayout

Parameters:

content - the content component or null if the layout content is to be cleared.

Throws:

IllegalArgumentException - if content is not a Component

afterNavigation

protected void afterNavigation()

Called after a navigation event. The default behaviour is to close the drawer on mobile devices after a navigation event.