跳到主要内容

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_CONTAINER_HIGHEST,
        trailing=ft.Icon(ft.Icons.WB_SUNNY_OUTLINED),
        middle=ft.Text("CupertinoAppBar 示例"),
    )
    page.add(ft.Text("主体内容！"))

ft.app(target=main)

属性​

automatic_background_visibility（自动背景可见性）​

当内容在其下滚动时，导航栏是否应显示为透明。

如果为False，导航栏将显示其bgcolor。

默认为True。

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 。

brightness​

指定bgcolor的亮度。

设置此值会更改系统状态栏的样式。通常用于增加系统状态栏相对于bgcolor的对比度。

如果为None（默认值），其值将从bgcolor的相对亮度推断得出。

值的类型为brightness。

elevation​

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

enable_background_filter_blur​

当使用不透明的bgcolor时是否具有模糊效果。

仅当automatic_background_visibility为False时或直到内容在导航栏下滚动时，此设置才会生效。

默认为True。

leading​

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

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

middle​

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

padding​

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

填充是一个 Padding 类的实例。

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

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

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

trailing​

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