com.vaadin.flow.component.dependency

Annotation Type HtmlImport

Deprecated.

Bower WebJars will be deprecated soon, so this functionality will also be deprecated and eventually removed from Vaadin. Developers should discontinue using compatibility mode and HtmlImports/WebJars in favor of JsModules. More info about deprecation here.

@Retention(value=RUNTIME)
 @Target(value=TYPE)
 @Documented
 @Repeatable(value=HtmlImport.Container.class)
 @Deprecated
public @interface HtmlImport

Defines HTML dependencies on a Component class. For adding multiple HTML files for a single component, you can use this annotation multiple times.

It is guaranteed that dependencies will be loaded only once.

NOTE: while this annotation is not inherited using the @Inherited annotation, the annotations of the possible parent components or implemented interfaces are read when sending the dependencies to the browser.

NOTE: this annotation is only useful in compatibility mode and it is ignored in normal mode. In order to use a Polymer template inside a component in Vaadin 14+, JsModule annotation should be used. And to use a css file, CssImport should be used. If you want to be able to use your component in both compatibility mode and normal mode of Vaadin 14+ you need to have @HtmlImport along with @JsModule and/or @CssImport annotations. See Vaadin 14 Migration Guide for more information on how to migrate templates from Polymer 2 to Polymer 3.

Since:

1.0

Author:

Vaadin Ltd

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
String	value Deprecated. HTML file URL to load before using the annotated Component in the browser.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
LoadMode	loadMode Deprecated. Determines the dependency load mode.

Element Detail

value

public abstract String value

Deprecated.

HTML file URL to load before using the annotated Component in the browser.

When using compiled web components, you can use a relative URL or prefix the URL with frontend:// to serve different files to different browsers, based on their ES6 support. For example, when using "MyComponent.html", the evaluated URL will be:

• context://frontend/MyComponent.html during development;
• context://frontend-es6/MyComponent.html for ES6 capable browsers;
• context://frontend-es5/MyComponent.html for other browsers.

Relative URLs are interpreted as relative to the configured frontend directory location. You can prefix the URL with context:// to make it relative to the context path or use an absolute URL to refer to files outside the frontend directory.

Returns:

a html file URL

loadMode

public abstract LoadMode loadMode

Deprecated.

Determines the dependency load mode. Refer to LoadMode for the details.

Returns:

load mode for the dependency

Default:

com.vaadin.flow.shared.ui.LoadMode.EAGER