Deprecated API

Contents

• Terminally Deprecated
• Methods
• Constructors
• Enum Constants

Terminally Deprecated Elements

Element	Description
com.vaadin.flow.data.provider.hierarchy.TreeDataProvider.getTreeData()	use InMemoryHierarchicalDataProvider.getHierarchicalData() instead.
com.vaadin.flow.data.value.ValueChangeMode.ON_BLUR	This mode is deprecated and will be removed in Vaadin 27. Use ValueChangeMode.ON_CHANGE instead: it also triggers when the component loses focus, but only if the value has actually changed, and it additionally covers cases that ON_BLUR misses, for example clicking TextField's clear button while the field is not focused.

Deprecated Methods

Method	Description
com.vaadin.flow.data.provider.DataCommunicator.computeRequestedRange(int, int)	since 24.9 and will be removed in Vaadin 26. Use DataCommunicator.computeViewportRange(int, int) instead.
com.vaadin.flow.data.provider.DataCommunicator.setRequestedRange(int, int)	since 24.9 and will be removed in Vaadin 26. Use DataCommunicator.setViewportRange(int, int) instead.
com.vaadin.flow.data.provider.hierarchy.HasHierarchicalDataProvider.setItems(Collection<T>, ValueProvider<T, Collection<T>>)	This method will change its behavior in Vaadin 26. It will create a TreeDataProvider with HierarchicalDataProvider.HierarchyFormat.FLATTENED, which may affect TreeGrid methods whose behavior depends on the hierarchy format, such as scrollToIndex. To preserve the current behavior, create a TreeDataProvider manually with HierarchicalDataProvider.HierarchyFormat.NESTED and set it via HasHierarchicalDataProvider.setDataProvider(HierarchicalDataProvider) instead of using this shorthand method.
com.vaadin.flow.data.provider.hierarchy.HasHierarchicalDataProvider.setItems(Stream<T>, ValueProvider<T, Stream<T>>)	This method will change its behavior in Vaadin 26. It will create a TreeDataProvider with HierarchicalDataProvider.HierarchyFormat.FLATTENED, which may affect TreeGrid methods whose behavior depends on the hierarchy format, such as scrollToIndex. To preserve the current behavior, create a TreeDataProvider manually with HierarchicalDataProvider.HierarchyFormat.NESTED and set it via HasHierarchicalDataProvider.setDataProvider(HierarchicalDataProvider) instead of using this shorthand method.
com.vaadin.flow.data.provider.hierarchy.HasHierarchicalDataProvider.setTreeData(TreeData<T>)	This method will change its behavior in Vaadin 26. It will create a TreeDataProvider with HierarchicalDataProvider.HierarchyFormat.FLATTENED, which may affect TreeGrid methods whose behavior depends on the hierarchy format, such as scrollToIndex. To preserve the current behavior, create a TreeDataProvider manually with HierarchicalDataProvider.HierarchyFormat.NESTED and set it via HasHierarchicalDataProvider.setDataProvider(HierarchicalDataProvider) instead of using this shorthand method.
com.vaadin.flow.data.provider.hierarchy.TreeDataProvider.getTreeData()	use InMemoryHierarchicalDataProvider.getHierarchicalData() instead.

Deprecated Constructors

Constructor

Description

com.vaadin.flow.data.provider.hierarchy.TreeDataProvider(TreeData<T>)

this constructor currently defaults to HierarchicalDataProvider.HierarchyFormat.NESTED, but starting from Vaadin 26 it will default to HierarchicalDataProvider.HierarchyFormat.FLATTENED instead. This may affect TreeGrid methods whose behavior depends on the hierarchy format, such as scrollToIndex. Switch to TreeDataProvider(TreeData, HierarchyFormat) and pass HierarchicalDataProvider.HierarchyFormat.NESTED explicitly to preserve the current behavior.

Deprecated Enum Constants

Enum Constant	Description
com.vaadin.flow.data.value.ValueChangeMode.ON_BLUR	This mode is deprecated and will be removed in Vaadin 27. Use ValueChangeMode.ON_CHANGE instead: it also triggers when the component loses focus, but only if the value has actually changed, and it additionally covers cases that ON_BLUR misses, for example clicking TextField's clear button while the field is not focused.