Button 按钮
按钮用于触发一个操作,如提交表单。
按钮类型
按钮支持 default、primary、success、warning、danger 五种类型,默认为 default。
朴素按钮
通过 plain
属性将按钮设置为朴素按钮,朴素按钮的文字为按钮颜色,背景为白色。
细边框
设置 hairline
属性可以展示 0.5px 的细边框。
禁用状态
通过 disabled
属性将按钮设置为禁用状态,按钮的颜色变为灰色,无法点击。
加载状态
通过 loading
属性设置按钮为加载状态,加载状态下默认会隐藏按钮文字,可以通过 loading-text
设置加载状态下的文字。
按钮形状
通过 square
设置方形按钮,通过 round
设置圆形按钮。
图标按钮
通过 icon 属性设置按钮图标,支持 Icon 组件里的所有图标,也可以传入图标 URL。
按钮尺寸
支持 large、normal、small、mini 四种尺寸,默认为 normal。
自定义颜色
通过 color
属性可以自定义按钮的颜色。
API
属性
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
type | 按钮类型,可选值为 default primary success warning danger | string | default |
size | 按钮大小,可选值为 large normal small mini | string | normal |
text | 按钮文字 | string | - |
color | 按钮颜色,支持颜色名称、十六进制颜色码、RGB 色值、渐变色 | string | - |
icon | 左侧图标,可以是 Icon 组件名称或图片链接 | string | - |
icon-prefix | 图标类名前缀,等价于 Icon 组件的 prefix 属性 | string | g-icon |
icon-position | 图标位置,可选值为 left right | string | left |
tag | 自定义标签类型 | string | button |
native-type | 原生 type 属性 | string | button |
block | 是否为块级元素 | boolean | false |
plain | 是否为朴素按钮 | boolean | false |
square | 是否为方形按钮 | boolean | false |
round | 是否为圆形按钮 | boolean | false |
disabled | 是否禁用按钮 | boolean | false |
hairline | 是否显示 0.5px 边框 | boolean | false |
loading | 是否显示为加载状态 | boolean | false |
loading-type | 加载图标类型,可选值为 spinner circular | string | circular |
loading-text | 加载状态下显示的文字 | string | - |
loading-size | 加载图标大小 | string | 20px |
url | 点击后跳转的链接地址 | string | - |
to | 点击后跳转的目标路由对象,同 vue-router 的 to 属性 | string | - |
replace | 是否在跳转时替换当前页面历史记录 | boolean | false |
事件
事件名 | 说明 | 参数 |
---|---|---|
click | 点击按钮时触发 | - |
touchstart | 触摸开始时触发 | - |
插槽
名称 | 说明 |
---|---|
default | 按钮文字 |
icon | 自定义图标 |
loading | 自定义加载指示器 |