Button 按钮

常用的操作按钮,支持多种变体、尺寸、形状和图标。

按钮变体
通过 variant 属性设置按钮风格:
按钮尺寸
通过 size 属性设置按钮大小:
描边按钮颜色
outline 变体同样支持 danger 颜色:
圆角按钮
设置 round 属性使按钮变为胶囊形状:
图标按钮
通过 #icon 和 #suffix-icon 插槽添加前后置图标,或使用 circle 创建圆形图标按钮:
加载状态
设置 loading 属性显示加载指示器,按钮将自动禁用:
禁用状态
设置 disabled 属性禁用按钮:
块级按钮
设置 block 属性使按钮撑满父容器宽度:
激活状态
设置 active 属性标记按钮为激活状态,常用于工具栏切换:

Props

参数类型默认值说明
variant'primary' | 'secondary' | 'danger' | 'ghost' | 'outline' | 'link''primary'按钮变体风格
size'sm' | 'md' | 'lg''md'按钮尺寸
blockbooleanfalse是否为块级按钮
loadingbooleanfalse是否加载中
disabledbooleanfalse是否禁用
roundbooleanfalse是否圆角胶囊按钮
circlebooleanfalse是否圆形图标按钮
activebooleanfalse是否激活状态(用于切换按钮)
htmlType'button' | 'submit' | 'reset''button'原生 button type 属性

Events

事件名类型说明
click(event: MouseEvent) => void按钮点击事件(禁用和加载状态不会触发)

Slots

插槽名说明
default按钮内容
icon前置图标插槽
suffix-icon后置图标插槽