chore: Recommend lit over polymer (#9968)

Add recommendation to use LitTemplate instead of PolymerTemplate into polymer JavaDocs. Closes #8862
vaadin · Feb 4, 2021 · 7df84a5 · 7df84a5
1 parent cd21f03
commit 7df84a5
Show file tree

Hide file tree

Showing 4 changed files with 9 additions and 1 deletion.
diff --git a/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/BundleParser.java b/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/BundleParser.java
@@ -33,7 +33,6 @@
 import org.slf4j.LoggerFactory;
 
 import com.vaadin.flow.internal.StringUtil;
-import com.vaadin.flow.server.frontend.FrontendUtils;
 
 import elemental.json.Json;
 import elemental.json.JsonArray;

diff --git a/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/EventHandler.java b/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/EventHandler.java
@@ -28,6 +28,9 @@
  * Publishes the annotated method so it can be invoked from the client side as
  * template event handlers.
  *
+ * Recommend using {@code LitTemplate} instead of PolymerTemplate as Polymer will
+ * be deprecated in the next LTS version.
+ *
  * @see EventData
  * @author Vaadin Ltd
  * @since 1.0

diff --git a/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/ModelItem.java b/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/ModelItem.java
@@ -32,6 +32,9 @@
  * the value to be the methodName e.g. for {@code setSubItem(...)} use
  * {@code @ModelItem("subItem")}.
  *
+ * Recommend using {@code LitTemplate} instead of PolymerTemplate as Polymer will
+ * be deprecated in the next LTS version.
+ *
  * @author Vaadin Ltd
  * @since 1.0
  */

diff --git a/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/PolymerTemplate.java b/flow-server/src/main/java/com/vaadin/flow/component/polymertemplate/PolymerTemplate.java
@@ -38,6 +38,9 @@
  * that the injected element will have functional limitations on the server
  * side.
  *
+ * Recommend using {@code LitTemplate} instead of PolymerTemplate as Polymer will
+ * be deprecated in the next LTS version.
+ *
  * @param <M>
  *            a model class that will be used for template data propagation
  *