com.vaadin.flow.component.listbox

Class ListBoxBase<C extends ListBoxBase<C,ITEM,VALUE>,ITEM,VALUE>

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.AbstractField<C,T>

com.vaadin.flow.component.AbstractSinglePropertyField<C,VALUE>

com.vaadin.flow.component.listbox.ListBoxBase<C,ITEM,VALUE>

All Implemented Interfaces:

com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.HasComponents, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C,VALUE>,VALUE>, com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C,VALUE>,VALUE>, com.vaadin.flow.data.binder.HasItemComponents<ITEM>, com.vaadin.flow.data.provider.HasDataView<ITEM,Void,ListBoxDataView<ITEM>>, com.vaadin.flow.data.provider.HasListDataView<ITEM,ListBoxListDataView<ITEM>>, Serializable

Direct Known Subclasses:

ListBox, MultiSelectListBox

@Tag(value="vaadin-list-box")
 @NpmPackage(value="@vaadin/vaadin-list-box",
            version="2.0.0")
 @JsModule(value="@vaadin/vaadin-list-box/src/vaadin-list-box.js")
public abstract class ListBoxBase<C extends ListBoxBase<C,ITEM,VALUE>,ITEM,VALUE>
extends com.vaadin.flow.component.AbstractSinglePropertyField<C,VALUE>
implements com.vaadin.flow.data.binder.HasItemComponents<ITEM>, com.vaadin.flow.component.HasSize, com.vaadin.flow.data.provider.HasListDataView<ITEM,ListBoxListDataView<ITEM>>, com.vaadin.flow.data.provider.HasDataView<ITEM,Void,ListBoxDataView<ITEM>>

Base class for the ListBox and MultiSelectListBox.

Author:

Vaadin Ltd

See Also:

Serialized Form

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.data.binder.HasItemComponents

com.vaadin.flow.data.binder.HasItemComponents.ItemComponent<T>

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<?>>

Method Summary

Modifier and Type	Method and Description
com.vaadin.flow.data.provider.DataProvider<ITEM,?>	getDataProvider() Deprecated. use getListDataView() or getGenericDataView() instead
ListBoxDataView<ITEM>	getGenericDataView() Gets the generic data view for the ListBox.
com.vaadin.flow.function.SerializablePredicate<ITEM>	getItemEnabledProvider() Returns the item enabled predicate.
protected Object	getItemId(ITEM item)
com.vaadin.flow.data.renderer.ComponentRenderer<? extends com.vaadin.flow.component.Component,ITEM>	getItemRenderer() Returns the item component renderer.
ListBoxListDataView<ITEM>	getListDataView() Gets the list data view for the ListBox.
protected void	onAttach(com.vaadin.flow.component.AttachEvent attachEvent)
protected void	onDetach(com.vaadin.flow.component.DetachEvent detachEvent)
void	onEnabledStateChanged(boolean enabled)
void	setDataProvider(com.vaadin.flow.data.provider.DataProvider<ITEM,?> dataProvider) Deprecated. use instead one of the setItems methods which provide access to either ListBoxListDataView or ListBoxDataView
void	setItemEnabledProvider(com.vaadin.flow.function.SerializablePredicate<ITEM> itemEnabledProvider) Sets the item enabled predicate for this ListBox.
ListBoxDataView<ITEM>	setItems(com.vaadin.flow.data.provider.DataProvider<ITEM,Void> dataProvider) Set a generic data provider for the ListBox to use and returns the base ListBoxDataView that provides API to get information on the items.
ListBoxDataView<ITEM>	setItems(com.vaadin.flow.data.provider.InMemoryDataProvider<ITEM> inMemoryDataProvider) Sets an in-memory data provider for the ListBox to use
ListBoxListDataView<ITEM>	setItems(com.vaadin.flow.data.provider.ListDataProvider<ITEM> listDataProvider) Sets a ListDataProvider for the ListBox to use and returns a ListDataView that provides information and allows operations on the items.
void	setItems(Stream<ITEM> streamOfItems) Deprecated. Because the stream is collected to a list anyway, use HasListDataView.setItems(Collection) instead.
void	setRenderer(com.vaadin.flow.data.renderer.ComponentRenderer<? extends com.vaadin.flow.component.Component,ITEM> itemRenderer) Sets the item renderer for this ListBox.
void	setRequiredIndicatorVisible(boolean requiredIndicatorVisible) Not supported!

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

getSynchronizationRegistration, hasValidValue, setPresentationValue, setSynchronizedEvent

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, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getLocale, getParent, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, 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.data.binder.HasItemComponents

addComponents, getItemPosition, prependComponents

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

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

Methods inherited from interface com.vaadin.flow.data.provider.HasListDataView

setItems, setItems

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

isReadOnly, isRequiredIndicatorVisible, setReadOnly

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

clear, getOptionalValue

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

addAttachListener

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

addDetachListener

Method Detail

setDataProvider

@Deprecated
public void setDataProvider(com.vaadin.flow.data.provider.DataProvider<ITEM,?> dataProvider)

Deprecated. use instead one of the setItems methods which provide access to either ListBoxListDataView or ListBoxDataView

onAttach

protected void onAttach(com.vaadin.flow.component.AttachEvent attachEvent)

Overrides:

onAttach in class com.vaadin.flow.component.Component

onDetach

protected void onDetach(com.vaadin.flow.component.DetachEvent detachEvent)

Overrides:

onDetach in class com.vaadin.flow.component.Component

getDataProvider

@Deprecated
public com.vaadin.flow.data.provider.DataProvider<ITEM,?> getDataProvider()

Deprecated. use getListDataView() or getGenericDataView() instead

Gets the data provider.

Returns:

the data provider, not null

getItemRenderer

public com.vaadin.flow.data.renderer.ComponentRenderer<? extends com.vaadin.flow.component.Component,ITEM> getItemRenderer()

Returns the item component renderer.

Returns:

the item renderer

See Also:

setRenderer(com.vaadin.flow.data.renderer.ComponentRenderer<? extends com.vaadin.flow.component.Component, ITEM>)

setRenderer

public void setRenderer(com.vaadin.flow.data.renderer.ComponentRenderer<? extends com.vaadin.flow.component.Component,ITEM> itemRenderer)

Sets the item renderer for this ListBox. The renderer is applied to each item to create a component which represents the item.

Parameters:

itemRenderer - the item renderer, not null

setItemEnabledProvider

public void setItemEnabledProvider(com.vaadin.flow.function.SerializablePredicate<ITEM> itemEnabledProvider)

Sets the item enabled predicate for this ListBox. The predicate is applied to each item to determine whether the item should be enabled (true) or disabled (false). Disabled items are displayed as grayed out and the user cannot select them. The default predicate always returns true (all the items are enabled).

Parameters:

itemEnabledProvider - the item enable predicate, not null

getItemEnabledProvider

public com.vaadin.flow.function.SerializablePredicate<ITEM> getItemEnabledProvider()

Returns the item enabled predicate.

Returns:

the item enabled predicate

See Also:

setItemEnabledProvider(com.vaadin.flow.function.SerializablePredicate<ITEM>)

setRequiredIndicatorVisible

public void setRequiredIndicatorVisible(boolean requiredIndicatorVisible)

Not supported!

Not supported by the client-side web-component, see issue in GitHub.

Specified by:

setRequiredIndicatorVisible in interface com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C extends ListBoxBase<C,ITEM,VALUE>,VALUE>,VALUE>

Specified by:

setRequiredIndicatorVisible in interface com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C extends ListBoxBase<C,ITEM,VALUE>,VALUE>,VALUE>

Throws:

UnsupportedOperationException

onEnabledStateChanged

public void onEnabledStateChanged(boolean enabled)

Overrides:

onEnabledStateChanged in class com.vaadin.flow.component.Component

setItems

public ListBoxDataView<ITEM> setItems(com.vaadin.flow.data.provider.DataProvider<ITEM,Void> dataProvider)

Set a generic data provider for the ListBox to use and returns the base ListBoxDataView that provides API to get information on the items.

This method should be used only when the data provider type is not either ListDataProvider or BackEndDataProvider.

Specified by:

setItems in interface com.vaadin.flow.data.provider.HasDataView<ITEM,Void,ListBoxDataView<ITEM>>

Parameters:

dataProvider - DataProvider instance to use, not null

Returns:

ListBoxDataView providing information on the data

setItems

public ListBoxDataView<ITEM> setItems(com.vaadin.flow.data.provider.InMemoryDataProvider<ITEM> inMemoryDataProvider)

Sets an in-memory data provider for the ListBox to use

Note! Using a ListDataProvider instead of a InMemoryDataProvider is recommended to get access to ListBoxListDataView API by using HasListDataView.setItems(ListDataProvider).

Specified by:

setItems in interface com.vaadin.flow.data.provider.HasDataView<ITEM,Void,ListBoxDataView<ITEM>>

Parameters:

inMemoryDataProvider - InMemoryDataProvider to use, not null

Returns:

ListBoxDataView providing information on the data

setItems

public ListBoxListDataView<ITEM> setItems(com.vaadin.flow.data.provider.ListDataProvider<ITEM> listDataProvider)

Sets a ListDataProvider for the ListBox to use and returns a ListDataView that provides information and allows operations on the items.

Specified by:

setItems in interface com.vaadin.flow.data.provider.HasListDataView<ITEM,ListBoxListDataView<ITEM>>

Parameters:

listDataProvider - ListDataProvider providing items to the ListBox.

Returns:

ListBoxListDataView providing access to the items

setItems

@Deprecated
public void setItems(Stream<ITEM> streamOfItems)

Deprecated. Because the stream is collected to a list anyway, use HasListDataView.setItems(Collection) instead.

getListDataView

public ListBoxListDataView<ITEM> getListDataView()

Gets the list data view for the ListBox. This data view should only be used when the items are in-memory and set with:

• HasListDataView.setItems(Collection)
• HasListDataView.setItems(Object[])
• setItems(ListDataProvider)

If the items are not in-memory an exception is thrown.

Specified by:

getListDataView in interface com.vaadin.flow.data.provider.HasListDataView<ITEM,ListBoxListDataView<ITEM>>

Returns:

the list data view that provides access to the data bound to the ListBox

getGenericDataView

public ListBoxDataView<ITEM> getGenericDataView()

Gets the generic data view for the ListBox. This data view should only be used when getListDataView() is not applicable for the underlying data provider.

Specified by:

getGenericDataView in interface com.vaadin.flow.data.provider.HasDataView<ITEM,Void,ListBoxDataView<ITEM>>

Returns:

the generic DataView instance implementing ListBoxDataView

getItemId

protected Object getItemId(ITEM item)