Class ElementCollectionField<T>

java.lang.Object
com.vaadin.flow.component.Component
com.vaadin.flow.component.AbstractField<com.vaadin.flow.component.customfield.CustomField<List<T>>,List<T>>
com.vaadin.flow.component.customfield.CustomField<List<T>>
org.vaadin.firitin.fields.ElementCollectionField<T>
All Implemented Interfaces:
com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.BlurNotifier<com.vaadin.flow.component.customfield.CustomField<List<T>>>, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.Focusable<com.vaadin.flow.component.customfield.CustomField<List<T>>>, com.vaadin.flow.component.FocusNotifier<com.vaadin.flow.component.customfield.CustomField<List<T>>>, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasHelper, com.vaadin.flow.component.HasLabel, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasStyle, com.vaadin.flow.component.HasTheme, com.vaadin.flow.component.HasValidation, com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.customfield.CustomField<List<T>>,List<T>>,List<T>>, com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.customfield.CustomField<List<T>>,List<T>>,List<T>>, com.vaadin.flow.component.shared.HasTooltip, com.vaadin.flow.component.shared.HasValidationProperties, com.vaadin.flow.component.shared.InputField<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<com.vaadin.flow.component.customfield.CustomField<List<T>>,List<T>>,List<T>>, Serializable
public class ElementCollectionField<T> extends com.vaadin.flow.component.customfield.CustomField<List<T>>
A field to pick a list of objects from a superset.

Usage example: selecting runners to a relay team.

See Also:

  • Nested Class Summary

    Nested classes/interfaces inherited from class com.vaadin.flow.component.AbstractField

    com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C extends com.vaadin.flow.component.Component,V>

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

    com.vaadin.flow.component.BlurNotifier.BlurEvent<C extends com.vaadin.flow.component.Component>

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

    com.vaadin.flow.component.FocusNotifier.FocusEvent<C extends com.vaadin.flow.component.Component>

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

    com.vaadin.flow.component.HasValue.ValueChangeEvent<V>, com.vaadin.flow.component.HasValue.ValueChangeListener<E extends com.vaadin.flow.component.HasValue.ValueChangeEvent<?>>

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected Table
    table
    The table that is used to display the collection.

  • Constructor Summary

    Constructors
    Constructor
    Description
    ElementCollectionField(Class<T> clazz)
    Creates a new instance of the field.
    ElementCollectionField(Class<T> clazz, Class<?> editorClass)
    Creates a new instance of the field.

  • Method Summary

    Modifier and Type
    Method
    Description
    protected void
    addDeleteButtonColumn(TableRow row, T item)
    hook to overrid delect button columne
    protected void
    configureColumneHeaders()
    A hook to override the default column headers.
    protected List<T>
    generateModelValue()
     
    protected String
    getHeaderForField(String fieldName)
    Translates raw field name to header name.
    protected T
    instantiateNewItem()
     
    protected void
    setPresentationValue(List<T> ts)
     
    ElementCollectionField<T>
    withEditorInstantiator(com.vaadin.flow.function.SerializableSupplier<Object> editorInstantiator)
    Configures the instance to use given editor instantiator.

    Methods inherited from class com.vaadin.flow.component.customfield.CustomField

    add, addThemeVariants, getLabel, onAttach, remove, removeThemeVariants, setLabel, updateValue

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

    addValueChangeListener, getEmptyValue, getValue, isEmpty, setModelValue, setValue, valueEquals

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

    addListener, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onDetach, onEnabledStateChanged, removeFromParent, scrollIntoView, scrollIntoView, 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.AttachNotifier

    addAttachListener

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

    addBlurListener

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

    addDetachListener

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

    addFocusShortcut, blur, focus, getTabIndex, setTabIndex

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

    addFocusListener

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

    getElement

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

    isEnabled, setEnabled

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

    getHelperComponent, getHelperText, setHelperComponent, setHelperText

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

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

    addThemeName, addThemeNames, getThemeName, getThemeNames, hasThemeName, removeThemeName, removeThemeNames, setThemeName, setThemeName

    Methods inherited from interface com.vaadin.flow.component.shared.HasTooltip

    getTooltip, setTooltipText

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

    setManualValidation

    Methods inherited from interface com.vaadin.flow.component.shared.HasValidationProperties

    getErrorMessage, isInvalid, setErrorMessage, setInvalid

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

    addValueChangeListener, clear, getEmptyValue, getOptionalValue, getValue, isEmpty, setValue

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

    isReadOnly, isRequiredIndicatorVisible, setReadOnly, setRequiredIndicatorVisible

  • Field Details

    • table

      protected Table table
      The table that is used to display the collection.

  • Constructor Details

    • ElementCollectionField

      public ElementCollectionField(Class<T> clazz, Class<?> editorClass)
      Creates a new instance of the field.
      Parameters:
      clazz - the class of the objects in the collection
      editorClass - the class of the editor component

    • ElementCollectionField

      public ElementCollectionField(Class<T> clazz)
      Creates a new instance of the field.
      Parameters:
      clazz - the class of the objects in the collection

  • Method Details

    • withEditorInstantiator

      public ElementCollectionField<T> withEditorInstantiator(com.vaadin.flow.function.SerializableSupplier<Object> editorInstantiator)
      Configures the instance to use given editor instantiator.
      Parameters:
      editorInstantiator - the instantiator to use
      Returns:
      the instance for further configuration

    • configureColumneHeaders

      protected void configureColumneHeaders()
      A hook to override the default column headers.

    • getHeaderForField

      protected String getHeaderForField(String fieldName)
      Translates raw field name to header name. By default, decamelcases the name. Override for e.g. localization.
      Parameters:
      fieldName - the raw field name of the row property
      Returns:
      a string to be used as a header in the editor

    • addDeleteButtonColumn

      protected void addDeleteButtonColumn(TableRow row, T item)
      hook to overrid delect button columne
      Parameters:
      row - the row to add the button t
      item - the item to delete

    • instantiateNewItem

      protected T instantiateNewItem()

    • generateModelValue

      protected List<T> generateModelValue()
      Specified by:
      generateModelValue in class com.vaadin.flow.component.customfield.CustomField<List<T>>

    • setPresentationValue

      protected void setPresentationValue(List<T> ts)
      Specified by:
      setPresentationValue in class com.vaadin.flow.component.customfield.CustomField<List<T>>