Documentação

Conteúdo

BrowserView

O documento descreve como incorporar um componente visual que apresenta o conteúdo de páginas Web em aplicações Swing, JavaFX e SWT.

Incorporação

O JxBrowser pode ser utilizado em aplicações Java construídas com as seguintes estruturas GUI Java:

Swing
JavaFX
SWT

O componente Browser em si não é um componente visual que permite a visualização de uma página web. Para apresentar o conteúdo de uma página Web carregada no Browser, utilize um dos seguintes controles, dependendo da estrutura GUI utilizada:

com.teamdev.jxbrowser.view.swing.BrowserView
com.teamdev.jxbrowser.view.javafx.BrowserView
com.teamdev.jxbrowser.view.swt.BrowserView

Swing

Para exibir o conteúdo de uma página da Web em um aplicativo Java Swing, crie uma instância do com.teamdev.jxbrowser.view.swing.BrowserView:

Java
Kotlin
import com.teamdev.jxbrowser.view.swing.BrowserView;
...
BrowserView view = BrowserView.newInstance(browser);
import com.teamdev.jxbrowser.view.swing.BrowserView
...
val view = BrowserView.newInstance(browser)

E incorpore-o a um JFrame:

Java
Kotlin
frame.add(view, BorderLayout.CENTER);
frame.add(view, BorderLayout.CENTER)

Eis o exemplo completo:

Java
Kotlin
import com.teamdev.jxbrowser.browser.Browser;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.engine.EngineOptions;
import com.teamdev.jxbrowser.view.swing.BrowserView;

import javax.swing.*;
import java.awt.*;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;

import static com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED;

/**
 * A aplicação mais simples com o componente de browser integrado.
 *
 * <p>Este exemplo demonstra:
 *
 * <ol>
 *     <li>Criando uma instância de {@link Engine}.
 *     <li>Criar uma instância de {@link Browser}.
 *     <li>Incorporar o browser no Swing através de {@link BrowserView}.
 *     <li>Carregando o site "https://html5test.teamdev.com".
 * </ol>
 */
public final class HelloWorld {
    public static void main(String[] args) {
        // Criando e executando o Chromium engine
        Engine engine = Engine.newInstance(HARDWARE_ACCELERATED);

        Browser browser = engine.newBrowser();
        // Carregando a página Web necessária
        browser.navigation().loadUrl("https://html5test.teamdev.com");

        SwingUtilities.invokeLater(() -> {
            // Criando componente Swing para renderizar conteúdo Web
            // carregado na instância de Browser dada
            BrowserView view = BrowserView.newInstance(browser);

            // Criando e apresentando o frame da aplicação Swing
            JFrame frame = new JFrame("JxBrowser AWT/Swing");
            // Fechar o motor quando o frame da aplicação está prestes a fechar
            frame.addWindowListener(new WindowAdapter() {
                @Override
                public void windowClosing(WindowEvent e) {
                    engine.close();
                }
            });
            frame.setDefaultCloseOperation(WindowConstants.DISPOSE_ON_CLOSE);
            frame.add(view, BorderLayout.CENTER);
            frame.setSize(800, 600);
            frame.setVisible(true);
        });
    }
}
import com.teamdev.jxbrowser.browser.Browser
import com.teamdev.jxbrowser.engine.Engine
import com.teamdev.jxbrowser.engine.RenderingMode
import com.teamdev.jxbrowser.view.swing.BrowserView
import java.awt.BorderLayout
import java.awt.event.WindowAdapter
import java.awt.event.WindowEvent
import javax.swing.JFrame
import javax.swing.SwingUtilities
import javax.swing.WindowConstants

/**
 * A aplicação mais simples com o componente de browser integrado.
 *
 * Este exemplo demonstra:
 *
 *  1. Criando uma instância de [Engine].
 *  2. Criando uma instância de [Browser].
 *  3. Incorporando o navegador no Swing via [BrowserView].
 *  4. Carregando o site "https://html5test.teamdev.com".
 */
fun main() {
    // Criando e executando o mecanismo Chromium
    val engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED)
    val browser = engine.newBrowser()
    // Carregando a página web necessária
    browser.navigation().loadUrl("https://html5test.teamdev.com")
    SwingUtilities.invokeLater {
        // Criando componente Swing para renderizar conteúdo Web
        // carregado na instância de Browser fornecida
        val view = BrowserView.newInstance(browser)

        // Criando e apresentar o frame da aplicação Swing
        val frame = JFrame("JxBrowser AWT/Swing")
        // Fechar o motor quando o frame da aplicação está prestes a fechar
        frame.addWindowListener(object: WindowAdapter() {
            override fun windowClosing(e: WindowEvent) {
                engine.close()
            }
        })
        frame.defaultCloseOperation = WindowConstants.DISPOSE_ON_CLOSE
        frame.add(view, BorderLayout.CENTER)
        frame.setSize(800, 600)
        frame.isVisible = true
    }
}

O resultado deste exemplo tem o seguinte aspecto: AWT/Swing BrowserView

Veja também nosso tutorial em vídeo que mostra como adicionar BrowserView a uma aplicação Java Swing:

JavaFX

Para exibir o conteúdo de uma página da Web em um aplicativo JavaFX, crie uma instância do com.teamdev.jxbrowser.view.javafx.BrowserView:

Java
Kotlin
import com.teamdev.jxbrowser.view.javafx.BrowserView;
...
BrowserView view = BrowserView.newInstance(browser);
import com.teamdev.jxbrowser.view.javafx.BrowserView
...
val view = BrowserView.newInstance(browser)

E incorpore-o numa Scene:

Java
Kotlin
Scene scene = new Scene(new BorderPane(view), 800, 600);
frame.add(view, BorderLayout.CENTER)

Eis o exemplo completo:

Java
Kotlin
import com.teamdev.jxbrowser.browser.Browser;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.engine.EngineOptions;
import com.teamdev.jxbrowser.view.javafx.BrowserView;
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javafx.stage.Stage;

import static com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED;

/**
 * A aplicação mais simples com o componente de browser integrado.
 *
 * <p>Este exemplo demonstra:
 *
 * <ol>
 *     <li>Criando uma instância de {@link Engine}.
 *     <li>Criando uma instância de {@link Browser}.
 *     <li>Incorporação do browser em JavaFX através de {@link BrowserView}.
 *     <li>Carregando o site "https://html5test.teamdev.com".
 * </ol>
 */
public final class HelloWorld extends Application {

    @Override
    public void start(Stage primaryStage) {
        // Criando e executando o motor Chromium
        Engine engine = Engine.newInstance(HARDWARE_ACCELERATED);

        Browser browser = engine.newBrowser();
        // Carregando a página Web necessária
        browser.navigation().loadUrl("https://html5test.teamdev.com");

        // Criando o componente UI para renderizar conteúdo Web
        // carregado na instância de Browser dada
        BrowserView view = BrowserView.newInstance(browser);

        Scene scene = new Scene(new BorderPane(view), 800, 600);
        primaryStage.setTitle("JxBrowser JavaFX");
        primaryStage.setScene(scene);
        primaryStage.show();

        // Fechando o motor quando o palco está prestes a fechar
        primaryStage.setOnCloseRequest(event -> engine.close());
    }
}
import com.teamdev.jxbrowser.browser.Browser
import com.teamdev.jxbrowser.engine.Engine
import com.teamdev.jxbrowser.engine.RenderingMode
import com.teamdev.jxbrowser.view.javafx.BrowserView
import javafx.application.Application
import javafx.event.EventHandler
import javafx.scene.Scene
import javafx.scene.layout.BorderPane
import javafx.stage.Stage
import javafx.stage.WindowEvent

/**
 * A aplicação mais simples com o componente de browser integrado.
 *
 * Este exemplo demonstra:
 *
 *  1. Criando uma instância de [Engine].
 *  2. Criando uma instância de [Browser].
 *  3. Incorporando o navegador no JavaFX via [BrowserView].
 *  4. Carregando o site "https://html5test.teamdev.com".
 */
class HelloWorld : Application() {
    override fun start(primaryStage: Stage) {
        // Criando e executando o mecanismo Chromium
        val engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED)
        val browser = engine.newBrowser()
        // Carregando a página web necessária
        browser.navigation().loadUrl("https://html5test.teamdev.com")
        // Criando o componente UI para renderizar o conteúdo da web
        // carregado na instância dada do Browser
        val view = BrowserView.newInstance(browser)
        val scene = Scene(BorderPane(view), 800.0, 600.0)
        primaryStage.title = "JxBrowser JavaFX"
        primaryStage.scene = scene
        primaryStage.show()

        // Fechar o motor quando o palco está prestes a fechar
        primaryStage.onCloseRequest = EventHandler { engine.close() }
    }
}

O resultado deste exemplo tem o seguinte aspecto: JavaFX BrowserView

Veja também nosso tutorial em vídeo que mostra como adicionar BrowserView a um aplicativo JavaFX:

JFXPanel

Recomendamos que utilize o Swing BrowserView em aplicações Swing, bem como o JavaFX BrowserView em aplicações JavaFX.

Às vezes, pode ser necessário incorporar o JavaFX BrowserView em uma aplicação Swing. Por exemplo, se desenvolver um controle de navegador Web complexo utilizando o JavaFX UI Toolkit e tiver de apresentar este controle JavaFX numa aplicação Swing/AWT.

Desde a versão 7.1, é possível incorporar o JavaFX BrowserView em uma janela Swing/AWT através do javafx.embed.swing.JFXPanel. É suportado em todas as plataformas suportadas com todos os modos de renderização.

Java
Kotlin
import com.teamdev.jxbrowser.browser.Browser;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.engine.EngineOptions;
import com.teamdev.jxbrowser.engine.RenderingMode;
import com.teamdev.jxbrowser.view.javafx.BrowserView;
import java.awt.BorderLayout;
import javafx.application.Platform;
import javafx.embed.swing.JFXPanel;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javax.swing.JFrame;
import javax.swing.SwingUtilities;

/**
 * O exemplo demonstra como incorporar o JavaFX BrowserView no
 * JFXPanel que é apresentado no interior do frame Swing/AWT.
 */ 
public final class JFXPanelExample {

    public static void main(final String[] args) {
        SwingUtilities.invokeLater(JFXPanelExample::initAndShowGUI);
    }

    private static void initAndShowGUI() {
        JFrame frame = new JFrame("JFXPanel");

        // Incorporando o JFXPanel no Swing Frame
        JFXPanel fxPanel = new JFXPanel();
        frame.add(fxPanel, BorderLayout.CENTER);
        frame.setSize(600, 600);
        frame.setVisible(true);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // Inicialização do JFXPanel na thread de interface JavaFX
        Platform.runLater(() -> initFX(fxPanel));
    }

    private static void initFX(JFXPanel fxPanel) {
        Engine engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED);

        Browser browser = engine.newBrowser();
        browser.navigation().loadUrl("https://www.google.com");
        // Criar JavaFX BrowserView e inseri-lo no JFXPanel
        BrowserView view = BrowserView.newInstance(browser);
        BorderPane pane = new BorderPane(view);
        fxPanel.setScene(new Scene(pane, 600, 600));
    }
}
import com.teamdev.jxbrowser.engine.Engine
import com.teamdev.jxbrowser.engine.RenderingMode
import com.teamdev.jxbrowser.view.javafx.BrowserView
import javafx.application.Platform
import javafx.embed.swing.JFXPanel
import javafx.scene.Scene
import javafx.scene.layout.BorderPane
import java.awt.BorderLayout
import javax.swing.JFrame
import javax.swing.SwingUtilities

/**
 * O exemplo demonstra como incorporar o JavaFX BrowserView no
 * JFXPanel que é apresentado dentro do Swing/AWT Frame.
 */
fun main() {
    SwingUtilities.invokeLater { initAndShowGUI() }
}

private fun initAndShowGUI() {
    val frame = JFrame("JFXPanel")

    // Incorporando o JFXPanel no Frame Swing
    val fxPanel = JFXPanel()
    frame.add(fxPanel, BorderLayout.CENTER)
    frame.setSize(600, 600)
    frame.isVisible = true
    frame.defaultCloseOperation = JFrame.EXIT_ON_CLOSE

    // Inicializando o JFXPanel na thread de interface JavaFX
    Platform.runLater { initFX(fxPanel) }
}

private fun initFX(fxPanel: JFXPanel) {
    val engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED)
    val browser = engine.newBrowser()
    browser.navigation().loadUrl("https://www.google.com")
    // Criando JavaFX BrowserView e inserindo-o no JFXPanel
    val view = BrowserView.newInstance(browser)
    val pane = BorderPane(view)
    fxPanel.scene = Scene(pane, 600.0, 600.0)
}

FXML

Você pode incorporar o JavaFX BrowserView numa aplicação FXML utilizando a abordagem descrita na seção seguinte.

Em primeiro lugar, descreva a estrutura do arquivo browser-view.fxml para indicar ao JavaFX como o controle BrowserView deve ser incorporado na GUI da aplicação JavaFX.

<?xml version="1.0" encoding="UTF-8"?>

<?import com.teamdev.jxbrowser.view.javafx.FxmlBrowserView?>
<?import javafx.scene.control.TextField?>
<?import javafx.scene.layout.BorderPane?>
<BorderPane 
    fx:controller="com.teamdev.jxbrowser.view.javafx.FxmlBrowserViewController" 
    xmlns:fx="http://javafx.com/fxml">
    <top>
        <TextField fx:id="textField" text="https://www.google.com" 
            onAction="#loadUrl"/>
    </top>
    <center>
        <FxmlBrowserView fx:id="browserView"/>
    </center>
</BorderPane>

Este FXML declara um componente que consiste em dois elementos: barra de endereço e visualização de navegador. A barra de endereço representa um campo de texto simples. Aqui podemos escrever um URL e pressionar Enter para o carregá-lo na visualização de navegador abaixo. A visualização de navegador contém FxmlBrowserView que apresenta o conteúdo da página Web carregada.

A implementação de FxmlBrowserViewController definida no arquivo browser-view.fxml tem o seguinte aspecto:

Java
Kotlin
package com.teamdev.jxbrowser.view.javafx;

import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.control.TextField;

import java.net.URL;
import java.util.ResourceBundle;

/**
 * Representa o controlador FXML com a barra de endereço e a área de visualização de navegador que
 * apresenta o URL introduzido na barra de endereço.
 */
public final class FxmlBrowserViewController implements Initializable {

    @FXML
    private TextField textField;

    @FXML
    private FxmlBrowserView browserView;

    @Override
    public void initialize(URL location, ResourceBundle resources) {
        browserView.browser().navigation().loadUrl(textField.getText());
    }

    public void loadUrl(ActionEvent actionEvent) {
        browserView.browser().navigation().loadUrl(textField.getText());
    }
}
package com.teamdev.jxbrowser.view.javafx

import javafx.event.ActionEvent
import javafx.fxml.FXML
import javafx.fxml.Initializable
import javafx.scene.control.TextField
import java.net.URL
import java.util.*

/**
 * Representa o controlador FXML com a barra de endereço e a área de visualização do browser que
 * apresenta o URL introduzido na barra de endereço.
 */
class FxmlBrowserViewController : Initializable {

    @FXML
    private val textField: TextField? = null

    @FXML
    private val browserView: FxmlBrowserView? = null
    
    override fun initialize(location: URL, resources: ResourceBundle) {
        browserView.browser().navigation().loadUrl(textField!!.text)
    }

    fun loadUrl(actionEvent: ActionEvent?) {
        browserView.browser().navigation().loadUrl(textField!!.text)
    }
}

Você pode notar que a implementação do controlador utiliza FxmlBrowserView em vez do JavaFX BrowserView. Isto deve-se ao fato de o JavaFX BrowserView não fornecer o construtor público padrão, portanto, ele não pode ser utilizado diretamente no FXML. Para incorporar o JavaFX BrowserView utilize o FxmlBrowserView que representa um simples wrapper com o construtor público padrão que inicializa e incorpora o JavaFX BrowserView.

A implementação da classe FxmlBrowserView é a seguinte:

Java
Kotlin
package com.teamdev.jxbrowser.view.javafx;

import com.teamdev.jxbrowser.browser.Browser;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.engine.RenderingMode;
import com.teamdev.jxbrowser.view.javafx.BrowserView;
import javafx.scene.layout.StackPane;

/**
 * Um componente envolvedor para JavaFX {@link BrowserView} que permite utilizar
 * a instância BrowserView nas aplicações FXML. O JavaFX BrowserView
 * não pode ser utilizado diretamente no FXML, porque não fornece o padrão
 * construtor público.
 */
public final class FxmlBrowserView extends StackPane {

    private final Browser browser;

    /**
     * Constrói uma instância de {@code FxmlBrowserView}.
     */
    public FxmlBrowserView() {
        Engine engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED);
        browser = engine.newBrowser();
        BrowserView view = BrowserView.newInstance(browser);
        getChildren().add(view);
    }

    /**
     * Retorna a instância {@link Browser} da visualização atual do navegador.
     */
    public Browser browser() {
        return browser;
    }
}
package com.teamdev.jxbrowser.view.javafx

import com.teamdev.jxbrowser.browser.Browser
import com.teamdev.jxbrowser.engine.Engine
import com.teamdev.jxbrowser.engine.RenderingMode
import javafx.scene.layout.StackPane

/**
 * Um componente encapsulado para JavaFX [BrowserView] que permite utilizar
 * a instância BrowserView em aplicações FXML. O JavaFX BrowserView
 * não pode ser utilizado diretamente no FXML, porque não fornece o construtor público
 * padrão.
 */
class FxmlBrowserView : StackPane() {
    
    private val browser: Browser

    /**
     * Constrói uma instância de `FxmlBrowserView`.
     */
    init {
        val engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED)
        browser = engine.newBrowser()
        val view = BrowserView.newInstance(browser)
        children.add(view)
    }

    /**
     * Devolve a instância [Browser] da vista do browser atual.
     */
    fun browser() = browser
}

Agora, temos tudo para implementar e executar o nosso exemplo FXML:

Java
Kotlin
import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javafx.stage.Stage;

/**
 * Este exemplo demonstra como utilizar o JavaFX BrowserView numa aplicação FXML
 * através do controlo {@link com.teamdev.jxbrowser.view.javafx.FxmlBrowserView}.
 */
public final class BrowserViewInFxml extends Application {

    public static void main(String[] args) {
        Application.launch(BrowserViewInFxml.class, args);
    }

    @Override
    public void start(Stage primaryStage) throws Exception {
        BorderPane pane = FXMLLoader.load(
                BrowserViewInFxml.class.getResource("browser-view.fxml"));

        primaryStage.setTitle("JavaFX BrowserView in FXML");
        primaryStage.setScene(new Scene(pane, 1024, 600));
        primaryStage.show();
    }
}
import javafx.application.Application
import javafx.fxml.FXMLLoader
import javafx.scene.Scene
import javafx.scene.layout.BorderPane
import javafx.stage.Stage

/**
 * Este exemplo demonstra como utilizar o JavaFX BrowserView na aplicação FXML
 * através do controle [com.teamdev.jxbrowser.view.javafx.FxmlBrowserView] .
 */
class BrowserViewInFxml : Application() {
    
    override fun start(primaryStage: Stage) {
        val pane = FXMLLoader.load<BorderPane>(
            BrowserViewInFxml::class.java.getResource("browser-view.fxml")
        )
        primaryStage.title = "JavaFX BrowserView in FXML"
        primaryStage.scene = Scene(pane, 1024.0, 600.0)
        primaryStage.show()
    }
}

fun main(args: Array<String>) {
    Application.launch(BrowserViewInFxml::class.java, *args)
}

Depois de executar este exemplo, deverá obter o seguinte resultado:

FXML Saída Exemplo

O exemplo completo com todas as classes e recursos utilizados nesta seção podem ser encontrados em JxBrowser Examples.

SWT

Para exibir o conteúdo de uma página da Web em um aplicativo Java SWT, crie uma instância do com.teamdev.jxbrowser.view.swt.BrowserView:

Java
Kotlin
import com.teamdev.jxbrowser.view.swt.BrowserView;
...
Display display = new Display();
Shell shell = new Shell(display);

BrowserView view = BrowserView.newInstance(shell, browser);
import com.teamdev.jxbrowser.view.swt.BrowserView
...
val display = Display()
val shell = Shell(display)

val view = BrowserView.newInstance(shell, browser)

Eis o exemplo completo:

Java
Kotlin
import com.teamdev.jxbrowser.browser.Browser;
import com.teamdev.jxbrowser.engine.Engine;
import com.teamdev.jxbrowser.engine.EngineOptions;
import com.teamdev.jxbrowser.view.swt.BrowserView;
import org.eclipse.swt.layout.FillLayout;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Shell;

import static com.teamdev.jxbrowser.engine.RenderingMode.HARDWARE_ACCELERATED;

/**
 * A aplicação mais simples com o componente de browser integrado.
 *
 * <p>Este exemplo demonstra:
 *
 * <ol>
 *     <li>Criar uma instância de {@link Engine}.
 *     <li>Criar uma instância de {@link Browser}.
 *     <li>Incorporação do browser no SWT através de {@link BrowserView}.
 *     <li>Carregamento do sítio Web "https://html5test.teamdev.com".
 * </ol>
 */
public final class HelloWorld {

    public static void main(String[] args) {
        // Criar e executar o motor Chromium
        Engine engine = Engine.newInstance(HARDWARE_ACCELERATED);

        Browser browser = engine.newBrowser();
        // Carregar a página Web necessária
        browser.navigation().loadUrl("https://html5test.teamdev.com");

        Display display = new Display();
        Shell shell = new Shell(display);
        shell.setText("JxBrowser SWT");
        shell.setLayout(new FillLayout());

        // Criar componente SWT para renderizar conteúdo Web carregado
        // na instância Browser
        BrowserView view = BrowserView.newInstance(shell, browser);
        view.setSize(800, 600);

        shell.pack();
        shell.open();

        while (!shell.isDisposed()) {
            if (!display.readAndDispatch()) {
                display.sleep();
            }
        }
        // Encerrar o motor e libertar todos os recursos atribuídos
        engine.close();
        display.dispose();
    }
}
import com.teamdev.jxbrowser.engine.Engine
import com.teamdev.jxbrowser.engine.RenderingMode
import com.teamdev.jxbrowser.view.swt.BrowserView
import org.eclipse.swt.layout.FillLayout
import org.eclipse.swt.widgets.Display
import org.eclipse.swt.widgets.Shell

/**
 * A aplicação mais simples com o componente de browser integrado.
 *
 * Este exemplo demonstra:
 *
 *  1. Criando uma instância de [Engine].
 *  2. Criando uma instância de [Browser].
 *  3. Incorporando o navegador no SWT via [BrowserView].
 *  4. Carregando o site "https://html5test.teamdev.com".
 */
fun main() {
    // Criar e executar o motor Chromium
    val engine = Engine.newInstance(RenderingMode.HARDWARE_ACCELERATED)
    val browser = engine.newBrowser()
    // Carregar a página Web necessária
    browser.navigation().loadUrl("https://html5test.teamdev.com")
    val display = Display()
    val shell = Shell(display)
    shell.setText("JxBrowser SWT")
    shell.setLayout(FillLayout())

    // Criação de componente SWT para renderização de conteúdo Web carregado
    // na instância Browser
    val view = BrowserView.newInstance(shell, browser)
    view.setSize(800, 600)
    shell.pack()
    shell.open()
    while (!shell.isDisposed()) {
        if (!display.readAndDispatch()) {
            display.sleep()
        }
    }
    // Fechar o motor e libertar todos os recursos atribuídos
    engine.close()
    display.dispose()
}

O resultado deste exemplo tem o seguinte aspecto: SWT BrowserView

Veja também o nosso tutorial em vídeo que mostra como adicionar BrowserView a uma aplicação Java SWT:

Renderização

O JxBrowser suporta vários modos de renderização. Nesta seção, descreveremos cada um dos modos com o seu desempenho e limitações, e forneceremos recomendações sobre a escolha do modo correto, dependendo do tipo de aplicação Java.

Acelerado por hardware

Neste modo de renderização, a biblioteca renderiza o conteúdo de uma página Web utilizando a GPU no processo GPU do Chromium e apresenta-a diretamente numa superfície. Neste modo, o BrowserView cria e incorpora uma janela nativa heavyweight (superfície) na qual o Chromium renderiza os pixels produzidos.

Fora da Tela

Neste modo de renderização, a biblioteca renderiza o conteúdo de uma página Web utilizando a GPU no processo GPU do Chromium e copia os pixéis para uma memória intermédia fora de tela atribuída na memória do processo Java. Neste modo, o BrowserView cria e incorpora um componente leve que lê os pixels do buffer fora da tela e os exibe usando a API gráfica Java padrão.

Desempenho

No modo de renderização Hardware Accelerated, o desempenho é o mesmo que na aplicação Chromium, devido ao fato de o Chromium renderizar os pixels diretamente numa janela nativa incorporada no componente BrowserView. Um desempenho médio de renderização em Frame por segundo (FPS) de um vídeo HTML5 é de ~60FPS neste modo de renderização.

No modo de renderização fora de tela, o desempenho é diferente para cada conjunto de ferramentas de IU e sistema operacional. Os resultados do teste de desempenho de renderização de um vídeo HTML5 em FPS são os seguintes:

Windows

Intel Core i7 7700k 4.2 GHz with GPU GTX 1070
Dimensão do vídeo: 1920x1080

Windows fora de tela

macOS

MacBook Pro 15”, Intel Core i7 2.9GHz with GPU Radeon Pro 650 4GB
Dimensão do vídeo: 2880x1800

macOS Fora de tela

Linux

AMD FX-8300 3.3 GHz with GPU Radeon RX 480
Dimensão do vídeo: 1920x1080

Linux Fora de tela

Limitações

Incorporação e renderização

Não incorpore o Swing BrowserView em um JInternalFrame ou JLayeredPane, nem exiba outros componentes Swing sobre o BrowserView quando o modo de renderização HARDWARE_ACCELERATED estiver ativado. Neste modo, o BrowserView exibe uma janela nativa heavyweight. A apresentação de uma janela heavyweight dentro de uma GUI leva a um problema bem conhecido com a mistura de componentes heavyweight e lightweight.

De acordo com o artigo, o problema da mistura dos componentes heavyweight e lightweight foi resolvido no JDK 6 Update 12 e no JDK 7 build 19. Isso é verdade apenas para os componentes heavyweight do Java Swing, como o java.awt.Canvas. O JxBrowser incorpora o seu próprio widget nativo heavyweight. Assim, a correção não será aplicada neste caso.

No aplicativo JavaFX, a configuração de javafx.stage.Stage com o estilo StageStyle.TRANSPARENT adiciona a flag de estilo de janela WS_EX_LAYERED à janela JavaFX no Windows. Esta flag é utilizada para criar uma janela em camadas. A janela em camadas é uma janela que desenha o seu conteúdo fora de tela. Se você incorporar o JavaFX BrowserView, quando o modo de renderização HARDWARE_ACCELERATED estiver ativado, em uma janela em camadas, seu conteúdo não será pintado devido ao conflito de tipos de janela.

No aplicativo Eclipse RCP no macOS, quando o modo de renderização HARDWARE_ACCELERATED está ativado, os widgets SWT podem não ser exibidos na parte superior do widget SWT BrowserView, porque o widget SWT BrowserView renderiza o conteúdo usando Layer-Backed NSView quando os outros widgets SWT desenham seu conteúdo usando NSView regular. O problema é que o conteúdo de um NSView normal não pode sobrepor-se ao conteúdo do NSView com suporte de camadas. Isto se deve ao fato da renderização ocorrer em contextos de desenho diferentes e do NSView normal ser sempre apresentado sob o NSView com suporte de camada.

Mouse, Teclado e Entrada Tátil

No modo de renderização OFF_SCREEN no Windows e no Linux, e nos modos de renderização HARDWARE_ACCELERATED e OFF_SCREEN no macOS, os eventos de mouse, teclado e toque são processados no lado Java e encaminhados para o Chromium. Os kits de ferramentas Java Swing, JavaFX e SWT UI não fornecem um suporte de eventos táteis totalmente funcional, pelo que o JxBrowser não suporta alguns gestos táteis nestes modos de apresentação.

A mesma limitação se aplica à funcionalidade Arrastar e Soltar (DnD). O DnD é processado utilizando a API Java DnD, portanto, não funciona exatamente como no Google Chrome. O DnD suporta apenas o conjunto predefinido de sabores.

Arrastar e Soltar

Por padrão, a função arrastar e soltar está ativada para Swing, JavaFX e SWT BrowserView. Para desativar a função arrastar e soltar, utilize o seguinte procedimento:

Java
Kotlin
browserView.dragAndDrop().disable();
browserView.dragAndDrop().disable()

HiDPI

Esta seção descreve as capacidades e limitações do JxBrowser em ambientes com telas HiDPI.

macOS

No macOS, o JxBrowser suporta telas HiDPI e Retina prontos a utilizar em Swing, JavaFX e SWT.

Windows

No Windows, o JxBrowser suporta telas HiDPI prontos a utilizar em Swing e JavaFX.

SWT

A biblioteca apenas reconhece o fator de escala de um monitor primário. O fator de escala deve ser um múltiplo de 25%. É obrigatório utilizar a propriedade de sistema swt.autoScale se necessitar de suporte HiDPI. Os valores suportados são quarter e exact:

java -Dswt.autoScale=quarter -jar application.jar

No Eclipse 4.6 e superior, a propriedade swt.autoScale é sempre quarter.

Você pode ler mais sobre swt.autoScale aqui.

Linux

O fator de escala deve ser explicitamente configurado ao iniciar a JVM. Ele é detectado automaticamente.

Swing

Para configurar o fator de escala em uma aplicação Swing, utilize a propriedade de sistema sun.java2d.uiScale. Ela aceita apenas valores inteiros.

java -Dsun.java2d.uiScale=2 -jar application.jar

JavaFX

Para configurar o fator de escala numa aplicação JavaFX, utilize a propriedade de sistema glass.gtk.uiScale. Ela aceita apenas valores inteiros.

java -Dglass.gtk.uiScale=2 -jar application.jar

Introdução

Instalação

Guias

Resolução de Problemas

BrowserView

Incorporação

Swing

JavaFX

JFXPanel

FXML

SWT

Renderização

Acelerado por hardware

Fora da Tela

Desempenho

Limitações

Incorporação e renderização

Mouse, Teclado e Entrada Tátil

Arrastar e Soltar

HiDPI

macOS

Windows

Linux