跳到主要内容

CupertinoAppBar

一个iOS风格的应用程序栏。

示例​

在线示例

基本示例​

import flet as ft

def main(page: ft.Page):
    page.theme_mode = ft.ThemeMode.LIGHT

    page.appbar = ft.CupertinoAppBar(
        leading=ft.Icon(ft.icons.PALETTE),
        bgcolor=ft.colors.SURFACE_VARIANT,
        trailing=ft.Icon(ft.icons.WB_SUNNY_OUTLINED),
        middle=ft.Text("CupertinoAppBar 示例"),
    )
    page.add(ft.Text("主体内容！"))

ft.app(target=main)

属性​

automatically_imply_leading​

控制是否在没有指定 leading 控件时自动推断它。

如果为 True 且 leading 为 null，则会自动推断出应该显示的 leading 控件。 如果为 False 且 leading 为 None，leading 区域将留给标题。如果 leading 控件不为 None，则此参数无效。

automatically_imply_middle​

控制是否在没有指定 middle 控件时自动推断它。

如果为 True 且 middle 为 null，则会自动填充一个包含当前路由标题的文本控件。如果 middle 控件不为 None，则此参数无效。

bgcolor​

用于 AppBar 的填充颜色。默认颜色由当前主题定义。

border​

应用栏的边框。 默认情况下，会渲染一个单像素的底部边框侧。

值的类型为 Border 。

elevation​

此属性控制应用程序栏下方阴影的大小。默认值为 4。

leading​

在应用程序栏开始位置显示的控件。通常是一个 Icon 或一个 IconButton。

如果 None 且 automatically_imply_leading 为 True，则会自动创建一个适当的按钮。

middle​

在应用程序栏中间显示的控件。通常是一个Text或分段控件。

padding​

定义应用程序栏内容的填充。

填充是一个 Padding 类的实例。

如果为 None，应用程序栏将采用以下默认值：

  • 垂直方向，内容将根据应用程序栏本身的高度减去状态栏的高度来调整。
  • 水平方向，填充将根据 iOS 规范设为 16 像素，除非 leading 控件是自动插入的返回按钮，此时填充为 0。

垂直填充不会改变应用程序栏的高度。

trailing​

在应用程序栏末端放置一个控件。通常是页面上额外的操作，例如搜索或编辑功能。