Button 按钮

常用的按钮。

基础用法

使用 typeplainrounddashedcircle 来定义按钮的样式。

禁用按钮

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 属性来设置额外的尺寸,可选值为 largesmall

标签 2.3.4

你可以自定义元素标签,例如 button、div、a、router-link、nuxt-link。

div
a

自定义颜色 beta

你可以自定义按钮颜色。

我们将自动计算悬停颜色和激活颜色。

2.13.7 起,color 属性也适用于 linktext 按钮。

按钮 API

按钮属性

名称描述类型默认值
size按钮尺寸枚举
type按钮类型,当设置 color 时,后者优先枚举
朴素判断是否为朴素按钮booleanfalse
文本按钮 2.2.0判断是否为文本按钮booleanfalse
背景 2.2.0决定文本按钮的背景颜色是否始终显示booleanfalse
链接 2.2.1决定是否为链接按钮booleanfalse
圆角判断是否为圆形按钮booleanfalse
圆形决定是否为圆形按钮booleanfalse
虚线 2.13.3决定是否为虚线按钮booleanfalse
加载中是否为加载状态booleanfalse
加载图标自定义加载图标组件string / Component加载中
disabled禁用按钮booleanfalse
icon图标组件string / Component
自动聚焦等同于原生按钮的 autofocus 属性booleanfalse
原生类型等同于原生按钮的 type 属性枚举button
自动插入空格自动在两个中文字符之间插入一个空格(这只在文本长度为2且所有字符都是中文时生效。)booleanfalse
color自定义按钮颜色,自动计算 hoveractive 颜色。自 2.13.7 起支持 link/text 按钮string
暗黑模式暗黑模式,自动将 color 转换为暗黑模式颜色booleanfalse
标签 2.3.4自定义元素标签string / Componentbutton

按钮插槽

名称描述
default自定义默认内容
加载中自定义加载组件
icon自定义图标组件

按钮 Exposes

名称描述类型
ref按钮 HTML 元素object
size按钮尺寸object
type按钮类型object
disabled按钮是否禁用object
是否添加空格是否添加空格object

按钮组 API

按钮组属性

名称描述类型默认值
size控制该按钮组内按钮的尺寸枚举
type控制该按钮组内按钮的类型枚举
排列方向 2.11.9显示方向枚举horizontal

按钮组插槽

名称描述子标签
default自定义按钮组内容按钮

来源

组件样式文档

贡献者