Package com.vaadin.flow.component.splitlayout

Class SplitLayout

    • Constructor Detail

      • SplitLayout

        public SplitLayout()
        Constructs an empty SplitLayout.

      • 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​(SplitLayout.Orientation orientation)
        Constructs a SplitLayout with the orientation.
        Parameters:
        orientation - the orientation set to the layout

      • 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 Detail

      • 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.

        Overrides:
        addToPrimary in class GeneratedVaadinSplitLayout<SplitLayout>
        Parameters:
        components - The components to add.
        See Also:
        setOrientation(Orientation)

      • 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.

        Overrides:
        addToSecondary in class GeneratedVaadinSplitLayout<SplitLayout>
        Parameters:
        components - The components to add.
        See Also:
        setOrientation(Orientation)

      • getSecondaryComponent

        public Component getSecondaryComponent()
        Get the component currently set to the secondary split.
        Returns:
        the primary component, 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