gwtswing

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 22 Open GitHub ↗

This is an UI API similar to Java's Swing API, but on top of GWT.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GWTSwing
This is an UI API similar to Java's Swing API, but on top of Java to Web transpilers like GWT and TeaVM. 
Even though, the name is still GWTSwing, it has been ported to TeaVM by introducing a platform abstraction layer named
gplatform, with implementations for GWT and TeaVM.

There are 2 main differences between Swing an GWTSwing.
1. Modal dialogs don't stop event execution. Instead of that, callback objects can be used, to get notified if a dialog was closed.
2. All Classnames beginn with "G" instead of "J" (GTextField instead of JTextField). This was done to avoid license problems, because the API is now different from Oracles Swing and to avoid confusion while developing with GWTSwing.

One of the main benefits is, that there are no server calls after starting the application. Everything is handled locally on the client, until you do server calls by yourself.

## What's new
### 2026-04-01 Version 1.4.0
- GWTSwing is now available on Maven Central
- Fixes for DefaultGestureListener
- added GComponent.getCursor()
- added GCursor.getByName(name)
- added GCursor.NORTHWEST_SOUTHEAST_RESIZE_CURSOR
- more fixes

### 2024-12-27 Version 1.3
- DefaultGestureListener will now create useful calls on Swiping, Scaling and Clicking
- GPopupMenus will always be inside the visible Browser area. If the requested popup position is outside, then it is moved into the visible area.
- Fixed oversized GTree
- other Small fixes

### 2024-12-21 Version 1.2.1
This version fixes an issue with padding on GLabels and conatins better looking Tabs as well as some other small fixes and enhancements.

### 2024-03-17 Version 1.2
GWTSwing can now dynamically switch between different Stylesheets. To see that in action just have a look at the demos listed below. Inside the demo select "Look" on the left, and then press one of the available style buttons like "Dark" for the Dark Mode.

## How to use
GWTSwing is now on Maven Central. Just add the dependencies for GWT or TeaVM as needed and shown below.

### GWT
Add the dependencies to your pom.xml

```
    <dependency>
      <groupId>de.exware</groupId>
      <artifactId>gplatform</artifactId>
      <version>1.2.0</version>
    </dependency>
    <dependency>
      <groupId>de.exware</groupId>
      <artifactId>gplatform.gwt</artifactId>
      <version>1.2.0</version>
    </dependency>
    <dependency>
      <groupId>de.exware</groupId>
      <artifactId>gwtswing</artifactId>
      <version>1.4.0</version>
    </dependency>
```

GWTSwing is used like other gwt libraries. Just add the gwtswing, gplatform and gplatform.gwt to your classpath and

```
  <inherits name='de.exware.gwtswing'/>
```
to your projects ```abc.gwt.xml```.
Additionally you should add the css file to your html pages header

```
   <link type="text/css" rel="stylesheet" href="YOUR_PROJECT_NAME/de/exware/gwtswing/gwtswing.css"/>
```

After that, you can use the GWTSwing classes in your project.

```
GPanel panel = new GPanel();
panel.setLayout(new GGridLayout(1, 1));
GLabel label = new GLabel("Hello World");
panel.add(label);
panel.setSize(800,600);
GUtilities.addToBody(panel);
```
Looks like Swing? Thats the goal! :-)

The call of 'GUtilities.addToBody' appends your GWTSwing UI to the Web Page.

Porting an existing Swing application is now nearly as easy as replacing all "J" with "G".

### TeaVM
Add the dependencies to your pom.xml

```
    <dependency>
      <groupId>de.exware</groupId>
      <artifactId>gplatform</artifactId>
      <version>1.2.0</version>
    </dependency>
    <dependency>
      <groupId>de.exware</groupId>
      <artifactId>gplatform.teavm</artifactId>
      <version>1.2.0</version>
    </dependency>
    <dependency>
      <groupId>de.exware</groupId>
      <artifactId>gwtswing</artifactId>
      <version>1.4.0</version>
    </dependency>
```

Furthermore you need to include the contents of the resources folder in the webapp folder.

You have to manually link the css file with:

```
<link href="./de/exware/gwtswing/gwtswing.css" rel="stylesheet">
```

Now you need to initialize the TeavmGPPlatform class with a static call to the init method.

```java
public static void main(String[] args) 
{
    TeavmGPlatform.init();
    ...
}
```

After that you are good to go and use the G classes of gwtswing.

## Demo
A small demo application, which shows some of the main UI components can be found here:

with GWT:   http://www.exware.de/gwtswing/demo/gwt/demo.html

with TeaVM: http://www.exware.de/gwtswing/demo/teavm/demo.html

## Real live usage
Where is GWTSwing used

### keedo
An archive system for digital documents which allows to set markers on documents without modifying the original documents. Includes an automatic text recognition system (OCR) for scanned documents. A demo can be found on the projects homepage. https://keeitsi.com/

### Keeitsi homepage
The companies homepage was made with GWTSwing just to prove, that it is possible.

### FFManager
FFManager is an application to manage volunteer fire brigades. In it's newest release 4.x the developers began to port the Swing UI to GWTSwing.
This looks like 
<br>
<img src="media/ffm_gwtswing.png" width="800px"/>
<br>compared to the original swing application:
<br>
<img src="media/ffm_swing.png" width="800px"/>

gwtswing

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README