Package com.vaadin.flow.component.splitlayout

Class SplitLayout

java.lang.Object
com.vaadin.flow.component.Component
com.vaadin.flow.component.splitlayout.SplitLayout
All Implemented Interfaces:
AttachNotifier, ClickNotifier<SplitLayout>, DetachNotifier, HasElement, HasSize, HasStyle, HasTheme, HasThemeVariant<SplitLayoutVariant>, Serializable
@Tag("vaadin-split-layout") @NpmPackage(value="@vaadin/split-layout", version="25.0.0-beta5") @JsModule("@vaadin/split-layout/src/vaadin-split-layout.js") public class SplitLayout extends Component implements ClickNotifier<SplitLayout>, HasSize, HasStyle, HasThemeVariant<SplitLayoutVariant>
Split Layout is a component with two content areas and a draggable split handle between them.
Author:
Vaadin Ltd
See Also:

  • Constructor Details

    • SplitLayout

      public SplitLayout()
      Constructs an empty SplitLayout.

    • SplitLayout

      public SplitLayout(SplitLayout.Orientation orientation)
      Constructs a SplitLayout with the orientation.
      Parameters:
      orientation - the orientation set to the layout

    • SplitLayout

      public SplitLayout(Component primaryComponent, Component secondaryComponent)
      Constructs a SplitLayout with the given initial components to set to the primary and secondary splits.
      Parameters:
      primaryComponent - the component set to the primary split
      secondaryComponent - the component set to the secondary split

    • SplitLayout

      public SplitLayout(Component primaryComponent, Component secondaryComponent, SplitLayout.Orientation orientation)
      Constructs a SplitLayout with the given initial components to set to the primary and secondary splits and with the orientation.
      Parameters:
      primaryComponent - the component set to the primary split
      secondaryComponent - the component set to the secondary split
      orientation - the orientation set to the layout

  • Method Details

    • setOrientation

      public void setOrientation(SplitLayout.Orientation orientation)
      Set the orientation of the SplitLayout.

      Default value is SplitLayout.Orientation.HORIZONTAL.

      Parameters:
      orientation - the orientation of the SplitLayout. Valid enumerate values are VERTICAL and HORIZONTAL, never null

    • getOrientation

      public SplitLayout.Orientation getOrientation()
      Get the orientation of the SplitLayout.

      Default value is SplitLayout.Orientation.HORIZONTAL.

      NOTE: This property is not synchronized automatically from the client side, so the returned value may not be the same as in client side.

      Returns:
      the orientation property of the SplitLayout.

    • addToPrimary

      public void addToPrimary(Component... components)
      Sets the given components to the primary split of this layout, i.e. the left split if in horizontal mode and the top split if in vertical mode.

      Note: Calling this method with multiple arguments will wrap the components inside a <div> element.

      Note: Removing the primary component through the component API will move the secondary component to the primary split, causing this layout to desync with the server. This is a known issue.

      See Also:

    • getPrimaryComponent

      public Component getPrimaryComponent()
      Get the component currently set to the primary split.
      Returns:
      the primary component, may be null

    • addToSecondary

      public void addToSecondary(Component... components)
      Sets the given components to the secondary split of this layout, i.e. the right split if in horizontal mode and the bottom split if in vertical mode.

      Note: Calling this method with multiple arguments will wrap the components inside a <div> element.

      See Also:

    • getSecondaryComponent

      public Component getSecondaryComponent()
      Get the component currently set to the secondary split.
      Returns:
      the primary component, may be null

    • getSplitterPosition

      public Double getSplitterPosition()
      Gets the relative position of the splitter as a percentage value between 0 and 100. The value will be null unless the splitter position has been explicitly set on the server-side, or the splitter has been moved on the client side. The splitter position is automatically updated when as part of the SplitLayout.SplitterDragEndEvent.
      Returns:
      the splitter position, may be null

    • setSplitterPosition

      public void setSplitterPosition(double position)
      Sets the relative position of the splitter in percentages. The given value is used to set how much space is given to the primary component relative to the secondary component. In horizontal mode this is the width of the component and in vertical mode this is the height. The given value will automatically be clamped to the range [0, 100]. Note that when using vertical orientation, this method only works if the split layout has an explicit height, either as an absolute value or as percentage. When using a percentage value, ensure that ancestors have an explicit height as well.
      Parameters:
      position - the relative position of the splitter, in percentages

    • setPrimaryStyle

      public void setPrimaryStyle(String styleName, String value)
      Set a style to the component in the primary split.
      Parameters:
      styleName - name of the style to set
      value - the value to set

    • setSecondaryStyle

      public void setSecondaryStyle(String styleName, String value)
      Set a style to the component in the secondary split.
      Parameters:
      styleName - name of the style to set
      value - the value to set

    • remove

      public void remove(Component... components)
      Removes the given child components from this component.
      Parameters:
      components - The components to remove.
      Throws:
      IllegalArgumentException - if any of the components is not a child of this component.

    • removeAll

      public void removeAll()
      Removes the primary and the secondary components.

    • addSplitterDragEndListener

      public Registration addSplitterDragEndListener(ComponentEventListener<SplitLayout.SplitterDragEndEvent> listener)
      Adds a listener for the splitter-dragend event, which is fired when the user has stopped resizing the splitter with drag and drop.
      Parameters:
      listener - the listener to add
      Returns:
      a registration for removing the listener