跳到主要内容

滑块 CupertinoSlider

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

当您希望用户设置特定值（如音量或亮度）时，或者用户在设置更改的效果上能获得即时反馈时，可以使用滑块。

示例​

实时示例

带有 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​

用于表示滑块轨道中活动部分的颜色。

滑块的“活动”部分是指拇指与最小值之间的一侧。

divisions​

离散分割的数量。

如果没有设置，默认为连续滑块。

max​

用户可选的最大值。

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

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

min​

用户可选的最小值。

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

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

thumb_color​

拇指的颜色。

value​

此滑块当前选定的值。

滑块的拇指将在与该值对应的位置上绘制。

事件​

on_blur​

当控件失去焦点时触发。

on_change​

当滑块的状态发生变化时触发。

on_change_end​

当用户完成选择滑块的新值时触发。

on_change_start​

当用户开始选择滑块的新值时触发。

on_focus​

当控件获得焦点时触发。