Skip to main content

CupertinoNavigationBar

An iOS-styled bottom navigation tab bar.

Navigation bars offer a persistent and convenient way to switch between primary destinations in an app.

Examples​

Live example

A simple CupertinoNavigationBar​

python/controls/cupertino/cupertino-navigation/cupertino-navigation-bar-example.py
loading...

Properties​

active_color​

The foreground color of the icon and title of the selected destination.

bgcolor​

The color of the navigation bar itself.

border​

Defines the border of this navigation bar. The value is an instance of Border class.

destinations​

Defines the appearance of the button items that are arrayed within the navigation bar.

The value must be a list of two or more NavigationBarDestination instances.

icon_size​

The size of all destination icons.

Defaults to 30.

inactive_color​

The foreground color of the icon and title of the unselected destinations.

selected_index​

The index into destinations for the current selected NavigationBarDestination or None if no destination is selected.

Events​

on_change​

Fires when selected destination changed.