Quick search

Table Of Contents

PageLayout

_images/pagelayout.gif

The PageLayout class is used to create a simple multi-page layout, in a way that allows easy flipping from one page to another using borders.

PageLayout does not currently honor the size_hint, size_hint_min, size_hint_max, or pos_hint properties.

New in version 1.8.0.

Example:

PageLayout:
    Button:
        text: 'page1'
    Button:
        text: 'page2'
    Button:
        text: 'page3'

Transitions from one page to the next are made by swiping in from the border areas on the right or left hand side. If you wish to display multiple widgets in a page, we suggest you use a containing layout. Ideally, each page should consist of a single layout widget that contains the remaining widgets on that page.

class kivy.uix.pagelayout.PageLayout(**kwargs)[source]

Bases: kivy.uix.layout.Layout

PageLayout class. See module documentation for more information.

border

The width of the border around the current page used to display the previous/next page swipe areas when needed.

border is a NumericProperty and defaults to 50dp.

page

The currently displayed page.

page is a NumericProperty and defaults to 0.

swipe_threshold

The thresold used to trigger swipes as percentage of the widget size.

swipe_threshold is a NumericProperty and defaults to .5.