Skip to main content

A kivy grid layout that allows user to resize columns ad rows.

Project description


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.


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.


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


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.

Project details

Release history Release notifications

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kivy-garden.splittergrid, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size kivy_garden.splittergrid-1.0-py3-none-any.whl (7.2 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page