Swing

Java Swing is a GUI toolkit for building desktop applications in Java. It provides standard components like windows (JFrame), panels, buttons, and more, all written in pure Java for cross-platform consistency. Swing is widely used to create rich, interactive UIs. In modern apps, you might want to display web content (HTML, CSS, JavaScript) alongside your traditional Swing components.

Using with Equo Chromium

To use Equo Chromium with the Swing toolkit, follow these steps:

You will also need to override the default close operation so that browser processes are disposed of when you close the window [1].

  • Import classes: Import Swing (JFrame, layouts, etc.) and com.equo.chromium.ChromiumBrowser.

  • Create and configure the frame: In the constructor (or main), make a JFrame, set its default close operation to DISPOSE_ON_CLOSE [1], and choose a layout (the default is BorderLayout).

  • Instantiate the browser: Call ChromiumBrowser.browser = ChromiumBrowser.swing(container, layout, url).

Fully working Swing integration example:

import java.awt.BorderLayout;
import javax.swing.JFrame;
import com.equo.chromium.ChromiumBrowser;

public class SwingExample extends JFrame {
    public SwingBrowser() {
        setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
        ChromiumBrowser browser = ChromiumBrowser.swing(
            getContentPane(), BorderLayout.CENTER,
            "https://docs.equo.dev"
        );
        setSize(800, 600);
        setVisible(true);
    }

    public static void main(String[] args) {
        new SwingBrowser();
    }
}

Set browser background color

After creating the browser, you can obtain the UIComponent and set a background color on it.

For example:

import java.awt.Color;
ChromiumBrowser browser = ChromiumBrowser.swing(getContentPane(), BorderLayout.CENTER, "https://docs.equo.dev/");
Object component = browser.getUIComponent();
((Component) component).setBackground(new Color(0, 0, 255, 255));