跳到主要内容

CupertinoSlider

macOS 风格的滑块控件。它提供了可调整内容的视觉指示，以及当前设置在总内容范围内的位置。

当您想让用户设置定义的值（例如音量或亮度），或当用户从设置更改中获得即时反馈时，使用滑块控件。

示例​

Live 示例

带有 on_change、on_change_start 和 on_change_end 事件的 CupertinoSlider​

import flet as ft

def main(page):
    page.horizontal_alignment = page.vertical_alignment = "center"
    page.theme_mode = ft.ThemeMode.LIGHT

    def handle_change_start(e):
        slider_status.value = "滑动中"
        page.update()

    def handle_change(e):
        slider_value.value = str(e.control.value)
        page.update()

    def handle_change_end(e):
        slider_status.value = "滑动结束"
        page.update()

    page.add(
        slider_value := ft.Text("0.0"),
        ft.CupertinoSlider(
            divisions=5,
            max=100,
            active_color=ft.colors.PURPLE,
            thumb_color=ft.colors.PURPLE,
            on_change_start=handle_change_start,
            on_change_end=handle_change_end,
            on_change=handle_change,
        ),
        slider_status := ft.Text(),
    )


ft.app(target=main)

属性​

active_color​

滑块轨道的活动部分使用的颜色。

滑块的"活动"侧是指thumb和最小值之间的部分。

divisions​

滑块的离散分区数。

如果不设置，则滑块是连续的。

max​

用户可以选择的最大值。

默认为 1.0。必须大于或等于 min。

如果 max 等于 min，则滑块被禁用。

min​

用户可以选择的最小值。

默认为 0.0。必须小于或等于 max。

如果 max 等于 min，则滑块被禁用。

thumb_color​

滑块 thumb 的颜色。

value​

当前选定的值。

滑块的 thumb 将被绘制在对应于该值的位置。

事件​

on_blur​

控件失去焦点时触发。

on_change​

滑块状态改变时触发。

on_change_end​

用户完成选择新值时触发。

on_change_start​

用户开始选择新值时触发。

on_focus​

控件获得焦点时触发。