Button 按钮
常用的按钮。
基础用法
使用 type、plain、round、dashed 和 circle 来定义按钮的样式。
禁用按钮
disabled 属性决定按钮是否被禁用。
使用 disabled 属性来决定按钮是否被禁用。 它接受一个 Boolean 值。
链接按钮
警告
type="text" 已**废弃**,并将于 3.0.0 **移除**,请考虑切换到新 API。
新 API link 已在 2.2.1 中添加,你可以使用 type API 来设置链接按钮的主题。
文本按钮
提示
文本按钮自 2.2.0 进行了设计升级。如果你想使用之前版本的链接样式的按钮,可以查看 Link。
API 也已更新,因为 type 属性也代表按钮的样式,所以我们必须为文本按钮创建一个新的 API text: boolean。
没有边框和背景的按钮。
图标按钮
使用图标可以为按钮添加更多含义。 你可以单独使用图标来节省空间,或者将其与文本结合使用。
使用 icon 属性添加图标。 你可以在 Element Plus 图标组件中找到图标列表。 也可以通过 <i> 标签将图标添加到文本右侧。 自定义图标也可以使用。
按钮组
以按钮组的形式显示,可用于对一系列相似的操作进行分组。
在 2.11.9 中你可以使用 direction 属性。
使用标签 <el-button-group> 对按钮进行分组。
加载状态按钮
点击按钮加载数据,此时按钮显示加载状态。
设置 loading 属性为 true 以显示加载状态。
提示
你可以使用 loading 插槽或 loadingIcon 来自定义你的加载组件。
ps:loading 插槽的优先级高于 loadingIcon。
尺寸
除了默认尺寸,按钮组件还提供了另外三种尺寸,供你在不同场景下选择。
使用 size 属性来设置额外的尺寸,可选值为 large、small。
标签 2.3.4
你可以自定义元素标签,例如 button、div、a、router-link、nuxt-link。
自定义颜色 beta
你可以自定义按钮颜色。
我们将自动计算悬停颜色和激活颜色。
自 2.13.7 起,color 属性也适用于 link 和 text 按钮。
按钮 API
按钮属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| size | 按钮尺寸 | 枚举 | — |
| type | 按钮类型,当设置 color 时,后者优先 | 枚举 | — |
| 朴素 | 判断是否为朴素按钮 | boolean | false |
| 文本按钮 2.2.0 | 判断是否为文本按钮 | boolean | false |
| 背景 2.2.0 | 决定文本按钮的背景颜色是否始终显示 | boolean | false |
| 链接 2.2.1 | 决定是否为链接按钮 | boolean | false |
| 圆角 | 判断是否为圆形按钮 | boolean | false |
| 圆形 | 决定是否为圆形按钮 | boolean | false |
| 虚线 2.13.3 | 决定是否为虚线按钮 | boolean | false |
| 加载中 | 是否为加载状态 | boolean | false |
| 加载图标 | 自定义加载图标组件 | string / Component | 加载中 |
| disabled | 禁用按钮 | boolean | false |
| icon | 图标组件 | string / Component | — |
| 自动聚焦 | 等同于原生按钮的 autofocus 属性 | boolean | false |
| 原生类型 | 等同于原生按钮的 type 属性 | 枚举 | button |
| 自动插入空格 | 自动在两个中文字符之间插入一个空格(这只在文本长度为2且所有字符都是中文时生效。) | boolean | false |
| color | 自定义按钮颜色,自动计算 hover 和 active 颜色。自 2.13.7 起支持 link/text 按钮 | string | — |
| 暗黑模式 | 暗黑模式,自动将 color 转换为暗黑模式颜色 | boolean | false |
| 标签 2.3.4 | 自定义元素标签 | string / Component | button |
按钮插槽
| 名称 | 描述 |
|---|---|
| default | 自定义默认内容 |
| 加载中 | 自定义加载组件 |
| icon | 自定义图标组件 |
按钮 Exposes
| 名称 | 描述 | 类型 |
|---|---|---|
| ref | 按钮 HTML 元素 | object |
| size | 按钮尺寸 | object |
| type | 按钮类型 | object |
| disabled | 按钮是否禁用 | object |
| 是否添加空格 | 是否添加空格 | object |
按钮组 API
按钮组属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| size | 控制该按钮组内按钮的尺寸 | 枚举 | — |
| type | 控制该按钮组内按钮的类型 | 枚举 | — |
| 排列方向 2.11.9 | 显示方向 | 枚举 | horizontal |
按钮组插槽
| 名称 | 描述 | 子标签 |
|---|---|---|
| default | 自定义按钮组内容 | 按钮 |