Kivy - Layouts

---

---

The Kivy application window holds one widget at a time. Hence, if you try to add two buttons, only the second will be displayed. On the other hand, a good GUI needs different widgets i.e. labels, text input boxes, buttons etc. to be ergonomically placed. For this purpose, Kivy framework provides layouts. Layout itself is a widget capable of holding other widgets inside it. Layout therefore is called as a container widget

In Kivy, different types of layout containers are available. All of them implement Layout interface, defined in the "kivy.uix.layout" module. The Layout interface itself inherits the Widget class.

Two of the most important methods of this interface are −

• add_widget()

• remove_widget()

add_widget()

This method is used to Add a new widget as a child of this layout. Its syntax is like this −

add_widget(self, widget, *args, **kwargs)

Parameters

• widget − Widget to add to our list of children.

• index − index to insert the widget in the list. Notice that the default of 0 means the widget is inserted at the beginning of the list and will thus be drawn on top of other sibling widgets.

• canvas − Canvas to add widget's canvas to. Can be 'before', 'after' or None for the default canvas.

remove_widget

This method is used to remove a widget from the children of this widget. Here is its syntax −

remove_widget(self, widget, *args, **kwargs)

Where, the parameter "widget" stands for the widget that is to be removed from the children list.

Note that Layout is an interface, and hence it can not be used directly. The Layout classes that implement these methods are the concrete classes as in the following list −

In the subsequent chapters, we shall discuss each of these layouts in detail with relevant examples.