Button 按钮

常用的操作按钮。

基础用法

使用 typeplainroundcircle 属性来定义按钮的样式。

禁用状态

disabled 属性决定了按钮是否为禁用状态。

你可以使用disabled属性来定义按钮是否被禁用,它接受一个Boolean值。

警告

type="text" 已被**废弃**,并**将会**在 3.0.0 版本被移除,请考虑切换到新的 API。

2.2.1 版本开始,新增了 link 属性,你可以使用 type 属性来设置链接按钮的主题

基础链接按钮

禁用链接按钮

文字按钮

提示

2.2.0 版本开始,文字按钮采用了新的设计,如果你想使用之前的版本样式,你可以查看 链接 组件。

API 也已更新,因为 type 属性现在代表按钮的样式。因此,我们为文字按钮新增了一个 API text: boolean

没有边框和背景色的按钮。

基础文字按钮

始终显示背景色

禁用文字按钮

图标按钮

使用图标为按钮添加更多的含义。你可以单独使用图标来节省空间,或者与文字一起使用。

使用 icon 属性来添加图标。你可以在 Element Plus 的图标组件中找到图标列表。通过一个 <i> 标签,可以实现将图标添加到文字的右侧。也可以使用自定义图标。

按钮组

以按钮组的形式出现,可用于将一系列相似的操作组织在一起。

使用 <el-button-group> 标签来组合你的按钮。

加载状态按钮

点击按钮来加载数据,然后按钮会显示加载状态。

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

提示

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

ps: loading 插槽的优先级高于 loadingIcon

尺寸

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

使用 size 属性来设置额外的尺寸,可选值为 largesmall

自定义标签 2.3.4

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

div
a

自定义颜色 测试版

你可以自定义按钮颜色。

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

Button API

Button 属性

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

Button 插槽

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

Button Exposes

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

ButtonGroup API

ButtonGroup 属性

名称描述类型默认值
size控制此按钮组中按钮的尺寸枚举
type控制此按钮组中按钮的类型枚举

ButtonGroup 插槽

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

来源

组件样式文档

贡献者