跳到正文

Button 按钮 ​

常用操作按钮,支持语义类型、尺寸、加载与禁用等状态。

使用方式 ​

组件以 EmButton 为名导出,全局注册后可直接使用:

vue
<template>
  <em-button type="primary">发送消息</em-button>
</template>

语义类型 ​

尺寸 ​

状态 ​

事件 ​

使用建议 ​

✅ Do❌ Don't
主操作使用 type="primary",次操作使用 type="default"同一区域出现多个 primary 按钮
删除、退群等不可逆操作使用 type="danger"用 primary 按钮表达危险语义
按钮文案使用动词,如「发送」「保存」「删除」使用「确定」「点击这里」等模糊文案
表单提交等耗时操作用 loading 状态反馈点击后无任何状态变化
移动端 bottom sheet 中的主操作可用 block 通栏在狭窄空间并排多个 large 按钮

API ​

Button API ​

Props ​

属性类型默认值说明
type'primary' | 'success' | 'warning' | 'danger' | 'danger-outline' | 'outline' | 'default''default'语义类型:primary / success / warning / danger / danger-outline / outline(中性描边)/ default(默认)
size'small' | 'medium' | 'large''medium'尺寸:small / medium(默认)/ large
disabledbooleanfalse是否禁用;禁用时按钮不可点击且不触发 click
loadingbooleanfalse是否加载中;显示加载动画并禁止点击(行为同 disabled)
blockbooleanfalse是否块级展示,占满父容器整行宽度
pillbooleanfalse是否全圆角(pill)形态,默认 false;优先级高于全局 componentsShape 的 square 修饰

Events ​

事件名参数说明
clickevent: MouseEvent按钮可点击(非 disabled / 非 loading)时触发,负载为原生点击事件 MouseEvent