com.vaadin.flow.component.orderedlayout

Class HorizontalLayout

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.orderedlayout.HorizontalLayout

All Implemented Interfaces:

AttachNotifier, ClickNotifier<HorizontalLayout>, DetachNotifier, HasComponents, HasElement, HasEnabled, HasOrderedComponents<HorizontalLayout>, HasSize, HasStyle, FlexComponent<HorizontalLayout>, ThemableLayout, Serializable

@Tag(value="vaadin-horizontal-layout")
 @NpmPackage(value="@vaadin/vaadin-ordered-layout",
            version="1.4.0")
 @JsModule(value="@vaadin/vaadin-ordered-layout/src/vaadin-horizontal-layout.js")
 @HtmlImport(value="frontend://bower_components/vaadin-ordered-layout/src/vaadin-horizontal-layout.html")
public class HorizontalLayout
extends Component
implements ThemableLayout, FlexComponent<HorizontalLayout>, ClickNotifier<HorizontalLayout>

HorizontalLayout is a component container, which shows the subcomponents in the order of their addition (horizontally). A horizontal layout is doesn't have a predefined size - its size is defined by the components inside it.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.flow.component.orderedlayout.FlexComponent

FlexComponent.Alignment, FlexComponent.JustifyContentMode

Constructor Summary

Constructors

Constructor and Description
HorizontalLayout() Constructs an empty layout with spacing on by default.
HorizontalLayout(Component... children) Convenience constructor to create a layout with the children already inside it.

Method Summary

Modifier and Type	Method and Description
void	addAndExpand(Component... components) Adds the given components to this layout and sets them as expanded.
FlexComponent.Alignment	getAlignItems() This is the same as getDefaultVerticalComponentAlignment().
FlexComponent.Alignment	getAlignSelf(HasElement container) This is the same as getVerticalComponentAlignment(Component).
FlexComponent.Alignment	getDefaultVerticalComponentAlignment() Gets the default vertical alignment used by all components without individual alignments inside the layout.
FlexComponent.Alignment	getVerticalComponentAlignment(Component component) Gets the individual vertical alignment of a given component.
void	setAlignItems(FlexComponent.Alignment alignment) This is the same as #setDefaultVerticalComponentAlignment(Alignment).
void	setAlignSelf(FlexComponent.Alignment alignment, HasElement... elementContainers) This is the same as #setVerticalComponentAlignment(Alignment, Component...).
void	setDefaultVerticalComponentAlignment(FlexComponent.Alignment alignment) Sets the default vertical alignment to be used by all components without individual alignments inside the layout.
void	setSpacing(boolean spacing) Toggles spacing theme setting for the element.
void	setVerticalComponentAlignment(FlexComponent.Alignment alignment, Component... componentsToAlign) Sets a vertical alignment for individual components inside the layout.

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

addListener, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getLocale, getParent, 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.component.orderedlayout.ThemableLayout

getBoxSizing, getThemeList, isMargin, isPadding, isSpacing, setBoxSizing, setMargin, setPadding

Methods inherited from interface com.vaadin.flow.component.orderedlayout.FlexComponent

expand, getFlexGrow, getJustifyContentMode, replace, setFlexGrow, setJustifyContentMode

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

getChildren, getComponentAt, getComponentCount, indexOf

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

add, add, addComponentAsFirst, addComponentAtIndex, remove, removeAll

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

isEnabled, setEnabled

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

getElement

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

addClassName, addClassNames, getClassName, getClassNames, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

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

getCssSize, getHeight, getHeightUnit, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, getWidthUnit, setHeight, setHeight, setHeightFull, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthFull

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

addClickListener, addClickShortcut

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

addAttachListener

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

addDetachListener

Constructor Detail

HorizontalLayout

public HorizontalLayout()

Constructs an empty layout with spacing on by default.

HorizontalLayout

public HorizontalLayout(Component... children)

Convenience constructor to create a layout with the children already inside it.

Parameters:

children - the items to add to this layout

See Also:

HasComponents.add(Component...)

Method Detail

setSpacing

public void setSpacing(boolean spacing)

Toggles spacing theme setting for the element. If a theme supports this attribute, it will apply or remove spacing to the element.

This method adds medium spacing to the component theme, to set other options, use ThemableLayout.getThemeList(). List of options possible:

• spacing-xs
• spacing-s
• spacing
• spacing-l
• spacing-xl

Spacing is enabled by default for horizontal layout.

Specified by:

setSpacing in interface ThemableLayout

Parameters:

spacing - adds spacing theme setting if true or removes it if false

setVerticalComponentAlignment

public void setVerticalComponentAlignment(FlexComponent.Alignment alignment,
                                          Component... componentsToAlign)

Sets a vertical alignment for individual components inside the layout. This individual alignment for the component overrides any alignment set at the #setDefaultVerticalComponentAlignment(Alignment).

It effectively sets the "alignSelf" style value.

The default alignment for individual components is Alignment#AUTO.

It's the same as the FlexComponent.setAlignSelf(Alignment, HasElement...) method

Parameters:

alignment - the individual alignment for the children components. Setting null will reset the alignment to its default

componentsToAlign - The components to which the individual alignment should be set

See Also:

FlexComponent.setAlignSelf(Alignment, HasElement...)

getVerticalComponentAlignment

public FlexComponent.Alignment getVerticalComponentAlignment(Component component)

Gets the individual vertical alignment of a given component.

The default alignment for individual components is Alignment#AUTO.

It's the same as the getAlignSelf(HasElement) method.

Parameters:

component - The component which individual layout should be read

Returns:

the alignment of the component, never null

See Also:

getAlignSelf(HasElement)

setDefaultVerticalComponentAlignment

public void setDefaultVerticalComponentAlignment(FlexComponent.Alignment alignment)

Sets the default vertical alignment to be used by all components without individual alignments inside the layout. Individual components can be aligned by using the #setVerticalComponentAlignment(Alignment, Component...) method.

It effectively sets the "alignItems" style value.

The default alignment is Alignment#STRETCH.

It's the same as the FlexComponent.setAlignItems(Alignment) method.

Parameters:

alignment - the alignment to apply to the components. Setting null will reset the alignment to its default

See Also:

FlexComponent.setAlignItems(Alignment)

getDefaultVerticalComponentAlignment

public FlexComponent.Alignment getDefaultVerticalComponentAlignment()

Gets the default vertical alignment used by all components without individual alignments inside the layout.

The default alignment is Alignment#STRETCH.

This is the same as the getAlignItems() method.

Returns:

the general alignment used by the layout, never null

setAlignItems

public void setAlignItems(FlexComponent.Alignment alignment)

This is the same as #setDefaultVerticalComponentAlignment(Alignment).

Specified by:

setAlignItems in interface FlexComponent<HorizontalLayout>

Parameters:

alignment - the alignment to apply to the components. Setting null will reset the alignment to its default

See Also:

#setDefaultVerticalComponentAlignment(Alignment)

getAlignItems

public FlexComponent.Alignment getAlignItems()

This is the same as getDefaultVerticalComponentAlignment().

Specified by:

getAlignItems in interface FlexComponent<HorizontalLayout>

Returns:

the general alignment used by the layout, never null

setAlignSelf

public void setAlignSelf(FlexComponent.Alignment alignment,
                         HasElement... elementContainers)

This is the same as #setVerticalComponentAlignment(Alignment, Component...).

Specified by:

setAlignSelf in interface FlexComponent<HorizontalLayout>

Parameters:

alignment - the individual alignment for the children components. Setting null will reset the alignment to its default

elementContainers - The element containers (components) to which the individual alignment should be set

See Also:

#setVerticalComponentAlignment(Alignment, Component...)

getAlignSelf

public FlexComponent.Alignment getAlignSelf(HasElement container)

This is the same as getVerticalComponentAlignment(Component).

Specified by:

getAlignSelf in interface FlexComponent<HorizontalLayout>

Parameters:

container - The element container (component) which individual layout should be read

Returns:

the alignment of the container, never null

See Also:

getVerticalComponentAlignment(Component)

addAndExpand

public void addAndExpand(Component... components)

Adds the given components to this layout and sets them as expanded. The flex-grow of all added child components are set to 1 so that the expansion will be effective. The width of this layout is also set to 100%.

Parameters:

components - the components to set, not null