GWT - Widget HTMLPanel

Introdução

o HTMLPanel widget representa um painel que contém HTML e que pode anexar widgets filhos a elementos identificados nesse HTML.

Declaração de Classe

A seguir está a declaração para com.google.gwt.user.client.ui.HTMLPanel classe -

public class HTMLPanel
   extends ComplexPanel

Construtores de classe

Sr. Não.	Construtor e descrição
1	HTMLPanel(SafeHtml safeHtml) Inicializa o HTML do painel a partir de um determinado objeto SafeHtml.
2	HTMLPanel(java.lang.String html) Cria um painel HTML com o conteúdo HTML especificado dentro de um elemento DIV.
3	HTMLPanel(java.lang.String tag, java.lang.String html) Cria um painel HTML cujo elemento raiz possui a tag fornecida e com o conteúdo HTML especificado.

Métodos de aula

Sr. Não.	Nome e descrição da função
1	void add(Widget widget, Element elem) Adiciona um widget filho ao painel, contido em um elemento HTML.
2	void add(Widget widget, java.lang.String id) Adiciona um widget filho ao painel, contido no elemento HTML especificado por um determinado id.
3	void addAndReplaceElement(Widget widget, Element toReplace) Adiciona um widget filho ao painel, substituindo o elemento HTML.
4	void addAndReplaceElement(Widget widget, java.lang.String id) Adiciona um widget filho ao painel, substituindo o elemento HTML especificado por um determinado id.
5	static java.lang.String createUniqueId() Um método auxiliar para criar IDs exclusivos para elementos em HTML gerado dinamicamente.
6	Element getElementById(java.lang.String id) Encontra um elemento dentro deste painel por seu id.

Métodos herdados

Esta classe herda métodos das seguintes classes -

com.google.gwt.user.client.ui.UIObject
com.google.gwt.user.client.ui.Widget
com.google.gwt.user.client.ui.Panel
com.google.gwt.user.client.ui.ComplexPanel
java.lang.Object

Exemplo de widget HTMLPanel

Este exemplo o levará por etapas simples para mostrar o uso de um widget HTMLPanel no GWT. Siga as etapas a seguir para atualizar o aplicativo GWT que criamos no GWT - capítulo Criar aplicativo -

Degrau	Descrição
1	Crie um projeto com o nome HelloWorld em um pacote com.tutorialspoint conforme explicado no capítulo GWT - Criar aplicativo .
2	Modifique HelloWorld.gwt.xml , HelloWorld.css , HelloWorld.html e HelloWorld.java conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3	Compile e execute o aplicativo para verificar o resultado da lógica implementada.

A seguir está o conteúdo do descritor do módulo modificado src/com.tutorialspoint/HelloWorld.gwt.xml.

<?xml version = "1.0" encoding = "UTF-8"?>
<module rename-to = 'helloworld'>
   <!-- Inherit the core Web Toolkit stuff.                        -->
   <inherits name = 'com.google.gwt.user.User'/>

   <!-- Inherit the default GWT style sheet.                       -->
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>

   <!-- Specify the app entry point class.                         -->
   <entry-point class = 'com.tutorialspoint.client.HelloWorld'/>

   <!-- Specify the paths for translatable code                    -->
   <source path = 'client'/>
   <source path = 'shared'/>

</module>

A seguir está o conteúdo do arquivo de folha de estilo modificado war/HelloWorld.css.

body {
   text-align: center;
   font-family: verdana, sans-serif;
}

h1 {
   font-size: 2em;
   font-weight: bold;
   color: #777777;
   margin: 40px 0px 70px;
   text-align: center;
}

A seguir está o conteúdo do arquivo host HTML modificado war/HelloWorld.html.

<html>
   <head>
      <title>Hello World</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
      </script>
   </head>

   <body>
      <h1>HTMLPanel Widget Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

Vamos ter o seguinte conteúdo do arquivo Java src/com.tutorialspoint/HelloWorld.java que demonstrará o uso do widget HTMLPanel.

package com.tutorialspoint.client;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.DecoratorPanel;
import com.google.gwt.user.client.ui.HTMLPanel;
import com.google.gwt.user.client.ui.RootPanel;

public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {
      String htmlString = "This is a <b>HTMLPanel</b> containing"
         +" html contents. "
         +" <i>By putting some fairly large contents in the middle"
         +" and setting its size explicitly, it becomes a scrollable area"
         +" within the page, but without requiring the use of an IFRAME.</i>"
         +" <u>Here's quite a bit more meaningless text that will serve"
         +" to make this thing scroll off the bottom of its visible area."
         +" Otherwise, you might have to make it really, really"
         +" small in order to see the nifty scroll bars!</u>";

      HTMLPanel htmlPanel = new HTMLPanel(htmlString);

      DecoratorPanel panel = new DecoratorPanel();
      panel.add(htmlPanel);

      // Add the widgets to the root panel.
      RootPanel.get().add(panel);
   }
}

Quando você estiver pronto com todas as alterações feitas, vamos compilar e rodar o aplicativo em modo de desenvolvimento como fizemos no capítulo GWT - Criar Aplicativo . Se tudo estiver bem com sua aplicação, isso produzirá o seguinte resultado -

↰ Previous page