跳到主要内容

视图

视图是所有其他控件的顶级容器。

当新用户会话启动时,根视图将自动创建。从布局角度看,视图表示一个 Column 控制,因此它具有相似的行为和共享相同的属性。

属性

appbar

一个显示在页面顶部的 AppBar 控制。

auto_scroll

如果滚动条应该在孩子更新时自动移动其位置到末尾,则为 True。必须为 False 才能使 scroll_to() 方法生效。

bgcolor

页面的背景颜色。

颜色值可以是 #ARGB 格式的十六进制值(例如 #FFCC0000)、#RGB 格式的十六进制值(例如 #CC0000)或来自 flet.colors 模块的命名颜色。

controls

要在页面上显示的控件列表。

例如,要将新控件添加到页面:

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

或使用 page.add() 快捷方法来达到相同的结果:

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

要删除页面上的顶部控件:

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

drawer

一个显示为从视图开始边缘滑动的面板的 NavigationDrawer 控制。

end_drawer

一个显示为从视图结束边缘滑动的面板的 NavigationDrawer 控制。

fullscreen_dialog

该视图是否为全屏对话框。

在 Material 和 Cupertino 中,全屏对话框的应用栏将具有关闭按钮,而不是返回按钮。在 iOS 上,对话框的过渡动画也不同,并且不能使用返回滑动手势关闭。

route

视图的路由 - 目前不由 Flet 框架使用,但可以在用户程序中用于更新 page.route 当视图弹出时。

floating_action_button

一个显示在页面内容上方的 FloatingActionButton 控制。

horizontal_alignment

子控件如何水平放置。

属性值是 CrossAxisAlignment 枚举。默认为 START

on_scroll_interval

on_scroll 事件的节流时间,以毫秒为单位。默认为 10。

padding

页面内容和其边缘之间的空间。默认值为每侧 10 像素。

填充是一个 padding.Padding 类的实例。

scroll

启用页面的垂直滚动,以防止内容溢出。

属性值是一个可选的 ScrollMode 枚举,默认为 None

spacing

页面上控件之间的垂直间距。默认值为 10 虚拟像素。间距仅在 alignment 设置为 startendcenter 时应用。

vertical_alignment

子控件如何垂直放置。

属性值是 MainAxisAlignment 枚举。默认为 START

方法

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

将滚动位置移动到绝对 offset、相对 delta 或跳到具有指定 key 的控件。

请参阅 Column.scroll_to() 方法的详细信息和示例。

事件

on_scroll

当用户更改滚动位置时触发。

事件处理器参数是一个 OnScrollEvent 类的实例。