跳到主要内容

视图 View

View是所有其他控件的最高级容器。

在新的用户会话开始时，会自动创建一个根视图。从布局角度来看，View表示一个Column控件，因此具有类似的行为和共享相同的属性。

属性​

appbar​

要在页面顶部显示的AppBar控件。

auto_scroll​

如果子控件更新时滚动条应自动移动到末尾，则为True。对于scroll_to()方法有效，必须为False。

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，表示在页面的左侧。

属性值是一个CrossAxisAlignment枚举，具有以下值：

  • START (默认值)
  • CENTER
  • END
  • STRETCH
  • BASELINE

on_scroll_interval​

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

padding​

页面内容与页面边缘之间的间距。默认值为每个边缘的10像素。要设置零间距：

page.padding = 0
page.update()

有关更多信息和可能的值，请参见Container.padding。

scroll​

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

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

支持的值：

  • None (默认值) - 行不可滚动，其内容可能溢出。
  • AUTO - 启用滚动，并且只有在发生滚动时才显示滚动条。
  • ADAPTIVE - 启用滚动，并且无论在Web或桌面上运行时，滚动条始终显示。
  • ALWAYS - 启用滚动，并且滚动条始终显示。
  • HIDDEN - 启用滚动，但滚动条始终隐藏。

spacing​

控件在页面上的垂直间距。默认值为10个虚拟像素。只有在alignment设置为start、end或center时才会应用间距。

vertical_alignment​

控件在垂直方向上的排列方式。

例如，MainAxisAlignment.START是默认值，将控件放在页面的顶部。

属性值是一个MainAxisAlignment枚举，具有以下值：

  • START (默认值)
  • END
  • CENTER
  • SPACE_BETWEEN
  • SPACE_AROUND
  • SPACE_EVENLY

方法​

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

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

有关方法详细信息和示例，请参见Column.scroll_to()。

事件​

on_scroll​

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

有关事件详细信息和示例，请参见Column.on_scroll。