Skip to content

开关 Switch

基于 Quasar 的 QToggle 组件。

参数 Param说明 Description
text显示在开关边上的文字
value是否默认被打开 (默认值: False)
on_change当开启状态改变时的回调函数
python
from nicegui import ui

switch = ui.switch('打开我')
ui.label('已打开!').bind_visibility_from(switch, 'value')

ui.run()

处理用户交互

通过参数传递的 on_change 函数会在开关被点击以及通过 set_value 调用更改值时被调用。要仅在用户与开关交互时执行函数,您可以使用通用的 on 方法。

python
from nicegui import ui

with ui.row():
    s1 = ui.switch(on_change=lambda e: ui.notify(str(e.value)))
    ui.button('设置值', on_click=lambda: s1.set_value(not s1.value))
with ui.row():
    s2 = ui.switch().on('click', lambda e: ui.notify(str(e.sender.value)))
    ui.button('设置值', on_click=lambda: s2.set_value(not s2.value))

ui.run()
最近更新

更新日期: 2025 年 12 月 17 日