com.vaadin.flow.component.html

Class Label

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.HtmlComponent

com.vaadin.flow.component.HtmlContainer

com.vaadin.flow.component.html.Label

All Implemented Interfaces:

AttachNotifier, DetachNotifier, HasComponents, HasElement, HasEnabled, HasSize, HasStyle, HasText, Serializable

@Tag(value="label")
public class Label
extends HtmlContainer

Component for a <label> element, which represents a caption for an item in a user interface.

Note that Label components are not meant for loose text in the page - they should be coupled with another component by using the setFor(Component) or by adding them to it with the HasComponents.add(Component...) method.

Clicking on a label automatically transfers the focus to the associated component. This is especially helpful when building forms with Inputs.

For adding texts to the page without linking them to other components, consider using a Span or a Div instead.

Since:

1.0

Author:

Vaadin Ltd

See Also:

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/label, Serialized Form

Constructor Summary

Constructors

Constructor and Description
Label() Creates a new empty label.
Label(String text) Creates a new label with the given text content.

Method Summary

Modifier and Type	Method and Description
Optional<String>	getFor() Gets the id of the component that this label describes.
void	setFor(Component forComponent) Sets the component that this label describes.
void	setFor(String forId) Sets the id of the component that this label describes.

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

getTitle, setTitle

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

getText, setText

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

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

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

addAttachListener

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

addDetachListener

Constructor Detail

Label

public Label()

Creates a new empty label.

Label

public Label(String text)

Creates a new label with the given text content.

Parameters:

text - the text content

Method Detail

setFor

public void setFor(Component forComponent)

Sets the component that this label describes. The component (or its id) should be defined in case the described component is not an ancestor of the label.

The provided component must have an id set. This component will still use the old id if the id of the provided component is changed after this method has been called.

Parameters:

forComponent - the component that this label describes, not null , must have an id

Throws:

IllegalArgumentException - if the provided component has no id

setFor

public void setFor(String forId)

Sets the id of the component that this label describes. The id should be defined in case the described component is not an ancestor of the label.

Parameters:

forId - the id of the described component, or null if there is no value

getFor

public Optional<String> getFor()

Gets the id of the component that this label describes.

Returns:

an optional id of the described component, or an empty optional if the attribute has not been set

See Also:

setFor(String)