Button 按钮

常用的操作按钮。

基础用法

基础的按钮用法。
BUTTON.png
使用typeplainround属性来定义 Button 的样式。

  1. <div>
  2. <el-button>默认按钮</el-button>
  3. <el-button type="primary">主要按钮</el-button>
  4. <el-button type="success">成功按钮</el-button>
  5. <el-button type="info">信息按钮</el-button>
  6. <el-button type="warning">警告按钮</el-button>
  7. <el-button type="danger">危险按钮</el-button>
  8. </div>
  9. <div style="margin: 20px 0">
  10. <el-button plain>朴素按钮</el-button>
  11. <el-button type="primary" plain>主要按钮</el-button>
  12. <el-button type="success" plain>成功按钮</el-button>
  13. <el-button type="info" plain>信息按钮</el-button>
  14. <el-button type="warning" plain>警告按钮</el-button>
  15. <el-button type="danger" plain>危险按钮</el-button>
  16. </div>
  17. <div>
  18. <el-button round>圆形按钮</el-button>
  19. <el-button type="primary" round>主要按钮</el-button>
  20. <el-button type="success" round>成功按钮</el-button>
  21. <el-button type="info" round>信息按钮</el-button>
  22. <el-button type="warning" round>警告按钮</el-button>
  23. <el-button type="danger" round>危险按钮</el-button>
  24. </div>

禁用状态

按钮不可用状态。

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

  1. <div>
  2. <el-button disabled>默认按钮</el-button>
  3. <el-button type="primary" disabled>主要按钮</el-button>
  4. <el-button type="success" disabled>成功按钮</el-button>
  5. <el-button type="info" disabled>信息按钮</el-button>
  6. <el-button type="warning" disabled>警告按钮</el-button>
  7. <el-button type="danger" disabled>危险按钮</el-button>
  8. </div>
  9. <div style="margin-top: 20px">
  10. <el-button plain disabled>朴素按钮</el-button>
  11. <el-button type="primary" plain disabled>主要按钮</el-button>
  12. <el-button type="success" plain disabled>成功按钮</el-button>
  13. <el-button type="info" plain disabled>信息按钮</el-button>
  14. <el-button type="warning" plain disabled>警告按钮</el-button>
  15. <el-button type="danger" plain disabled>危险按钮</el-button>
  16. </div>

文字按钮

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

  1. <el-button type="text">文字按钮</el-button>
  2. <el-button type="text" disabled>文字按钮</el-button>

图标按钮

带图标的按钮可增强辨识度(有文字)或节省空间(无文字)。

按钮.png

设置icon属性即可,icon 的列表可以参考 Element 的 icon 组件,也可以设置在文字右边的 icon ,只要使用i标签即可,可以使用自定义图标。

  1. <el-button type="primary" icon="el-icon-edit"></el-button>
  2. <el-button type="primary" icon="el-icon-share"></el-button>
  3. <el-button type="primary" icon="el-icon-delete"></el-button>
  4. <el-button type="primary" icon="el-icon-search">搜索</el-button>
  5. <el-button type="primary">上传<i class="el-icon-upload el-icon--right"></i></el-button>

按钮组

以按钮组的方式出现,常用于多项类似操作。

按钮组.png

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

  1. <el-button-group>
  2. <el-button type="primary" icon="el-icon-arrow-left">上一页</el-button>
  3. <el-button type="primary">下一页<i class="el-icon-arrow-right el-icon--right"></i></el-button>
  4. </el-button-group>
  5. <el-button-group>
  6. <el-button type="primary" icon="el-icon-edit"></el-button>
  7. <el-button type="primary" icon="el-icon-share"></el-button>
  8. <el-button type="primary" icon="el-icon-delete"></el-button>
  9. </el-button-group>

加载中

点击按钮后进行数据加载操作,在按钮上显示加载状态。

加载中.png

要设置为 loading 状态,只要设置loading属性为true即可。

  1. <el-button type="primary" :loading="true">加载中</el-button>

不同尺寸

Button 组件提供除了默认值以外的三种尺寸,可以在不同场景下选择合适的按钮尺寸。
不同尺寸按钮.png

额外的尺寸:mediumsmallmini,通过设置size属性来配置它们。

  1. <div>
  2. <el-button>默认按钮</el-button>
  3. <el-button size="medium">中等按钮</el-button>
  4. <el-button size="small">小型按钮</el-button>
  5. <el-button size="mini">超小按钮</el-button>
  6. </div>
  7. <div style="margin-top: 20px">
  8. <el-button round>默认按钮</el-button>
  9. <el-button size="medium" round>中等按钮</el-button>
  10. <el-button size="small" round>小型按钮</el-button>
  11. <el-button size="mini" round>超小按钮</el-button>
  12. </div>

Attributes

参数 说明 类型 可选值 默认值
size 尺寸 string medium / small / mini
type 类型 string primary / success / warning / danger / info / text
plain 是否朴素按钮 boolean false
round 是否圆形按钮 boolean false
loading 是否加载中状态 boolean false
disabled 是否禁用状态 boolean false
icon 图标类名 string
autofocus 是否默认聚焦 boolean false
native-type 原生 type 属性 string button / submit / reset button