Skip to content

按钮组 Button Group ​

此元素基于 Quasar 的 QBtnGroup 组件。

注意

你必须为按钮组和按钮使用相同的 props 设计。

python
from nicegui import ui

with ui.button_group():
    ui.button('一', on_click=lambda: ui.notify('你按下了按钮 1!'))
    ui.button('二', on_click=lambda: ui.notify('你按下了按钮 2!'))
    ui.button('三', on_click=lambda: ui.notify('你按下了按钮 3!'))

ui.run()

带下拉按钮的按钮组 ​

你也可以在按钮组中添加一个下拉按钮。

python
from nicegui import ui

with ui.button_group():
    ui.button('一')
    ui.button('二')
    with ui.dropdown_button('下拉菜单'):
        ui.item('选项 1', on_click=lambda: ui.notify('点击了选项 1'))
        ui.item('选项 2', on_click=lambda: ui.notify('点击了选项 2'))

ui.run()

按钮组样式 ​

你可以像为单个按钮一样,为按钮组应用相同的样式选项,例如 "flat"、"outline"、"push" 等。但是,你必须始终为按钮组及其包含的按钮使用相同的设计属性。

python
from nicegui import ui

with ui.button_group().props('rounded'):
    ui.button('一')
    ui.button('二')
    ui.button('三')
with ui.button_group().props('push glossy'):
    ui.button('一', color='red').props('push')
    ui.button('二', color='orange').props('push text-color=black')
    ui.button('三', color='yellow').props('push text-color=black')
with ui.button_group().props('outline'):
    ui.button('一').props('outline')
    ui.button('二').props('outline')
    ui.button('三').props('outline')

ui.run()

内容同步至 NiceGUI 3.17.1 · 更新日期: 2026 年 9 月 29 日