https://github.com/kivy-garden/splittergrid

A configurable grid layout that allow user to resize the cols and rows.
https://github.com/kivy-garden/splittergrid

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/kivy-garden/splittergrid
• Owner: kivy-garden
• License: mit
• Created: 2020-02-17T15:41:41.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-02-17T21:41:43.000Z (almost 5 years ago)
• Last Synced: 2024-11-08T04:21:50.434Z (about 2 months ago)
• Language: Python
• Size: 5.61 MB
• Stars: 7
• Watchers: 9
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
SplitterGrid

============

[![Github Build Status](https://github.com/kivy-garden/splittergrid/workflows/Garden%20flower/badge.svg)](https://github.com/kivy-garden/splittergrid/actions)

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](captures/tb-lr.png)

bt-lr: bottom to top, left to right

![bt-lr](captures/bt-lr.png)

tb-rl: top to bottom, right to left

![tb-rl](captures/tb-rl.png)

bt-rl, bottom to top, right to left

![bt-rl](captures/bt-rl.png)

lr-tb: left to right, top to bottom

![lr-tb](captures/lr-tb.png)

lr-bt: left to right, top to bottom

![lr-bt](captures/lr-bt.png)

rl-tb: right to left, top to bottom

![rl-tb](captures/rl-tb.png)

rl-bt: rigth to left, bottom to top

![rl-bt](captures/rl-bt.png)

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](captures/resize.png)

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](CONTRIBUTING.md) and feel free to improve the flower.

License

-------

This software is released under the terms of the MIT License.

Please see the [LICENSE.txt](LICENSE.txt) file.

How to release

==============

See the garden [instructions](https://kivy-garden.github.io/#makingareleaseforyourflower) for how to make a new release.