Deprecated API
Contents
- Terminally Deprecated
- Interfaces
- Classes
- Exception Classes
- Annotation Interfaces
- Fields
- Methods
- Constructors
- Enum Constants
- Annotation Interface Elements
-
Terminally Deprecated ElementsElementDescriptionAs of 25.0, replaced by
VaadinHotswapper.onClassesChange(HotswapClassEvent). Please consider moving your implementation to that method.As of 25.0, replaced byVaadinHotswapper.onClassesChange(HotswapClassSessionEvent). Please consider moving your implementation to that method.since 1.1, for removal in 26.0; useBaseBrowserlessTest.find(Class)instead.since 1.1, for removal in 26.0; useBaseBrowserlessTest.find(Class, Component)instead.since 1.1, for removal in 26.0; useBaseBrowserlessTest.findInView(Class)instead.UseComponentQuery.single()for more reliable tests that assert exactly one matching component, or useComponentQuery.atIndex(int)with an explicit index if selecting from multiple components is intentional.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead of opening topic connections.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.UseAvatar.setImageHandler(DownloadHandler)insteadUseHasAriaRole.getAriaRole()instead.UseHasAriaRole.setAriaRole(String)instead.Board is deprecated and will be removed in Vaadin 26. Consider using Dashboard as an alternative.Board Row is deprecated and will be removed in Vaadin 26. Consider using Dashboard as an alternative.UseAxis.setExtremes(Instant, Instant)instead.UseAxis.setExtremes(Instant, Instant, boolean)instead.UseAxis.setExtremes(Instant, Instant, boolean, boolean)instead.UseStyle#setLineHeight(String)instead.usePlotOptionsOrganization.getLink().Link.setColor(Color)instead.usePlotOptionsOrganization.getLink().Link.setRadius(Number)instead.UsePlotOptionsTreemap.setAllowTraversingTree(Boolean)instead.UsePlotOptionsTreemap.setAllowTraversingTree(Boolean)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This variant is not working and will be removed in the next major.This variant is not working and will be removed in the next major.This variant is not working and will be removed in the next major.useComponentUtil.resolveOrGenerateIdLater(Element, Component, String, SerializableSupplier, SerializableConsumer)instead. Without a getter, a value set after this call is overwritten when the resolution runs, and the target of a superseded resolution is still assigned a generated id. In addition, the pending resolution is stored in the state tree, or as an attach listener whilesourceElementis detached, so a consumer that is not serializable makes the session fail to serialize.UseContextMenuElementinstead.UseContextMenuElement.getMenuItem(String)instead.UseContextMenuElement.getMenuItems()instead.Create a new instance and set only the properties to customize. Unset properties fall back to the component's default texts.Deprecated without replacement.Pre v25.0, this method returned either the editor overlay, when the editor was displayed as a dialog, or the Crud itself, when the editor was displayed inline. Since v25.0, the overlay is not accessible as a separate element anymore, and, regardless whether the editor is displayed as a dialog or inline, all editor-related controls can be queried through the Crud element itself. To specifically access the editor fields, useCrudElement.getForm()instead. To access the editor buttons, useCrudElement.getEditorSaveButton(),CrudElement.getEditorCancelButton(), andCrudElement.getEditorDeleteButton().UseDetailsVariant.FILLEDinstead.UseDetailsVariant.REVERSEinstead.UseDetailsVariant.SMALLinstead.UseHasAriaRole.getAriaRole()insteadUseHasAriaRole.getAriaRole()insteaduseDialog.isAutofocus()insteaduseDialog.getModality()insteaduseDialog.setAutofocus(boolean)insteaduseDialog.setModality(ModalityMode)insteadUseHasAriaRole.setAriaRole(String)insteadUseHasAriaRole.setAriaRole(String)insteadsince 25.2, for removal. UseDragEndEvent(Component, boolean, String, int, int)which also captures the pointer's client coordinates. When this constructor is used,AbstractDnDEvent.getClientX()andAbstractDnDEvent.getClientY()return0.since 25.2, for removal. UseDragStartEvent(Component, boolean, int, int, int, int)which also captures the pointer's client and offset coordinates. When this constructor is used,AbstractDnDEvent.getClientX(),AbstractDnDEvent.getClientY(),DragStartEvent.getOffsetX()andDragStartEvent.getOffsetY()return0.since 25.2, for removal. UseDropEvent(Component, boolean, String, int, int, int, int)which also captures the pointer's client and drop-target offset coordinates. When this constructor is used,AbstractDnDEvent.getClientX(),AbstractDnDEvent.getClientY(),DropEvent.getOffsetX()andDropEvent.getOffsetY()return0.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This class and the constructors that accept it will be removed in Vaadin 26.To customize array updates, overrideGrid.createDefaultArrayUpdater()and return aGridArrayUpdaterwhosestartUpdatemethod returns a customArrayUpdater.Updateimplementation. This class will be made private in Vaadin 26.internal method, will be removed without a replacement.UseAbstractColumn.getFooterText()orAbstractColumn.getFooterComponent()directlysince 25.0, and will be removed in Vaadin 26. UseTreeGridElement.scrollToRowByFlatIndex(int)instead.since 25.0 and will be removed in Vaadin 26. UseTreeGridElement.scrollToRowByPath(int...)with a single index instead.since 25.0 and will be removed in Vaadin 26. UseTreeGridElement.scrollToRowByPath(int...)instead.since 25.1, for removal in 26.useAnchor(DownloadHandler, String)insteaduseAnchor.setHref(DownloadHandler)insteaduseHtmlObject(DownloadHandler)insteaduseHtmlObject(DownloadHandler,Param...)insteaduseHtmlObject(DownloadHandler,String)insteaduseHtmlObject(DownloadHandler,String, Param...)insteaduseHtmlObject.setData(DownloadHandler)insteaduseIFrame.setSrc(DownloadHandler)insteaduseImage(DownloadHandler, String)insteaduseImage.setSrc(DownloadHandler)insteadsince 25.3, scheduled for removal in Vaadin 26. UseTableinstead. It does not extendHtmlContainer, so it has no genericadd(Component)and cannot be given children the HTML specification does not allow inside a<table>; it keeps the caption, column groups and sections in the order the specification requires whatever order they are added in; and it carries a good deal more API, including<colgroup>and<col>support, row and cell factories that setscope,colspanandrowspan, and binding a section's rows to a signal.since 25.3, scheduled for removal in Vaadin 26. UseTableBodyinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26. UseTableCaptioninstead, the equivalent in theTablecomponent family.since 25.3, scheduled for removal in Vaadin 26. UseTableDataCellinstead, the equivalent in theTablecomponent family.since 25.3, scheduled for removal in Vaadin 26. UseTableFootinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26. UseTableHeadinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26. UseTableHeaderCellinstead, the equivalent in theTablecomponent family.since 25.3, scheduled for removal in Vaadin 26. UseTableRowinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableBodyElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableCaptionElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableDataCellElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableFootElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableHeaderCellElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableHeadElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableRowElementinstead.UseSvgIcon(DownloadHandler)insteadUseSvgIcon(DownloadHandler, String)insteadUseSvgIcon.setSrc(DownloadHandler)insteadUseSvgIcon.setSrc(DownloadHandler, String)insteadUseVaadinIcon.CALCinstead.UseVaadinIcon.DOCKinstead.UseVaadinIcon.CONTRASTinstead.Use a replacement from simpleicons.org.UseVaadinIcon.ALTinstead.UseVaadinIcon.ARROW_CIRCLE_DOWNinstead.UseVaadinIcon.ARROW_CIRCLE_LEFTinstead.UseVaadinIcon.ARROW_CIRCLE_RIGHTinstead.UseVaadinIcon.ARROW_CIRCLE_UPinstead.UseVaadinIcon.BACKSPACEinstead.UseVaadinIcon.BELLinstead.UseVaadinIcon.BELL_SLASHinstead.UseVaadinIcon.BOOKMARKinstead.UseVaadinIcon.BUGinstead.UseVaadinIcon.BUILDINGinstead.UseVaadinIcon.CALENDARinstead.UseVaadinIcon.CARET_SQUARE_DOWNinstead.UseVaadinIcon.CARET_SQUARE_LEFTinstead.UseVaadinIcon.CARET_SQUARE_RIGHTinstead.UseVaadinIcon.CARET_SQUARE_UPinstead.UseVaadinIcon.CARTinstead.UseVaadinIcon.LINE_CHARTinstead.UseVaadinIcon.CHECK_CIRCLEinstead.UseVaadinIcon.CHECK_SQUAREinstead.UseVaadinIcon.CHEVRON_CIRCLE_DOWNinstead.UseVaadinIcon.CHEVRON_CIRCLE_LEFTinstead.UseVaadinIcon.CHEVRON_CIRCLE_RIGHTinstead.UseVaadinIcon.CHEVRON_CIRCLE_UPinstead.UseVaadinIcon.CIRCLEinstead.UseVaadinIcon.CLOSEinstead.UseVaadinIcon.CLOSE_CIRCLEinstead.UseVaadinIcon.CLOSEinstead.UseVaadinIcon.CLOUD_DOWNLOADinstead.UseVaadinIcon.CLOUDinstead.UseVaadinIcon.CLOUD_UPLOADinstead.UseVaadinIcon.COGinstead.UseVaadinIcon.COMMENT_ELLIPSISinstead.UseVaadinIcon.COMMENTinstead.UseVaadinIcon.COMMENTSinstead.UseVaadinIcon.CONNECTinstead.UseVaadinIcon.COPYinstead.UseVaadinIcon.CODEinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.CURSORinstead.UseVaadinIcon.OUTDENTinstead.UseVaadinIcon.BACKSPACEinstead.UseVaadinIcon.BACKSPACEinstead.UseVaadinIcon.DIAMONDinstead.UseVaadinIcon.ELLIPSIS_CIRCLEinstead.UseVaadinIcon.ELLIPSIS_Hinstead.UseVaadinIcon.ELLIPSIS_Vinstead.UseVaadinIcon.ENVELOPEinstead.UseVaadinIcon.ENVELOPE_OPENinstead.UseVaadinIcon.ENVELOPESinstead.UseVaadinIcon.EXCLAMATION_CIRCLEinstead.UseVaadinIcon.EXITinstead.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.UseVaadinIcon.FILEinstead.UseVaadinIcon.FILE_TEXTinstead.UseVaadinIcon.FILE_TREEinstead.UseVaadinIcon.FILE_TREEinstead.UseVaadinIcon.FLAGinstead.UseVaadinIcon.FOLDERinstead.UseVaadinIcon.FOLDER_OPENinstead.UseVaadinIcon.FROWNinstead.UseVaadinIcon.FILTERinstead.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.UseVaadinIcon.GRIDinstead.UseVaadinIcon.GRID_BIGinstead.UseVaadinIcon.GRIDinstead.UseVaadinIcon.GRIDinstead.UseVaadinIcon.PERSONinstead.UseVaadinIcon.HARDDRIVEinstead.UseVaadinIcon.HEARTinstead.UseVaadinIcon.HOMEinstead.UseVaadinIcon.INFO_CIRCLEinstead.UseVaadinIcon.KEYBOARDinstead.UseVaadinIcon.LEVEL_DOWNinstead.UseVaadinIcon.LEVEL_LEFTinstead.UseVaadinIcon.LEVEL_RIGHTinstead.UseVaadinIcon.LEVEL_UPinstead.UseVaadinIcon.COMPASSinstead.UseVaadinIcon.COMPASSinstead.UseVaadinIcon.MEHinstead.UseVaadinIcon.MINUS_CIRCLEinstead.UseVaadinIcon.MINUS_SQUAREinstead.UseVaadinIcon.MOBILEinstead.UseVaadinIcon.MOBILEinstead.UseVaadinIcon.MOONinstead.UseVaadinIcon.SUN_RISEinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.PAPERPLANEinstead.UseVaadinIcon.PHONEinstead.UseVaadinIcon.PIGGY_BANKinstead.UseVaadinIcon.PLAY_CIRCLEinstead.UseVaadinIcon.PLUS_CIRCLEinstead.UseVaadinIcon.PLUS_SQUAREinstead.UseVaadinIcon.QUESTION_CIRCLEinstead.UseVaadinIcon.BRANCHinstead.UseVaadinIcon.BRANCHinstead.UseVaadinIcon.RSSinstead.UseVaadinIcon.SCALEinstead.UseVaadinIcon.SHIFTinstead.UseVaadinIcon.SIGN_INinstead.UseVaadinIcon.SIGN_OUTinstead.UseVaadinIcon.SLIDERSinstead.UseVaadinIcon.SMILEYinstead.UseVaadinIcon.SPINNERinstead.UseVaadinIcon.SPINNERinstead.UseVaadinIcon.CUTLERYinstead.UseVaadinIcon.SQUAREinstead.UseVaadinIcon.STAR_HALFinstead.UseVaadinIcon.STAR_HALF_LEFTinstead.UseVaadinIcon.STAR_HALFinstead.UseVaadinIcon.STAR_HALF_RIGHTinstead.UseVaadinIcon.STARinstead.UseVaadinIcon.DOCTORinstead.UseVaadinIcon.FORKLIFTinstead.UseVaadinIcon.SUNinstead.UseVaadinIcon.TABinstead.UseVaadinIcon.INPUTinstead.UseVaadinIcon.FONTinstead.UseVaadinIcon.SQUAREinstead.UseVaadinIcon.THUMBS_DOWNinstead.UseVaadinIcon.THUMBS_UPinstead.UseVaadinIcon.POINTERinstead.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Create a new instance and set only the properties to customize. Unset properties fall back to the component's default texts.useMapBase.addClickListener(ComponentEventListener)insteadUseMapVariant.NO_BORDERinstead.useMenuBarButtonElement.openSubMenu()orMenuBarButtonElement.getSubMenu()retrieve the submenu for this button, and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useMenuBarButtonElement.openSubMenu()orMenuBarItemElement.openSubMenu()to access submenus for specific buttons or itemsuseMenuBarButtonElement.openSubMenu()to open a submenuuseMenuBarButtonElement.openSubMenu()to open a submenu and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useMenuBarButtonElement.openSubMenu()orMenuBarItemElement.openSubMenu()to open a submenu and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useMenuBarItemElement.openSubMenu()orMenuBarItemElement.getSubMenu()retrieve the submenu for this item, and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useExtendedClientDetails.getBrowserTime()instead, which returns a time-zone independentInstantUseHasAriaRole.getAriaRole()insteadUseHasAriaRole.getAriaRole()insteadUseHasAriaRole.setAriaRole(String)insteadUseHasAriaRole.setAriaRole(String)insteadUseElement.scrollIntoView(ScrollIntoViewOption...)withScrollIntoViewOption.Behavior,ScrollIntoViewOption.Block, andScrollIntoViewOption.Inlineoptions insteadsince 25.3, useSplitLayout.getPrimaryComponent()and set styles on the primary component directly instead.since 25.3, useSplitLayout.getSecondaryComponent()and set styles on the secondary component directly instead.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.UseUIInternals.getWrapperElement()throughgetInternals().getWrapperElement()instead.UseUploadHandlerinsteadUseUploadHandlerinsteadUseUploadHandlerinsteadUseFileFactoryinsteadUseUploadHandlerinsteadUseUploadHandlerinsteadUseUploadHandlerinsteaduseUpload(UploadHandler)insteaduseTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.com.vaadin.flow.component.upload.Upload.addSucceededListener(ComponentEventListener<SucceededEvent>) useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useUpload.setUploadHandler(UploadHandler)insteadThis mode is deprecated and scheduled to be removed in Vaadin 26. UseValueChangeMode.ON_CHANGEinstead: 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.UseElement.scrollIntoView(ScrollIntoViewOption...)insteaduseFileIOUtils.deleteQuietly(File)instead, which also deletes directory contents and logs why a deletion failed instead of failing silentlyuseFileRouterRequestUtil.isAnonymousRoute(HttpServletRequest)to match requests to anonymous routesuseRpcInvocationStartedEvent,RpcInvocationFailedEventandRpcInvocationEndedEventon theservice event businsteadadd listeners forRpcInvocationStartedEvent,RpcInvocationFailedEventandRpcInvocationEndedEventon theservice event businstead. The callbacks of this listener are served by those events, one instance each, so an implementation that correlates the callbacks of an invocation has to do so through the thread they are delivered on rather than through the identity of the eventWebpack is not used anymore, this method is obsolete and have no replacements.used internally only for testing, to be removed without a replacement.frontendDependenciesScannercan be obtained callingOptions.getFrontendDependenciesScanner(). UseTypeScriptBootstrapModifier.modify(List, Options)insteadusePwaRegistry.getRuntimeServiceWorkerJs(VaadinRequest)instead. Without a request the app shell stylesheet URLs cannot be resolved, so those entries are left out.useSessionLockRequestedEvent,SessionLockAcquiredEventandSessionLockReleasedEventon theservice event businsteadadd listeners forSessionLockRequestedEvent,SessionLockAcquiredEventandSessionLockReleasedEventon theservice event businsteaduseUploadHandlerinsteaduseDownloadHandlerinsteaduseUploadHandlerinsteadadd listeners forRpcInvocationStartedEvent,RpcInvocationFailedEventandRpcInvocationEndedEventthroughVaadinService.getEventBus()insteadadd listeners forSessionLockRequestedEvent,SessionLockAcquiredEventandSessionLockReleasedEventthroughVaadinService.getEventBus()insteadfire aUIInitEventthroughVaadinService.getEventBus()insteadThe name refers to WebJars, which are not handled here. This method only delegates toStaticFileHandler.serveStaticResource(HttpServletRequest, HttpServletResponse), whichVaadinServlet.service(HttpServletRequest, HttpServletResponse)now calls directly, so overriding this method no longer affects request handling. OverrideVaadinServlet.createStaticFileHandler(VaadinService)to customize how static resources are served.the GWT client engine this folder held has been removed, the client is served as part of the application bundle and nothing writes to or serves this path any moreuseAbstractSharedSignal.fromJson(JsonNode, JavaType)instead, which also retains the type arguments of a parameterized type such asSet<String>useAbstractSharedSignal.nodeValue(Node, JavaType)instead, which also retains the type arguments of a parameterized type such asSet<String>useSharedListSignal(SignalTree, Id, CommandValidator, JavaType)instead, which also retains the type arguments of a parameterized element type such asSet<String>useSharedMapSignal(SignalTree, Id, CommandValidator, JavaType)instead, which also retains the type arguments of a parameterized element type such asSet<String>useSharedValueSignal(SignalTree, Id, CommandValidator, JavaType)instead, which also retains the type arguments of a parameterized value type such asSet<String>AntPathRequestMatcheris deprecated and marked for removal. This method is deprecated without direct replacement; usePathPatternRequestMatcherinstead.useRequestUtil.isAnonymousHillaRoute(HttpServletRequest)to match requests to Hilla views that do not require authenticationAntPathRequestMatcheris deprecated and marked for removal. This method is deprecated without direct replacement; usePathPatternRequestMatcherinstead.usehttp.with(new VaadinStatelessSecurityConfigurer(), customizer)instead.ASecurityContextHolderStrategyimplementation is now automatically provided bySpringSecurityAutoConfigurationand it is no more necessary to import this configuration class, which is now no-op. The default strategy implementation isVaadinAwareSecurityContextHolderStrategyand can be overridden by providing a custom bean.base url will not be translated to the theme url anymorebase url will not be translated to the theme url anymoreNo translation of the url will be done in 25UseColorSchemeannotation insteaduse the standardizedNonNullinsteaduse the standardizedNullableinsteadsince 25.3, for removal; useAssertions.assertEquals(Object, Object)instead.TestBenchElementimplementsObject.equals(Object), so wrapped and unwrapped elements are compared correctly without unwrapping them first. This method also hides a statically importedassertEqualsin subclasses, which is another reason to useAssertionsdirectly.UseElementQuery.single()for more reliable tests that assert exactly one matching element, or useElementQuery.get(int)with an explicit index if selecting from multiple elements is intentional.UseElementQuery.waitForSingle()for more reliable tests that assert exactly one matching element exists.UseElementQuery.waitForSingle(long)for more reliable tests that assert exactly one matching element exists.
-
Deprecated InterfacesInterfaceDescriptionsince 25.1, for removal in 26.Polymer template support is deprecated - we recommend you to use
LitTemplateinstead. Read more details from the Vaadin blog.Polymer template support is deprecated - we recommend you to useLitTemplateinstead. Read more details from the Vaadin blog.UseUploadHandlerinsteadUseFileFactoryinsteadadd listeners forRpcInvocationStartedEvent,RpcInvocationFailedEventandRpcInvocationEndedEventon theservice event businstead. The callbacks of this listener are served by those events, one instance each, so an implementation that correlates the callbacks of an invocation has to do so through the thread they are delivered on rather than through the identity of the eventadd listeners forSessionLockRequestedEvent,SessionLockAcquiredEventandSessionLockReleasedEventon theservice event businsteaduseUploadHandlerinstead
-
Deprecated ClassesClassDescriptionCollaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead of opening topic connections.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Collaboration Kit is superseded by Vaadin Signals. Deprecated as of Vaadin 25.3 and to be removed in Vaadin 26.0. Use shared signals instead.Board is deprecated and will be removed in Vaadin 26. Consider using Dashboard as an alternative.Board Row is deprecated and will be removed in Vaadin 26. Consider using Dashboard as an alternative.Use
ContextMenuElementinstead.Deprecated without replacement.OverrideGrid.createDataCommunicator()instead. This class and the constructors that accept it will be removed in Vaadin 26.To customize array updates, overrideGrid.createDefaultArrayUpdater()and return aGridArrayUpdaterwhosestartUpdatemethod returns a customArrayUpdater.Updateimplementation. This class will be made private in Vaadin 26.since 25.3, scheduled for removal in Vaadin 26. UseTableinstead. It does not extendHtmlContainer, so it has no genericadd(Component)and cannot be given children the HTML specification does not allow inside a<table>; it keeps the caption, column groups and sections in the order the specification requires whatever order they are added in; and it carries a good deal more API, including<colgroup>and<col>support, row and cell factories that setscope,colspanandrowspan, and binding a section's rows to a signal.since 25.3, scheduled for removal in Vaadin 26. UseTableBodyinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26. UseTableCaptioninstead, the equivalent in theTablecomponent family.since 25.3, scheduled for removal in Vaadin 26. UseTableDataCellinstead, the equivalent in theTablecomponent family.since 25.3, scheduled for removal in Vaadin 26. UseTableFootinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26. UseTableHeadinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26. UseTableHeaderCellinstead, the equivalent in theTablecomponent family.since 25.3, scheduled for removal in Vaadin 26. UseTableRowinstead, which cannot be given children the HTML specification does not allow inside this element.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableBodyElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableCaptionElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableDataCellElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableFootElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableHeaderCellElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableHeadElementinstead.since 25.3, scheduled for removal in Vaadin 26 together with the component it matches. UseTableRowElementinstead.UseElement.scrollIntoView(ScrollIntoViewOption...)withScrollIntoViewOption.Behavior,ScrollIntoViewOption.Block, andScrollIntoViewOption.Inlineoptions insteadUseUploadHandlerinsteadUseUploadHandlerinsteadUseUploadHandlerinsteadUseUploadHandlerinsteadUseUploadHandlerinsteadUseBrowserLiveReloadAccessorinsteadPolymer template support is deprecated - we recommend you to useLitTemplateinstead. Read more details from the Vaadin blog.useRpcInvocationStartedEvent,RpcInvocationFailedEventandRpcInvocationEndedEventon theservice event businsteaduseSessionLockRequestedEvent,SessionLockAcquiredEventandSessionLockReleasedEventon theservice event businsteaduseUploadHandlerinsteaduseDownloadHandlerinsteadFor browser information users should parse the user-agent using a parsing library like ua-parser/uap-javaASecurityContextHolderStrategyimplementation is now automatically provided bySpringSecurityAutoConfigurationand it is no more necessary to import this configuration class, which is now no-op. The default strategy implementation isVaadinAwareSecurityContextHolderStrategyand can be overridden by providing a custom bean.
-
Deprecated Exception ClassesException ClassDescription
-
Deprecated Annotation InterfacesAnnotation InterfaceDescriptionAs of Vaadin 25, this annotation is deprecated together with
Theme, since the theming system has been reworked and no theme is applied to the application unless it is explicitly requested. OmittingThemehas the same effect as using this annotation, so it can simply be removed. Styles are now loaded withStyleSheetfrom public static resources locations orCssImportfrom asrc/main/frontend/folder, together with mechanisms native to HTML, CSS and React (e.g.@import url("morestyles.css")in CSS).As of Vaadin 25, this annotation is deprecated. The theming system has been reworked to useStyleSheetto load one or more stylesheets from public static resources locations orCssImportto load one or more stylesheets from asrc/main/frontend/folder and use mechanisms native to HTML, CSS and React (e.g.@import url("morestyles.css")in CSS).use the standardizedNonNullinsteaduse the standardizedNullableinstead
-
Deprecated FieldsFieldDescriptionUse
UIInternals.getWrapperElement()throughgetInternals().getWrapperElement()instead.useInitParameters.URL_SAFE_SCHEMESinsteadthe GWT client engine this folder held has been removed, the client is served as part of the application bundle and nothing writes to or serves this path any more
-
Deprecated MethodsMethodDescriptionAs of 25.0, replaced by
VaadinHotswapper.onClassesChange(HotswapClassEvent). Please consider moving your implementation to that method.As of 25.0, replaced byVaadinHotswapper.onClassesChange(HotswapClassSessionEvent). Please consider moving your implementation to that method.since 1.1, for removal in 26.0; useBaseBrowserlessTest.find(Class)instead.since 1.1, for removal in 26.0; useBaseBrowserlessTest.find(Class, Component)instead.since 1.1, for removal in 26.0; useBaseBrowserlessTest.findInView(Class)instead.since 25.3, declare the services withBrowserlessTestConfig.lookupServices()or by overridingBaseBrowserlessTest.testConfiguration()instead. Overrides of this method are still honored.UseComponentQuery.single()for more reliable tests that assert exactly one matching component, or useComponentQuery.atIndex(int)with an explicit index if selecting from multiple components is intentional.useComponentQuery.withoutTheme(ThemeVariant)with the component's typed variant enum where possible.useComponentQuery.withTheme(ThemeVariant)with the component's typed variant enum where possible ? it autocompletes in the IDE and turns typos into compile errors. This raw-string overload remains for callers that need to filter on a theme not surfaced through aThemeVariantenum.useHasThemeFilter.withoutTheme(ThemeVariant)with the component's typed variant enum where possible.useHasThemeFilter.withTheme(ThemeVariant)with the component's typed variant enum where possible. This raw-string overload remains for themes not surfaced through aThemeVariantenum.This operation, along withCollaborationBinder.setBean(Object), is not supported by the collaboration binder. Instead ofCollaborationBinder.setBean(Object), you can provide the bean for populating the fields usingCollaborationBinder.setTopic(java.lang.String, com.vaadin.flow.function.SerializableSupplier<BEAN>), and write the values back to the bean usingBinder.writeBean(BEAN).This operation is not supported by the collaboration binder. You can instead provide the bean for populating the fields usingCollaborationBinder.setTopic(java.lang.String, com.vaadin.flow.function.SerializableSupplier<BEAN>)to avoid overriding currently edited values. If you explicitly want to reset the field values for every user currently editing the fields, you can useCollaborationBinder.reset(BEAN).This operation is not supported by the collaboration binder. You can instead provide the bean for populating the fields usingCollaborationBinder.setTopic(java.lang.String, com.vaadin.flow.function.SerializableSupplier<BEAN>), and write the values back to the bean usingBinder.writeBean(BEAN).UseAvatar.setImageHandler(DownloadHandler)insteadUseHasAriaRole.getAriaRole()instead.UseHasAriaRole.setAriaRole(String)instead.UseAxis.setExtremes(Instant, Instant)instead.UseAxis.setExtremes(Instant, Instant, boolean)instead.UseAxis.setExtremes(Instant, Instant, boolean, boolean)instead.UseChartModel.getZooming()instead. The zooming configuration provides more comprehensive zoom options including mouse wheel support.UseChartModel.setZooming(Zooming)instead. The zooming configuration provides more comprehensive zoom options including mouse wheel support.UseStyle#setLineHeight(String)instead.usePlotOptionsOrganization.getLink().Link.setColor(Color)instead.usePlotOptionsOrganization.getLink().Link.setRadius(Number)instead.UsePlotOptionsTreemap.setAllowTraversingTree(Boolean)instead.UsePlotOptionsTreemap.setAllowTraversingTree(Boolean)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.This property is deprecated and should not be used in new code. UseTime.setTimezone(String)instead.does not work so don't useuseComponentUtil.resolveOrGenerateIdLater(Element, Component, String, SerializableSupplier, SerializableConsumer)instead. Without a getter, a value set after this call is overwritten when the resolution runs, and the target of a superseded resolution is still assigned a generated id. In addition, the pending resolution is stored in the state tree, or as an attach listener whilesourceElementis detached, so a consumer that is not serializable makes the session fail to serialize.UseContextMenuElement.getMenuItem(String)instead.UseContextMenuElement.getMenuItems()instead.This method should not be used outside.Create a new instance and set only the properties to customize. Unset properties fall back to the component's default texts.Pre v25.0, this method returned either the editor overlay, when the editor was displayed as a dialog, or the Crud itself, when the editor was displayed inline. Since v25.0, the overlay is not accessible as a separate element anymore, and, regardless whether the editor is displayed as a dialog or inline, all editor-related controls can be queried through the Crud element itself. To specifically access the editor fields, useCrudElement.getForm()instead. To access the editor buttons, useCrudElement.getEditorSaveButton(),CrudElement.getEditorCancelButton(), andCrudElement.getEditorDeleteButton().This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.Since v24.8The generated 'dom-module' relies on the legacy Polymer styling mechanism. Component styling can be done entirely with normal "light DOM" CSS: drop this attribute and import the CSS file given asCssImport.value()as plain CSS.The generated 'custom-style' relies on the legacy Polymer styling mechanism. Component styling can be done entirely with normal "light DOM" CSS: drop this attribute and put the rules that were pulled in from the included module into the CSS file given asCssImport.value().Component styling can be done entirely with normal "light DOM" CSS.This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.UseHasAriaRole.getAriaRole()insteadUseHasAriaRole.getAriaRole()insteaduseDialog.isAutofocus()insteaduseDialog.getModality()insteaduseDialog.setAutofocus(boolean)insteaduseDialog.setModality(ModalityMode)insteadUseHasAriaRole.setAriaRole(String)insteadUseHasAriaRole.setAriaRole(String)insteadThis method should not be used outside.Grid.getDefaultColumnFactory()should be used instead.internal method, will be removed without a replacement.UseAbstractColumn.getFooterText()orAbstractColumn.getFooterComponent()directlyUseAbstractColumn.getHeaderText()orAbstractColumn.getHeaderComponent()UseAbstractColumn.getFooterText()orAbstractColumn.getFooterComponent()directlyUseAbstractColumn.getHeaderText()orAbstractColumn.getHeaderComponent()since 25.0, and will be removed in Vaadin 26. UseTreeGridElement.scrollToRowByFlatIndex(int)instead.since 25.0. Please update your code to useTreeGridElement.scrollToRowByPath(int...)with a single index where you want to scroll to a root-level row. In Vaadin 26, this deprecated method will be changed to accept a flat index and behave asTreeGridElement.scrollToRowByFlatIndex(int), which may break tests if not updated.since 25.0 and will be removed in Vaadin 26. UseTreeGridElement.scrollToRowByPath(int...)with a single index instead.since 25.0 and will be removed in Vaadin 26. UseTreeGridElement.scrollToRowByPath(int...)instead.Useorinvalid reference
Grid.Column#getFooterText()directlyinvalid reference
Grid.Column#getFooterComponent()Useorinvalid reference
Grid.Column#getHeaderText()invalid reference
Grid.Column#getHeaderComponent()useAnchor.setHref(DownloadHandler)insteaduseHtmlObject.setData(DownloadHandler)insteaduseIFrame.setSrc(DownloadHandler)insteaduseImage.setSrc(DownloadHandler)insteadUseSvgIcon.setSrc(DownloadHandler)insteadUseSvgIcon.setSrc(DownloadHandler, String)insteadThis method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.This method is not supported and will throw an exception when called.Create a new instance and set only the properties to customize. Unset properties fall back to the component's default texts.useIcon.getImg()insteaduseIcon.Options.setImg(DownloadHandler)insteaduseMapBase.addClickListener(ComponentEventListener)insteadUseMenuItemBase.setTooltipText(String)instead. This method is scheduled for removal in Vaadin 26.useMenuBarButtonElement.openSubMenu()orMenuBarButtonElement.getSubMenu()retrieve the submenu for this button, and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useMenuBarButtonElement.openSubMenu()orMenuBarItemElement.openSubMenu()to access submenus for specific buttons or itemsuseMenuBarButtonElement.openSubMenu()to open a submenuuseMenuBarButtonElement.openSubMenu()to open a submenu and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useMenuBarButtonElement.openSubMenu()orMenuBarItemElement.openSubMenu()to open a submenu and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useMenuBarItemElement.openSubMenu()orMenuBarItemElement.getSubMenu()retrieve the submenu for this item, and then useMenuBarSubMenuElement.getMenuItems()to retrieve the items.useExtendedClientDetails.getBrowserTime()instead, which returns a time-zone independentInstantuse feature detection instead of platform detection, or inspectExtendedClientDetails.getNavigatorPlatform()directlyuse feature detection instead of platform detection, or inspectExtendedClientDetails.getNavigatorPlatform()directlyUsePage.executeJs(String, Object...)instead. This method exists only for binary compatibility.UsePage.getExtendedClientDetails()to get the cached details, orExtendedClientDetails.refresh(SerializableConsumer)to refresh the cached values.UseHasAriaRole.getAriaRole()insteadUseHasAriaRole.getAriaRole()insteadUseHasAriaRole.setAriaRole(String)insteadUseHasAriaRole.setAriaRole(String)insteadsince v24 the RichTextEditor uses the HTML value by default. UseRichTextEditor.getValue()instead.since 24.5, useValidationUtil.validateMaxConstraint(String, Comparable, Comparable)instead.since 24.5, useValidationUtil.validateRequiredConstraint(String, boolean, Object, Object)instead.since 24.5, useValidationUtil.validateMinConstraint(String, Comparable, Comparable)instead.since 25.3, useSplitLayout.getPrimaryComponent()and set styles on the primary component directly instead.since 25.3, useSplitLayout.getSecondaryComponent()and set styles on the secondary component directly instead.since 24.0, useTabs.add(Tab...)instead.since 24.0, useTabs.addTabAsFirst(Tab)instead.since 24.0, useTabs.addTabAtIndex(int, Tab)instead.since 24.0, useTabs.getTabAt(int)instead.since 24.5, useTabs.getTabCount()instead.since 24.0, useTabs.getIndexOf(Tab)instead.since 25.3, useTabs.getIndexOf(Tab)instead.since 24.0, useTabs.remove(Tab...)instead.since 24.0, useTabs.replace(Tab, Tab)instead.Since v24.8not supportednot supportednot supportedUseorinvalid reference
Grid.Column#getFooterText()directlyinvalid reference
Grid.Column#getFooterComponent()Useorinvalid reference
Grid.Column#getHeaderText()invalid reference
Grid.Column#getHeaderComponent()useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.com.vaadin.flow.component.upload.Upload.addSucceededListener(ComponentEventListener<SucceededEvent>) useTransferProgressListenerwithUploadHandlerimplementing theTransferProgressAwareHandlerinterface.since 24.4. UseUpload.fireUpdateProgress(long, long, String)UseUpload.getAcceptedMimeTypes()andUpload.getAcceptedFileExtensions()instead.UseUpload.setAcceptedMimeTypes(String...)andUpload.setAcceptedFileExtensions(String...)instead for separate control of MIME types and file extensions with server-side validation.useUpload.setUploadHandler(UploadHandler)insteadsince 24.9 and will be removed in Vaadin 26. UseDataCommunicator.computeViewportRange(int, int)instead.since 24.9 and will be removed in Vaadin 26. UseDataCommunicator.setViewportRange(int, int)instead.This method will change its behavior in Vaadin 26. It will create aTreeDataProviderwithHierarchicalDataProvider.HierarchyFormat.FLATTENED, which may affect TreeGrid methods whose behavior depends on the hierarchy format, such asscrollToIndex. To preserve the current behavior, create aTreeDataProvidermanually withHierarchicalDataProvider.HierarchyFormat.NESTEDand set it viaHasHierarchicalDataProvider.setDataProvider(HierarchicalDataProvider)instead of using this shorthand method.This method will change its behavior in Vaadin 26. It will create aTreeDataProviderwithHierarchicalDataProvider.HierarchyFormat.FLATTENED, which may affect TreeGrid methods whose behavior depends on the hierarchy format, such asscrollToIndex. To preserve the current behavior, create aTreeDataProvidermanually withHierarchicalDataProvider.HierarchyFormat.NESTEDand set it viaHasHierarchicalDataProvider.setDataProvider(HierarchicalDataProvider)instead of using this shorthand method.This method will change its behavior in Vaadin 26. It will create aTreeDataProviderwithHierarchicalDataProvider.HierarchyFormat.FLATTENED, which may affect TreeGrid methods whose behavior depends on the hierarchy format, such asscrollToIndex. To preserve the current behavior, create aTreeDataProvidermanually withHierarchicalDataProvider.HierarchyFormat.NESTEDand set it viaHasHierarchicalDataProvider.setDataProvider(HierarchicalDataProvider)instead of using this shorthand method.UseElement.callJsFunction(String, Object...)instead. This method exists only for binary compatibility.UseElement.executeJs(String, Object...)instead. This method exists only for binary compatibility.UseElement.scrollIntoView(ScrollIntoViewOption...)insteaduseFileIOUtils.deleteQuietly(File)instead, which also deletes directory contents and logs why a deletion failed instead of failing silentlyuseFileRouterRequestUtil.isAnonymousRoute(HttpServletRequest)to match requests to anonymous routesuseUrlUtil.validateUrl(Component, String, String, String, SerializableRunnable)instead, as it uses the configuration of the application that the component belongs to instead of relying on the current thread having a locked sessionWebpack is not used anymore, this method is obsolete and have no replacements.used internally only for testing, to be removed without a replacement.frontendDependenciesScannercan be obtained callingOptions.getFrontendDependenciesScanner(). UseTypeScriptBootstrapModifier.modify(List, Options)insteadusePwaRegistry.getRuntimeServiceWorkerJs(VaadinRequest)instead. Without a request the app shell stylesheet URLs cannot be resolved, so those entries are left out.add listeners forRpcInvocationStartedEvent,RpcInvocationFailedEventandRpcInvocationEndedEventthroughVaadinService.getEventBus()insteadadd listeners forSessionLockRequestedEvent,SessionLockAcquiredEventandSessionLockReleasedEventthroughVaadinService.getEventBus()insteadfire aUIInitEventthroughVaadinService.getEventBus()insteadThe name refers to WebJars, which are not handled here. This method only delegates toStaticFileHandler.serveStaticResource(HttpServletRequest, HttpServletResponse), whichVaadinServlet.service(HttpServletRequest, HttpServletResponse)now calls directly, so overriding this method no longer affects request handling. OverrideVaadinServlet.createStaticFileHandler(VaadinService)to customize how static resources are served.useWebBrowser.getUserAgent()method to get user-agent stringuse a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()use a parsing library like ua-parser/uap-java to parse the user agent fromWebBrowser.getUserAgent()useAbstractSharedSignal.fromJson(JsonNode, JavaType)instead, which also retains the type arguments of a parameterized type such asSet<String>useAbstractSharedSignal.nodeValue(Node, JavaType)instead, which also retains the type arguments of a parameterized type such asSet<String>AntPathRequestMatcheris deprecated and marked for removal. This method is deprecated without direct replacement; usePathPatternRequestMatcherinstead.useRequestUtil.isAnonymousHillaRoute(HttpServletRequest)to match requests to Hilla views that do not require authenticationAntPathRequestMatcheris deprecated and marked for removal. This method is deprecated without direct replacement; usePathPatternRequestMatcherinstead.usehttp.with(new VaadinStatelessSecurityConfigurer(), customizer)instead.base url will not be translated to the theme url anymorebase url will not be translated to the theme url anymoreNo translation of the url will be done in 25UseColorSchemeannotation insteadsince 25.3, for removal; useAssertions.assertEquals(Object, Object)instead.TestBenchElementimplementsObject.equals(Object), so wrapped and unwrapped elements are compared correctly without unwrapping them first. This method also hides a statically importedassertEqualsin subclasses, which is another reason to useAssertionsdirectly.UseElementQuery.single()for more reliable tests that assert exactly one matching element, or useElementQuery.get(int)with an explicit index if selecting from multiple elements is intentional.UseElementQuery.waitForSingle()for more reliable tests that assert exactly one matching element exists.UseElementQuery.waitForSingle(long)for more reliable tests that assert exactly one matching element exists.This method is deprecated. Use$instead to find elements in the shadow root.
-
Deprecated ConstructorsConstructorDescriptionsince 25.2, for removal. Use
DragEndEvent(Component, boolean, String, int, int)which also captures the pointer's client coordinates. When this constructor is used,AbstractDnDEvent.getClientX()andAbstractDnDEvent.getClientY()return0.since 25.2, for removal. UseDragStartEvent(Component, boolean, int, int, int, int)which also captures the pointer's client and offset coordinates. When this constructor is used,AbstractDnDEvent.getClientX(),AbstractDnDEvent.getClientY(),DragStartEvent.getOffsetX()andDragStartEvent.getOffsetY()return0.since 25.2, for removal. UseDropEvent(Component, boolean, String, int, int, int, int)which also captures the pointer's client and drop-target offset coordinates. When this constructor is used,AbstractDnDEvent.getClientX(),AbstractDnDEvent.getClientY(),DropEvent.getOffsetX()andDropEvent.getOffsetY()return0.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.useAnchor(DownloadHandler, String)insteaduseHtmlObject(DownloadHandler)insteaduseHtmlObject(DownloadHandler,Param...)insteaduseHtmlObject(DownloadHandler,String)insteaduseHtmlObject(DownloadHandler,String, Param...)insteaduseImage(DownloadHandler, String)insteadUseSvgIcon(DownloadHandler)insteadUseSvgIcon(DownloadHandler, String)insteadOverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.OverrideGrid.createDataCommunicator()instead. This constructor will be removed in Vaadin 26.since 24.4. UseFileRejectedEvent(Upload, String, String)since 24.4. UseProgressUpdateEvent(Upload, long, long, String)useUpload(UploadHandler)insteadthis constructor currently defaults toHierarchicalDataProvider.HierarchyFormat.NESTED, but starting from Vaadin 26 it will default toHierarchicalDataProvider.HierarchyFormat.FLATTENEDinstead. This may affect TreeGrid methods whose behavior depends on the hierarchy format, such asscrollToIndex. Switch toTreeDataProvider(TreeData, HierarchyFormat)and passHierarchicalDataProvider.HierarchyFormat.NESTEDexplicitly to preserve the current behavior.useFrontendTools(FrontendToolsSettings)instead, as it simplifies configuring the frontend tools and gives the default values to configuration parameters.useSharedListSignal(SignalTree, Id, CommandValidator, JavaType)instead, which also retains the type arguments of a parameterized element type such asSet<String>useSharedMapSignal(SignalTree, Id, CommandValidator, JavaType)instead, which also retains the type arguments of a parameterized element type such asSet<String>useSharedValueSignal(SignalTree, Id, CommandValidator, JavaType)instead, which also retains the type arguments of a parameterized value type such asSet<String>
-
Deprecated Enum ConstantsEnum ConstantDescriptionUse
AvatarGroupVariant.REVERSEinstead.UseButtonVariant.ERRORinstead.UseButtonVariant.PRIMARYinstead.UseButtonVariant.TERTIARYinstead.UseCardVariant.COVER_MEDIAinstead.UseCardVariant.ELEVATEDinstead.UseCardVariant.HORIZONTALinstead.UseCardVariant.OUTLINEDinstead.UseCardVariant.STRETCH_MEDIAinstead.UseCheckboxGroupVariant.HELPER_ABOVEinstead.This variant is not working and will be removed in the next major.This variant is not working and will be removed in the next major.This variant is not working and will be removed in the next major.UseComboBoxVariant.ALIGN_CENTERinstead.UseComboBoxVariant.ALIGN_ENDinstead.UseComboBoxVariant.ALIGN_LEFTinstead.UseComboBoxVariant.ALIGN_RIGHTinstead.UseComboBoxVariant.ALIGN_STARTinstead.UseComboBoxVariant.HELPER_ABOVEinstead.UseMultiSelectComboBoxVariant.ALIGN_CENTERinstead.UseMultiSelectComboBoxVariant.ALIGN_ENDinstead.UseMultiSelectComboBoxVariant.ALIGN_LEFTinstead.UseMultiSelectComboBoxVariant.ALIGN_RIGHTinstead.UseMultiSelectComboBoxVariant.ALIGN_STARTinstead.UseMultiSelectComboBoxVariant.HELPER_ABOVEinstead.UseCrudVariant.NO_BORDERinstead.UseCustomFieldVariant.HELPER_ABOVEinstead.UseDatePickerVariant.ALIGN_CENTERinstead.UseDatePickerVariant.ALIGN_ENDinstead.UseDatePickerVariant.ALIGN_LEFTinstead.UseDatePickerVariant.ALIGN_RIGHTinstead.UseDatePickerVariant.ALIGN_STARTinstead.UseDatePickerVariant.HELPER_ABOVEinstead.UseDateTimePickerVariant.ALIGN_CENTERinstead.UseDateTimePickerVariant.ALIGN_ENDinstead.UseDateTimePickerVariant.ALIGN_LEFTinstead.UseDateTimePickerVariant.ALIGN_RIGHTinstead.UseDateTimePickerVariant.ALIGN_STARTinstead.UseDateTimePickerVariant.HELPER_ABOVEinstead.UseDetailsVariant.FILLEDinstead.UseDetailsVariant.REVERSEinstead.UseDetailsVariant.SMALLinstead.UseDialogVariant.NO_PADDINGinstead.UseGridVariant.COLUMN_BORDERSinstead.UseGridVariant.NO_BORDERinstead.UseGridVariant.NO_ROW_BORDERSinstead.UseGridVariant.ROW_STRIPESinstead.UseGridVariant.WRAP_CELL_CONTENTinstead.UseGridProVariant.COLUMN_BORDERSinstead.UseGridProVariant.HIGHLIGHT_EDITABLE_CELLSinstead.UseGridProVariant.HIGHLIGHT_READ_ONLY_CELLSinstead.UseGridProVariant.NO_BORDERinstead.UseGridProVariant.NO_ROW_BORDERSinstead.UseGridProVariant.ROW_STRIPESinstead.UseGridProVariant.WRAP_CELL_CONTENTinstead.UseVaadinIcon.CALCinstead.UseVaadinIcon.DOCKinstead.UseVaadinIcon.CONTRASTinstead.Use a replacement from simpleicons.org.UseVaadinIcon.ALTinstead.UseVaadinIcon.ARROW_CIRCLE_DOWNinstead.UseVaadinIcon.ARROW_CIRCLE_LEFTinstead.UseVaadinIcon.ARROW_CIRCLE_RIGHTinstead.UseVaadinIcon.ARROW_CIRCLE_UPinstead.UseVaadinIcon.BACKSPACEinstead.UseVaadinIcon.BELLinstead.UseVaadinIcon.BELL_SLASHinstead.UseVaadinIcon.BOOKMARKinstead.UseVaadinIcon.BUGinstead.UseVaadinIcon.BUILDINGinstead.UseVaadinIcon.CALENDARinstead.UseVaadinIcon.CARET_SQUARE_DOWNinstead.UseVaadinIcon.CARET_SQUARE_LEFTinstead.UseVaadinIcon.CARET_SQUARE_RIGHTinstead.UseVaadinIcon.CARET_SQUARE_UPinstead.UseVaadinIcon.CARTinstead.UseVaadinIcon.LINE_CHARTinstead.UseVaadinIcon.CHECK_CIRCLEinstead.UseVaadinIcon.CHECK_SQUAREinstead.UseVaadinIcon.CHEVRON_CIRCLE_DOWNinstead.UseVaadinIcon.CHEVRON_CIRCLE_LEFTinstead.UseVaadinIcon.CHEVRON_CIRCLE_RIGHTinstead.UseVaadinIcon.CHEVRON_CIRCLE_UPinstead.UseVaadinIcon.CIRCLEinstead.UseVaadinIcon.CLOSEinstead.UseVaadinIcon.CLOSE_CIRCLEinstead.UseVaadinIcon.CLOSEinstead.UseVaadinIcon.CLOUD_DOWNLOADinstead.UseVaadinIcon.CLOUDinstead.UseVaadinIcon.CLOUD_UPLOADinstead.UseVaadinIcon.COGinstead.UseVaadinIcon.COMMENT_ELLIPSISinstead.UseVaadinIcon.COMMENTinstead.UseVaadinIcon.COMMENTSinstead.UseVaadinIcon.CONNECTinstead.UseVaadinIcon.COPYinstead.UseVaadinIcon.CODEinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.CURSORinstead.UseVaadinIcon.OUTDENTinstead.UseVaadinIcon.BACKSPACEinstead.UseVaadinIcon.BACKSPACEinstead.UseVaadinIcon.DIAMONDinstead.UseVaadinIcon.ELLIPSIS_CIRCLEinstead.UseVaadinIcon.ELLIPSIS_Hinstead.UseVaadinIcon.ELLIPSIS_Vinstead.UseVaadinIcon.ENVELOPEinstead.UseVaadinIcon.ENVELOPE_OPENinstead.UseVaadinIcon.ENVELOPESinstead.UseVaadinIcon.EXCLAMATION_CIRCLEinstead.UseVaadinIcon.EXITinstead.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.UseVaadinIcon.FILEinstead.UseVaadinIcon.FILE_TEXTinstead.UseVaadinIcon.FILE_TREEinstead.UseVaadinIcon.FILE_TREEinstead.UseVaadinIcon.FLAGinstead.UseVaadinIcon.FOLDERinstead.UseVaadinIcon.FOLDER_OPENinstead.UseVaadinIcon.FROWNinstead.UseVaadinIcon.FILTERinstead.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.UseVaadinIcon.GRIDinstead.UseVaadinIcon.GRID_BIGinstead.UseVaadinIcon.GRIDinstead.UseVaadinIcon.GRIDinstead.UseVaadinIcon.PERSONinstead.UseVaadinIcon.HARDDRIVEinstead.UseVaadinIcon.HEARTinstead.UseVaadinIcon.HOMEinstead.UseVaadinIcon.INFO_CIRCLEinstead.UseVaadinIcon.KEYBOARDinstead.UseVaadinIcon.LEVEL_DOWNinstead.UseVaadinIcon.LEVEL_LEFTinstead.UseVaadinIcon.LEVEL_RIGHTinstead.UseVaadinIcon.LEVEL_UPinstead.UseVaadinIcon.COMPASSinstead.UseVaadinIcon.COMPASSinstead.UseVaadinIcon.MEHinstead.UseVaadinIcon.MINUS_CIRCLEinstead.UseVaadinIcon.MINUS_SQUAREinstead.UseVaadinIcon.MOBILEinstead.UseVaadinIcon.MOBILEinstead.UseVaadinIcon.MOONinstead.UseVaadinIcon.SUN_RISEinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.COMMANDinstead.UseVaadinIcon.PAPERPLANEinstead.UseVaadinIcon.PHONEinstead.UseVaadinIcon.PIGGY_BANKinstead.UseVaadinIcon.PLAY_CIRCLEinstead.UseVaadinIcon.PLUS_CIRCLEinstead.UseVaadinIcon.PLUS_SQUAREinstead.UseVaadinIcon.QUESTION_CIRCLEinstead.UseVaadinIcon.BRANCHinstead.UseVaadinIcon.BRANCHinstead.UseVaadinIcon.RSSinstead.UseVaadinIcon.SCALEinstead.UseVaadinIcon.SHIFTinstead.UseVaadinIcon.SIGN_INinstead.UseVaadinIcon.SIGN_OUTinstead.UseVaadinIcon.SLIDERSinstead.UseVaadinIcon.SMILEYinstead.UseVaadinIcon.SPINNERinstead.UseVaadinIcon.SPINNERinstead.UseVaadinIcon.CUTLERYinstead.UseVaadinIcon.SQUAREinstead.UseVaadinIcon.STAR_HALFinstead.UseVaadinIcon.STAR_HALF_LEFTinstead.UseVaadinIcon.STAR_HALFinstead.UseVaadinIcon.STAR_HALF_RIGHTinstead.UseVaadinIcon.STARinstead.UseVaadinIcon.DOCTORinstead.UseVaadinIcon.FORKLIFTinstead.UseVaadinIcon.SUNinstead.UseVaadinIcon.TABinstead.UseVaadinIcon.INPUTinstead.UseVaadinIcon.FONTinstead.UseVaadinIcon.SQUAREinstead.UseVaadinIcon.THUMBS_DOWNinstead.UseVaadinIcon.THUMBS_UPinstead.UseVaadinIcon.POINTERinstead.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.Use a replacement from simpleicons.org.UseMapVariant.NO_BORDERinstead.UseMapVariant.NO_BORDERinstead.UseMenuBarVariant.ALIGN_ENDinstead.UseMenuBarVariant.PRIMARYinstead.UseMenuBarVariant.TERTIARYinstead.UseHorizontalLayoutVariant.MARGINinstead.UseHorizontalLayoutVariant.PADDINGinstead.UseHorizontalLayoutVariant.SPACINGinstead.UseHorizontalLayoutVariant.WRAPinstead.UseScrollerVariant.OVERFLOW_INDICATOR_BOTTOMinstead.UseScrollerVariant.OVERFLOW_INDICATOR_TOPinstead.UseScrollerVariant.OVERFLOW_INDICATORSinstead.UseVerticalLayoutVariant.MARGINinstead.UseVerticalLayoutVariant.PADDINGinstead.UseVerticalLayoutVariant.SPACINGinstead.UseVerticalLayoutVariant.WRAPinstead.UsePopoverVariant.ARROWinstead.UsePopoverVariant.NO_PADDINGinstead.UseRadioGroupVariant.HELPER_ABOVEinstead.UseSelectVariant.ALIGN_CENTERinstead.UseSelectVariant.ALIGN_ENDinstead.UseSelectVariant.ALIGN_LEFTinstead.UseSelectVariant.ALIGN_RIGHTinstead.UseSelectVariant.ALIGN_STARTinstead.UseSelectVariant.HELPER_ABOVEinstead.UseSplitLayoutVariant.SMALLinstead.UseTabSheetVariant.NO_PADDINGinstead.UseTabSheetVariant.TABS_HIDE_SCROLL_BUTTONSinstead.UseTabSheetVariant.TABS_SHOW_SCROLL_BUTTONSinstead.UseTabsVariant.HIDE_SCROLL_BUTTONSinstead.UseTabsVariant.SHOW_SCROLL_BUTTONSinstead.UseTextAreaVariant.ALIGN_CENTERinstead.UseTextAreaVariant.ALIGN_ENDinstead.UseTextAreaVariant.ALIGN_LEFTinstead.UseTextAreaVariant.ALIGN_RIGHTinstead.UseTextAreaVariant.ALIGN_STARTinstead.UseTextAreaVariant.HELPER_ABOVEinstead.UseTextFieldVariant.ALIGN_CENTERinstead.UseTextFieldVariant.ALIGN_ENDinstead.UseTextFieldVariant.ALIGN_LEFTinstead.UseTextFieldVariant.ALIGN_RIGHTinstead.UseTextFieldVariant.ALIGN_STARTinstead.UseTextFieldVariant.HELPER_ABOVEinstead.UseTimePickerVariant.ALIGN_CENTERinstead.UseTimePickerVariant.ALIGN_ENDinstead.UseTimePickerVariant.ALIGN_LEFTinstead.UseTimePickerVariant.ALIGN_RIGHTinstead.UseTimePickerVariant.ALIGN_STARTinstead.UseTimePickerVariant.HELPER_ABOVEinstead.UseVirtualListVariant.OVERFLOW_INDICATOR_BOTTOMinstead.UseVirtualListVariant.OVERFLOW_INDICATOR_TOPinstead.UseVirtualListVariant.OVERFLOW_INDICATORSinstead.This mode is deprecated and scheduled to be removed in Vaadin 26. UseValueChangeMode.ON_CHANGEinstead: 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 Annotation Interface ElementsAnnotation Interface ElementDescriptionThe generated 'dom-module' relies on the legacy Polymer styling mechanism. Component styling can be done entirely with normal "light DOM" CSS: drop this attribute and import the CSS file given as
CssImport.value()as plain CSS.The generated 'custom-style' relies on the legacy Polymer styling mechanism. Component styling can be done entirely with normal "light DOM" CSS: drop this attribute and put the rules that were pulled in from the included module into the CSS file given asCssImport.value().Component styling can be done entirely with normal "light DOM" CSS.UseColorSchemeannotation instead