mirror of
https://gitee.com/ElemeFE/element.git
synced 2024-12-05 13:48:03 +08:00
5.6 KiB
5.6 KiB
Button 按钮
常用的操作按钮。
基础用法
基础的按钮用法。
:::demo Button 组件默认提供7种主题,由type
属性来定义,默认为default
。
<el-button>默认按钮</el-button>
<el-button type="primary">主要按钮</el-button>
<el-button type="text">文字按钮</el-button>
:::
禁用状态
按钮不可用状态。
:::demo 你可以使用disabled
属性来定义按钮是否可用,它接受一个Boolean
值。
<el-button :plain="true" :disabled="true">主要按钮</el-button>
<el-button type="primary" :disabled="true">主要按钮</el-button>
<el-button type="text" :disabled="true">文字按钮</el-button>
:::
有颜色倾向
不同的颜色倾向代表不同的提示
:::demo 朴素按钮同样设置了不同的type
属性对应的样式(可选值同上),默认为info
。设置plain
属性,它接受一个Boolean
。注意,在该情况下,type
虽然可以为text
,但是是没有意义的,会显示为text button
的样式。
<div class="block">
<span class="demonstration">默认显示颜色</span>
<span class="wrapper">
<el-button type="success">成功按钮</el-button>
<el-button type="warning">警告按钮</el-button>
<el-button type="danger">危险按钮</el-button>
<el-button type="info">信息按钮</el-button>
</span>
</div>
<div class="block">
<span class="demonstration">hover 显示颜色</span>
<span class="wrapper">
<el-button :plain="true" type="success">成功按钮</el-button>
<el-button :plain="true" type="warning">警告按钮</el-button>
<el-button :plain="true" type="danger">危险按钮</el-button>
<el-button :plain="true" type="info">信息按钮</el-button>
</span>
</div>
:::
图标按钮
带图标的按钮可增强辨识度(有文字)或节省空间(无文字)。
:::demo 设置icon
属性即可,icon 的列表可以参考 Element 的 icon 组件,也可以设置在文字右边的 icon ,只要使用i
标签即可,可以使用自定义图标。
<el-button type="primary" icon="edit"></el-button>
<el-button type="primary" icon="share"></el-button>
<el-button type="primary" icon="delete"></el-button>
<el-button type="primary" icon="search">搜索</el-button>
<el-button type="primary">上传<i class="el-icon-upload el-icon--right"></i></el-button>
:::
按钮组
以按钮组的方式出现,常用于多项类似操作。
:::demo 使用<el-button-group>
标签来嵌套你的按钮。
<el-button-group>
<el-button type="primary" icon="arrow-left">上一页</el-button>
<el-button type="primary">下一页<i class="el-icon-arrow-right el-icon--right"></i></el-button>
</el-button-group>
<el-button-group>
<el-button type="primary" icon="edit"></el-button>
<el-button type="primary" icon="share"></el-button>
<el-button type="primary" icon="delete"></el-button>
</el-button-group>
:::
加载中
点击按钮后进行数据加载操作,在按钮上显示加载状态。
:::demo 要设置为 loading 状态,只要设置loading
属性为true
即可。
<el-button type="primary" :loading="true">加载中</el-button>
:::
不同尺寸
Button 组件提供除了默认值以外的三种尺寸,可以在不同场景下选择合适的按钮尺寸。
:::demo 额外的尺寸:large
、small
、mini
,通过设置size
属性来配置它们。
<el-button type="primary" size="large">大型按钮</el-button>
<el-button type="primary">正常按钮</el-button>
<el-button type="primary" size="small">小型按钮</el-button>
<el-button type="primary" size="mini">超小按钮</el-button>
:::
Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
size | 尺寸 | string | large,small,mini | — |
type | 类型 | string | primary,success,warning,danger,info,text | — |
plain | 是否朴素按钮 | Boolean | — | false |
loading | 是否加载中状态 | Boolean | — | false |
disabled | 是否禁用状态 | boolean | — | false |
icon | 图标,已有的图标库中的图标名 | string | — | — |
autofocus | 是否默认聚焦 | boolean | — | false |
native-type | 原生 type 属性 | string | button,submit,reset | button |