Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Annotation Interfaces
• Fields
• Methods
• Annotation Interface Elements

Terminally Deprecated Elements

Element	Description
com.vaadin.flow.component.Component.scrollIntoView(ScrollOptions)	Use Component.scrollIntoView(ScrollIntoViewOption...) instead
com.vaadin.flow.component.HasOrderedComponents	since 25.1, for removal in 26.
com.vaadin.flow.component.ScrollOptions	Use Element.scrollIntoView(ScrollIntoViewOption...) with ScrollIntoViewOption.Behavior, ScrollIntoViewOption.Block, and ScrollIntoViewOption.Inline options instead
com.vaadin.flow.component.UI.wrapperElement	Use UIInternals.getWrapperElement() through getInternals().getWrapperElement() instead.
com.vaadin.flow.dom.Element.scrollIntoView(ScrollOptions)	Use Element.scrollIntoView(ScrollIntoViewOption...) instead
com.vaadin.flow.internal.FileIOUtils.deleteFileQuietly(File)	use FileIOUtils.deleteQuietly(File) instead, which also deletes directory contents and logs why a deletion failed instead of failing silently
com.vaadin.flow.internal.hilla.FileRouterRequestUtil.isRouteAllowed(HttpServletRequest)	use FileRouterRequestUtil.isAnonymousRoute(HttpServletRequest) to match requests to anonymous routes
com.vaadin.flow.server.StreamReceiver	use UploadHandler instead
com.vaadin.flow.server.StreamResource	use DownloadHandler instead
com.vaadin.flow.server.StreamVariable	use UploadHandler instead
com.vaadin.flow.server.VaadinServlet.serveStaticOrWebJarRequest(HttpServletRequest, HttpServletResponse)	The name refers to WebJars, which are not handled here. This method only delegates to StaticFileHandler.serveStaticResource(HttpServletRequest, HttpServletResponse), which VaadinServlet.service(HttpServletRequest, HttpServletResponse) now calls directly, so overriding this method no longer affects request handling. Override VaadinServlet.createStaticFileHandler(VaadinService) to customize how static resources are served.
com.vaadin.flow.theme.AbstractTheme.getBaseUrl()	base url will not be translated to the theme url anymore
com.vaadin.flow.theme.AbstractTheme.getThemeUrl()	base url will not be translated to the theme url anymore
com.vaadin.flow.theme.AbstractTheme.translateUrl(String)	No translation of the url will be done in 25
com.vaadin.flow.theme.Theme.variant()	Use ColorScheme annotation instead

Deprecated Interfaces

Interface	Description
com.vaadin.flow.component.HasOrderedComponents	since 25.1, for removal in 26.
com.vaadin.flow.component.template.internal.DeprecatedPolymerPublishedEventHandler	Polymer template support is deprecated - we recommend you to use LitTemplate instead. Read more details from the Vaadin blog.
com.vaadin.flow.component.template.internal.DeprecatedPolymerTemplate	Polymer template support is deprecated - we recommend you to use LitTemplate instead. Read more details from the Vaadin blog.
com.vaadin.flow.server.StreamVariable	use UploadHandler instead

Deprecated Classes

Class	Description
com.vaadin.flow.component.ScrollOptions	Use Element.scrollIntoView(ScrollIntoViewOption...) with ScrollIntoViewOption.Behavior, ScrollIntoViewOption.Block, and ScrollIntoViewOption.Inline options instead
com.vaadin.flow.internal.BrowserLiveReloadAccess	Use BrowserLiveReloadAccessor instead
com.vaadin.flow.internal.nodefeature.PolymerServerEventHandlers	Polymer template support is deprecated - we recommend you to use LitTemplate instead. Read more details from the Vaadin blog.
com.vaadin.flow.server.StreamReceiver	use UploadHandler instead
com.vaadin.flow.server.StreamResource	use DownloadHandler instead
com.vaadin.flow.shared.BrowserDetails	For browser information users should parse the user-agent using a parsing library like ua-parser/uap-java

Deprecated Annotation Interfaces

Annotation Interface	Description
com.vaadin.flow.theme.Theme	As of Vaadin 25, this annotation is deprecated. The theming system has been reworked to use StyleSheet to load one or more stylesheets from public static resources locations or CssImport to load one or more stylesheets from a src/main/frontend/ folder and use mechanisms native to HTML, CSS and React (e.g. @import url("morestyles.css") in CSS).

Deprecated Fields

Field	Description
com.vaadin.flow.component.UI.wrapperElement	Use UIInternals.getWrapperElement() through getInternals().getWrapperElement() instead.
com.vaadin.flow.server.InitParameters.URL_SAFE_SCHEMES_LEGACY	use InitParameters.URL_SAFE_SCHEMES instead

Deprecated Methods

Method	Description
com.vaadin.flow.component.Component.getTranslation(Object, Locale, Object...)	Use Component.getTranslation(Locale, String, Object...) instead
com.vaadin.flow.component.Component.getTranslation(String, Locale, Object...)	Use Component.getTranslation(Locale, String, Object...) instead
com.vaadin.flow.component.Component.scrollIntoView(ScrollOptions)	Use Component.scrollIntoView(ScrollIntoViewOption...) instead
com.vaadin.flow.component.dependency.CssImport.id()
com.vaadin.flow.component.dependency.CssImport.include()
com.vaadin.flow.component.dependency.CssImport.themeFor()	Component styling can be done entirely with normal "light DOM" CSS.
com.vaadin.flow.component.page.Page.executeJs(String, Serializable[])	Use Page.executeJs(String, Object...) instead. This method exists only for binary compatibility.
com.vaadin.flow.component.page.Page.retrieveExtendedClientDetails(Page.ExtendedClientDetailsReceiver)	Use Page.getExtendedClientDetails() to get the cached details, or ExtendedClientDetails.refresh(SerializableConsumer) to refresh the cached values.
com.vaadin.flow.dom.Element.callJsFunction(String, Serializable[])	Use Element.callJsFunction(String, Object...) instead. This method exists only for binary compatibility.
com.vaadin.flow.dom.Element.executeJs(String, Serializable[])	Use Element.executeJs(String, Object...) instead. This method exists only for binary compatibility.
com.vaadin.flow.dom.Element.scrollIntoView(ScrollOptions)	Use Element.scrollIntoView(ScrollIntoViewOption...) instead
com.vaadin.flow.internal.FileIOUtils.deleteFileQuietly(File)	use FileIOUtils.deleteQuietly(File) instead, which also deletes directory contents and logs why a deletion failed instead of failing silently
com.vaadin.flow.internal.hilla.FileRouterRequestUtil.isRouteAllowed(HttpServletRequest)	use FileRouterRequestUtil.isAnonymousRoute(HttpServletRequest) to match requests to anonymous routes
com.vaadin.flow.server.VaadinServlet.serveStaticOrWebJarRequest(HttpServletRequest, HttpServletResponse)	The name refers to WebJars, which are not handled here. This method only delegates to StaticFileHandler.serveStaticResource(HttpServletRequest, HttpServletResponse), which VaadinServlet.service(HttpServletRequest, HttpServletResponse) now calls directly, so overriding this method no longer affects request handling. Override VaadinServlet.createStaticFileHandler(VaadinService) to customize how static resources are served.
com.vaadin.flow.server.WebBrowser.getBrowserApplication()	use WebBrowser.getUserAgent() method to get user-agent string
com.vaadin.flow.server.WebBrowser.getBrowserMajorVersion()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.getBrowserMinorVersion()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isAndroid()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isChrome()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isChromeOS()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isEdge()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isFirefox()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isIE()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isLinux()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isMacOSX()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isOpera()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isSafari()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isWindows()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.server.WebBrowser.isWindowsPhone()	use a parsing library like ua-parser/uap-java to parse the user agent from WebBrowser.getUserAgent()
com.vaadin.flow.theme.AbstractTheme.getBaseUrl()	base url will not be translated to the theme url anymore
com.vaadin.flow.theme.AbstractTheme.getThemeUrl()	base url will not be translated to the theme url anymore
com.vaadin.flow.theme.AbstractTheme.translateUrl(String)	No translation of the url will be done in 25
com.vaadin.flow.theme.Theme.variant()	Use ColorScheme annotation instead

Deprecated Annotation Interface Elements

Annotation Interface Element	Description
com.vaadin.flow.component.dependency.CssImport.id()
com.vaadin.flow.component.dependency.CssImport.include()
com.vaadin.flow.component.dependency.CssImport.themeFor()	Component styling can be done entirely with normal "light DOM" CSS.
com.vaadin.flow.theme.Theme.variant()	Use ColorScheme annotation instead