Skip to content

A configurable grid layout that allow user to resize the cols and rows.

License

Notifications You must be signed in to change notification settings

kivy-garden/splittergrid

Repository files navigation

SplitterGrid

Github Build Status

A GridLayout-like widget, that allows the user to manually change the relative sizes of each collumn and row. If the widget is resized, the preferences will be conserved relalively (a column resized to 10% of the total width will stay 10% of the total width). As with GridLayout, either a number column or a number of rows must be set, if both are set, then cols is used.

It also allows setting the order of filling through the orientation property, all the modes you could hope for are implemented:

tb-lr, top to bottom, left to right, which means the first column will be filled from top to bottom, then the second column, etc.

tb-lr

bt-lr: bottom to top, left to right

bt-lr

tb-rl: top to bottom, right to left

tb-rl

bt-rl, bottom to top, right to left

bt-rl

lr-tb: left to right, top to bottom

lr-tb

lr-bt: left to right, top to bottom

lr-bt

rl-tb: right to left, top to bottom

rl-tb

rl-bt: rigth to left, bottom to top

rl-bt

The margin between each cell can be dragged by the user, resizing the corresponding row or column (or both, if you drag from an intersection). min_col_width and min_row_height allowing to set constraints on user interaction. On desktop, the mouse cursor is set to arrows indicating the possibility of resizing when hovering a margin.

resizing

This layout doesn't use size_hint or size_hint_min and size_hint_max properties of its children.

The module can be ran standalone and will display a basic demonstration of the layout.

Contributing

Check out our contribution guide and feel free to improve the flower.

License

This software is released under the terms of the MIT License. Please see the LICENSE.txt file.

How to release

See the garden instructions for how to make a new release.

About

A configurable grid layout that allow user to resize the cols and rows.

Resources

License

Stars

Watchers

Forks

Packages

No packages published