pick Panel HTML caption changes from master (#11589)

client/src/main/java/com/vaadin/client/ui/VPanel.java

@@ -132,8 +132,12 @@ public class VPanel extends SimplePanel
     }
 
     /** For internal use only. May be removed or replaced in the future. */
-    public void setCaption(String text) {
-        DOM.setInnerHTML(captionText, text);
+    public void setCaption(String text, boolean captionAsHtml) {
+        if (captionAsHtml) {
+            captionText.setInnerHTML(text);
+        } else {
+            captionText.setInnerText(text);
+        }
     }
 
     /** For internal use only. May be removed or replaced in the future. */

client/src/main/java/com/vaadin/client/ui/panel/PanelConnector.java

@@ -91,18 +91,17 @@ public class PanelConnector extends AbstractSingleComponentContainerConnector
             // Affects size calculations
 
             // Restore default stylenames
+
             getWidget().contentNode.setClassName(VPanel.CLASSNAME + "-content");
             getWidget().bottomDecoration
                     .setClassName(VPanel.CLASSNAME + "-deco");
             getWidget().captionNode.setClassName(VPanel.CLASSNAME + "-caption");
-            boolean hasCaption = false;
-            if (getState().caption != null && !"".equals(getState().caption)) {
-                getWidget().setCaption(getState().caption);
-                hasCaption = true;
+            boolean hasCaption = hasCaption();
+            if (hasCaption) {
+                getWidget().setCaption(getState().caption,getState().captionAsHtml);
             } else {
-                getWidget().setCaption("");
-                getWidget().captionNode
-                        .setClassName(VPanel.CLASSNAME + "-nocaption");
+                getWidget().setCaption("",false);
+                getWidget().captionNode.setClassName(VPanel.CLASSNAME + "-nocaption");
             }
 
             // Add proper stylenames for all elements. This way we can prevent
@@ -177,6 +176,15 @@ public class PanelConnector extends AbstractSingleComponentContainerConnector
         getWidget().contentNode.setTabIndex(getState().tabIndex);
     }
 
+    /**
+     * Detects if caption div should be visible.
+     *
+     * @return {@code true} if caption div should be shown
+     */
+    protected boolean hasCaption() {
+        return getState().caption != null && !getState().caption.isEmpty();
+    }
+
     @Override
     public void updateCaption(ComponentConnector component) {
         // NOP: layouts caption, errors etc not rendered in Panel

uitest/src/main/java/com/vaadin/tests/components/panel/PanelChangeContents.java

@@ -50,6 +50,7 @@ public class PanelChangeContents extends AbstractTestUI
         buttons.addComponent(companiesButton);
         buttons.addComponent(settingsButton);
         panel = new Panel();
+        panel.setCaption("<div class=\"caption-with-html\">Caption</div>");
         panel.setSizeFull();
         panel.setContent(stats);
         content.addComponent(buttons);

uitest/src/main/java/com/vaadin/tests/components/panel/PanelHTMLCaption.java

@@ -0,0 +1,37 @@
+package com.vaadin.tests.components.panel;
+
+import com.vaadin.server.VaadinRequest;
+import com.vaadin.tests.components.AbstractTestUI;
+import com.vaadin.ui.Panel;
+import com.vaadin.ui.Button;
+import com.vaadin.ui.VerticalLayout;
+
+public class PanelHTMLCaption extends AbstractTestUI {
+    public static final String caption = "<b> <div id='divId'>BOLD CAPTION</div></b>";
+    private Panel panel;
+
+    @Override
+    protected void setup(VaadinRequest request) {
+        panel = new Panel();
+        panel.setId("panelId");
+        panel.setWidth("200px");
+        panel.setHeight("200px");
+
+        panel.setCaption(caption);
+        panel.setCaptionAsHtml(false);
+
+        panel.setContent(new VerticalLayout());
+
+        addComponent(panel);
+        Button changeCaptionFormat = new Button(
+                "Set Caption as HTML", new Button.ClickListener() {
+            @Override
+            public void buttonClick(Button.ClickEvent event) {
+                panel.setCaptionAsHtml(true);
+            }
+        });
+
+        changeCaptionFormat.setId("buttonId");
+        addComponent(changeCaptionFormat);
+    }
+}

uitest/src/test/java/com/vaadin/tests/components/panel/PanelChangeContentsTest.java

@@ -3,6 +3,7 @@ package com.vaadin.tests.components.panel;
 import org.junit.Assert;
 import org.junit.Test;
 
+import com.vaadin.testbench.By;
 import com.vaadin.tests.tb3.MultiBrowserTest;
 
 public class PanelChangeContentsTest extends MultiBrowserTest {
@@ -31,5 +32,6 @@ public class PanelChangeContentsTest extends MultiBrowserTest {
                         "/VVerticalLayout[0]/Slot[1]/VPanel[0]/VVerticalLayout[0]/Slot[0]/VLabel[0]")
                                 .getText());
 
+        assertElementNotPresent(By.className("caption-with-html"));
     }
 }

uitest/src/test/java/com/vaadin/tests/components/panel/PanelHTMLCaptionTest.java

@@ -0,0 +1,16 @@
+package com.vaadin.tests.components.panel;
+
+import com.vaadin.tests.tb3.MultiBrowserTest;
+import org.junit.Test;
+import org.openqa.selenium.By;
+
+
+public class PanelHTMLCaptionTest extends MultiBrowserTest {
+    @Test
+    public void testCaptionDisplayedAsText() {
+        openTestURL();
+        assertElementNotPresent(By.id("divId"));
+        findElement(By.id("buttonId")).click();
+        assertElementPresent(By.id("divId"));
+    }
+}