跳到主要内容

选项卡

选项卡控件用于导航频繁访问的、明显不同的内容类别。选项卡允许在两个或多个内容视图之间导航，并依赖文本标题来表达不同部分的内容。

示例​

Live 示例

选项卡​

import flet as ft

def main(page: ft.Page):

    t = ft.Tabs(
        selected_index=1,
        animation_duration=300,
        tabs=[
            ft.Tab(
                text="Tab 1",
                content=ft.Container(
                    content=ft.Text("这是 Tab 1"), alignment=ft.alignment.center
                ),
            ),
            ft.Tab(
                tab_content=ft.Icon(ft.icons.SEARCH),
                content=ft.Text("这是 Tab 2"),
            ),
            ft.Tab(
                text="Tab 3",
                icon=ft.icons.SETTINGS,
                content=ft.Text("这是 Tab 3"),
            ),
        ],
        expand=1,
    )

    page.add(t)

ft.app(target=main)

Tabs 属性​

animation_duration​

切换选项卡时的动画持续时间，以毫秒为单位。默认为 50。

clip_behavior​

内容将根据此选项被剪辑（或不被剪辑）。属性值是 ClipBehavior 。

divider_color​

分隔符的颜色。

divider_height​

分隔符的高度。默认为 1.0。

enable_feedback​

是否检测手势提供音频和/或触觉反馈。在 Android 上，例如，将其设置为 True 将产生点击声音，并且长按将产生短暂的振动。

默认为 True。

indicator_border_radius​

指示器角的半径。

indicator_border_side​

选定选项卡下方的水平线的颜色和权重。

indicator_color​

指示器（选定选项卡下方的线）的颜色。

indicator_padding​

将选定选项卡的下划线相对于选项卡边界定位。可以使用 indicator_tab_size 属性来定义选项卡指示器的边界，以中心选项卡小部件为 False，或整个选项卡为 True。

indicator_tab_size​

如果为 True，则指示器将占据整个选项卡。

indicator_thickness​

指示器的厚度。值必须大于零。默认为 3.0，当 secondary=False 时，否则为 3.0。

is_secondary​

是否创建次级/嵌套选项卡。次级选项卡用于在内容区域内进一步分隔相关内容，以建立层次结构。

默认为 False。

label_color​

选定选项卡标签的颜色color 。

label_padding（标签填充）​

选项卡标签周围的填充。

值的类型为Padding。

label_text_style（标签文本样式）​

选项卡标签的文本样式。

值的类型为TextStyle。

mouse_cursor​

鼠标指针进入或悬停在此控件上时显示的光标。 值是 MouseCursor 。

overlay_color​

定义不同 ControlState 状态下的墨水响应焦点、悬停和溅射颜色。 支持以下 ControlState 值：PRESSED、HOVERED 和 FOCUSED。

padding​

“标签页（Tabs）”控件周围的内边距。

值的类型为Padding。

selected_index​

当前选中标签页的索引。

scrollable​

这个标签栏是否可以水平滚动。

如果scrollable为True，那么每个标签页的宽度根据其标签所需而定，并且整个“标签页（Tabs）”控件是可滚动的。否则，每个标签页在可用空间中获得相等的份额。

splash_border_radius​

定义超出标签边界的飞溅效果的裁剪半径。

值的类型为BorderRadius。

tab_alignment​

指定选项卡控件内选项卡的水平对齐方式。

值的类型为 TabAlignment ，如果 scrollable=True ，则默认值为 TabAlignment.START ；如果 scrollable=False ，则默认值为 TabAlignment.FILL 。

tabs​

一个 Tab 控件列表。

unselected_label_text_style​

未选中标签的文本样式。

值的类型为TextStyle。

Tabs事件​

on_change​

当selected_index改变时触发。

on_click​

当点击一个标签页时触发。

Tab 属性​

content​

在选项卡被选定时显示的控件。

icon​

在选项卡左侧显示的图标。

tab_content​

表示自定义选项卡内容的控件，替换 text 和 icon。

text​

选项卡的显示名称。