Skip to content

Probably the best and most modern layout for Java AWT/Swing

License

Notifications You must be signed in to change notification settings

Osiris-Team/Better-Layout

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Better-Layout

Probably the best and most modern layout for Java AWT/Swing (Java 8 or higher required)

// ... 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.

About

Probably the best and most modern layout for Java AWT/Swing

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages