Skip to main content

View

View is the top most container for all other controls.

A root view is automatically created when a new user session started. From layout perspective the View represents a Column control, so it has a similar behavior and shares same properties.

Properties​

appbar​

A AppBar control to display at the top of the Page.

auto_scroll​

True if scrollbar should automatically move its position to the end when children updated. Must be False for scroll_to() method to work.

bgcolor​

Background color of the Page.

A color value could be a hex value in #ARGB format (e.g. #FFCC0000), #RGB format (e.g. #CC0000) or a named color from flet.colors module.

controls​

A list of Controls to display on the Page.

For example, to add a new control to a page:

page.controls.append(ft.Text("Hello!"))
page.update()

or to get the same result as above using page.add() shortcut method:

page.add(ft.Text("Hello!"))

To remove the top most control on the page:

page.controls.pop()
page.update()

drawer​

A NavigationDrawer control to display as a panel sliding from the start edge of the view.

end_drawer​

A NavigationDrawer control to display as a panel sliding from the end edge of the view.

fullscreen_dialog​

Whether this view is a full-screen dialog.

In Material and Cupertino, being fullscreen has the effects of making the app bars have a close button instead of a back button. On iOS, dialogs transitions animate differently and are also not closeable with the back swipe gesture.

route​

View's route - not currently used by Flet framework, but can be used in a user program to update page.route when a view popped.

floating_action_button​

A FloatingActionButton control to display on top of Page content.

horizontal_alignment​

How the child Controls should be placed horizontally.

Property value is CrossAxisAlignment enum. Default is START.

on_scroll_interval​

Throttling in milliseconds for on_scroll event. Default is 10.

padding​

A space between page contents and its edges. Default value is 10 pixels from each side.

Padding is an instance of padding.Padding class.

scroll​

Enables a vertical scrolling for the Page to prevent its content overflow.

Property value is an optional ScrollMode enum with None as default.

spacing​

Vertical spacing between controls on the Page. Default value is 10 virtual pixels. Spacing is applied only when alignment is set to start, end or center.

vertical_alignment​

How the child Controls should be placed vertically.

Property value is MainAxisAlignment enum. Default is START.

Methods​

scroll_to(offset, delta, key, duration, curve)​

Moves scroll position to either absolute offset, relative delta or jump to the control with specified key.

See Column.scroll_to() for method details and examples.

Events​

on_scroll​

Fires when scroll position is changed by a user.

Event handler argument is an instance of OnScrollEvent class.