https://github.com/osiris-team/better-layout
Probably the best and most modern layout for Java AWT/Swing
https://github.com/osiris-team/better-layout
Last synced: 10 months ago
JSON representation
Probably the best and most modern layout for Java AWT/Swing
- Host: GitHub
- URL: https://github.com/osiris-team/better-layout
- Owner: Osiris-Team
- License: mit
- Created: 2022-07-20T21:24:31.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-01-15T09:48:21.000Z (over 3 years ago)
- Last Synced: 2025-04-02T20:53:28.674Z (over 1 year ago)
- Language: Java
- Size: 79.1 KB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Better-Layout [](https://jitpack.io/#Osiris-Team/Better-Layout)
Probably the best and most modern layout for Java AWT/Swing (Java 8 or higher required)
```java
// ... window code not shown
BLayout rootLayout = new BLayout();
this.setContentPane(rootLayout);
rootLayout.isDebug = true;
rootLayout.access(() -> { // No need to call revalidate on any component inside here
BLayout lyTitle = new BLayout(rootLayout, true); // true = crop to content
rootLayout.addV(lyTitle);
JLabel title = new JLabel(), subtitle = new JLabel();
title.setText("My title");
title.putClientProperty("FlatLaf.style", "font: 200% $semibold.font");
lyTitle.addH(titleAutoPlug).paddingLeft();
subtitle.setText("| my subtile");
subtitle.putClientProperty("FlatLaf.style", "font: 200% $light.font");
lyTitle.addH(titleTray).paddingLeft();
rootLayout.addV(new JLabel("VERTICAL")); // Basically the same as "\n" in a string.
rootLayout.addH(new JLabel("HORIZONTAL"), new JLabel("HORIZONTAL"), new JLabel("HORIZONTAL"));
rootLayout.addV(new JLabel("VERTICAL"));
rootLayout.addH(new JLabel("HORIZONTAL"));
new BLayout(rootLayout, 30, 10) // 30% width and 10% height
.addV(new JLabel("Lorem ipsum dolor sit amet! "),
new JLabel("Lorem ipsum dolor sit amet! "),
new JLabel("Lorem ipsum dolor sit amet Lorem ipsum dolor sit amet Lorem ipsum dolor sit amet Lorem ipsum dolor sit amet Lorem ipsum dolor sit amet"),
new JLabel("Lorem ipsum dolor sit amet! "),
new JLabel("Lorem ipsum dolor sit amet! "))
.makeScrollable(); // This adds the scroll layout to the rootLayout
JTabbedPane tabbedPane = new JTabbedPane();
tabbedPane.addTab("hello!", new BLayout()); // 100% of window
rootLayout.addV(tabbedPane);
});
```
### Features
- Compatible with all Java AWT/Swing components and containers.
- No need to write constraints/styles in strings, everything available through methods.
#### Design choices:
- Better-Layout tries to combine vertical & horizontal layouts
and to reduce the amount of indidual child layouts needed to create more complex layouts.
- Each child element has its own style attributes.
- Absolute positioning thorugh relative parent sizes.
- TODO: Responsive layout support.
#### Styles per component:
- Horizontal and Vertical positioning.
- Right, left, top and bottom padding.
#### Container methods for:
- Easy validation/revalidation of itself, parent and child containers via `access()` method.
- Easy addition of components vertically or horizontally via `addV()` and `addH()` methods.
- Methods to make the layout scrollable and to scroll to horizontal/vertical start/end.