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