按钮

用于承载页面中的主要操作、次要操作和轻量文本操作。

基本用法

使用 typeplainrounddashedcircle 定义 Button 的样式。

禁用按钮

disabled 属性确定按钮是否被禁用。

使用 disabled 属性来确定按钮是否被禁用。它接受 Boolean 值。

链接按钮

WARNING

type="text" 已被 弃用,并且 3.0.0 中删除,请考虑切换到新的 API。

2.2.1中添加了新的API link,您可以使用type API设置链接按钮的主题

基础链接按钮

禁用链接按钮

文本按钮

TIP

文字按钮自 开始升级全新设计,如果您想使用 以前版本的按钮,您可能需要查看链接

API 也更新了,因为 type 属性也代表按钮的样式。所以我们必须制作一个新的API text: boolean 用于文本按钮。

没有边框和背景的按钮。

基础文字按钮

背景常显

禁用文字按钮

图标按钮

使用图标为按钮添加更多含义。您可以单独使用图标来节省一些空间,也可以与文本一起使用。

使用 icon 属性添加图标。您可以在Element Plus图标组件中找到图标列表。使用 <i> 标签可以将图标添加到文本右侧。也可以使用自定义图标。

按钮组

按钮组默认纵向排列;只有在底部双按钮栏等场景下,才显式设置 direction="horizontal"

使用 <el-button-group> 组织一组连续操作。

默认纵向,适合操作列表。
如果是底部双按钮栏,可显式设置为横向。

加载按钮

点击按钮加载数据,按钮显示加载状态。

loading 属性设置为 true 以显示加载状态。

TIP

您可以使用 loading 插槽或 loadingIcon 自定义您的加载组件

ps: loading slot 的优先级高于loadingIcon

尺寸

除了默认大小外,Button 组件还提供了三种额外的大小供您在不同的场景中进行选择。

使用属性 size 通过 largesmall 设置附加尺寸。

标签 2.3.4

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

容器按钮
外部链接

自定义颜色 ^(测试版)

您可以自定义按钮颜色。

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

按钮 API

Button 属性

属性名说明类型默认值
size按钮尺寸enum
type按钮类型,设置 color 时以后者为准enum
plain是否为朴素按钮booleanfalse
text 2.2.0是否为文本按钮booleanfalse
bg 2.2.0文本按钮背景色是否常亮booleanfalse
link 2.2.1是否为链接按钮booleanfalse
round是否为圆角按钮booleanfalse
circle是否为圆形按钮booleanfalse
dashed 2.13.3是否为虚线按钮booleanfalse
loading是否处于加载状态booleanfalse
loading-icon自定义加载图标组件string / ComponentLoading
disabled是否禁用booleanfalse
icon图标组件string / Component
autofocus与原生按钮 autofocus 一致booleanfalse
native-type与原生按钮 type 一致enumbutton
auto-insert-space自动在两个汉字之间插入空格(仅当文本长度为 2 且所有字符均为中文时生效)booleanfalse
color自定义按钮颜色,自动计算 hoveractive 颜色string
dark深色模式下自动将 color 转换为深色系颜色booleanfalse
tag 2.3.4自定义元素标签string / Componentbutton

Button 插槽

插槽名说明
default自定义默认内容
loading自定义加载组件
icon自定义图标组件

Button 暴露

名称说明类型
ref按钮 HTML 元素object
size按钮尺寸object
type按钮类型object
disabled按钮是否禁用object
shouldAddSpace是否自动补空格object

按钮组 API

ButtonGroup 属性

属性名说明类型默认值
size控制按钮组内按钮大小enum
type控制按钮组内按钮类型enum
direction 2.11.9排列方向enumvertical

ButtonGroup 插槽

插槽名说明子标签
default自定义按钮组内容Button