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' | 按钮尺寸 |
block | boolean | false | 是否为块级按钮 |
loading | boolean | false | 是否加载中 |
disabled | boolean | false | 是否禁用 |
round | boolean | false | 是否圆角胶囊按钮 |
circle | boolean | false | 是否圆形图标按钮 |
active | boolean | false | 是否激活状态(用于切换按钮) |
htmlType | 'button' | 'submit' | 'reset' | 'button' | 原生 button type 属性 |
Events
| 事件名 | 类型 | 说明 |
|---|---|---|
click | (event: MouseEvent) => void | 按钮点击事件(禁用和加载状态不会触发) |
Slots
| 插槽名 | 说明 |
|---|---|
default | 按钮内容 |
icon | 前置图标插槽 |
suffix-icon | 后置图标插槽 |