Class AppLayout

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.