@Retention(value=RUNTIME) @Target(value=TYPE) @Documented @Repeatable(value=HtmlImport.Container.class) public @interface HtmlImport
Componentclass. 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
JsModule annotation should be used. And to use a css
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.
|Modifier and Type||Required Element and Description|
HTML file URL to load before using the annotated
public abstract String value
Componentin 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-es6/MyComponent.htmlfor ES6 capable browsers;
context://frontend-es5/MyComponent.htmlfor 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.
Copyright © 2021. All rights reserved.