Package com.vaadin.flow.component

Interface HasText

All Superinterfaces:
HasElement, Serializable
All Known Implementing Classes:
Abbr, Anchor, Article, Aside, Badge, Button, Code, DescriptionList, DescriptionList.Description, DescriptionList.Term, Div, DrawerToggle, Emphasis, FieldSet, FieldSet.Legend, Footer, GridMenuItem, H1, H2, H3, H4, H5, H6, Header, HtmlContainer, HtmlObject, Image, ListItem, Main, MenuItem, MenuItemBase, NativeButton, NativeDetails.Summary, NativeLabel, NativeTable, NativeTableBody, NativeTableCaption, NativeTableCell, NativeTableFooter, NativeTableHeader, NativeTableHeaderCell, NativeTableRow, Nav, OrderedList, Paragraph, Pre, RouterLink, Section, Span, Text, UnorderedList, UploadButton
public interface HasText extends HasElement
A component that supports text content.

HasText is generally implemented by components whose primary function is to have textual content. It isn't implemented for example by layouts since setText(String) will remove all existing child components and child elements. To mix text and child components in a component that also supports child components, use HasComponents.add(Component...) with the Text component for the textual parts.

The default implementations set the text as text content of HasElement.getElement(). Override all methods in this interface if the text should be added to some other element.

Since:
1.0
Author:
Vaadin Ltd

  • Method Details

    • setText

      default void setText(String text)
      Sets the given string as the content of this component. This removes any existing child components and child elements. To mix text and child components in a component that also supports child components, use HasComponents.add(Component...) with the Text component for the textual parts.
      Parameters:
      text - the text content to set

    • getText

      default String getText()
      Gets the text content of this component. This method only considers the text of the actual component. The text contents of any child components or elements are not considered.
      Returns:
      the text content of this component, not null

    • setWhiteSpace

      default void setWhiteSpace(HasText.WhiteSpace value)
      Sets the given value as "white-space" style value.
      Parameters:
      value - the "white-space" style value, not null

    • getWhiteSpace

      default HasText.WhiteSpace getWhiteSpace()
      Gets the "white-space" style value.

      The default value is WhiteSpace#NORMAL. If the "white-space" style value is non standard then null is returned.

      Returns:
      the "white-space" style value, may be null

    • bindText

      default SignalBinding<String> bindText(Signal<String> textSignal)
      Binds a Signal's value to the text content of this component. The text content is set immediately with the current signal value when the binding is created, and is kept synchronized with any subsequent signal value changes while the element is in attached state. When the element is in detached state, signal value changes have no effect. null signal unbinds the existing binding.

      While a Signal is bound, any attempt to set the text content manually throws BindingActiveException. Same happens when trying to bind a new Signal while one is already bound.

      Example of usage: 

       ValueSignal<String> signal = new ValueSignal<>("");
 Span component = new Span("");
 add(component);
 component.bindText(signal);
 signal.set("text"); // The component text content is set to "text"
      Parameters:
      textSignal - the signal to bind, not null
      Throws:
      BindingActiveException - thrown when there is already an existing binding
      See Also: