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 |
| disabled | boolean | false | 是否禁用;禁用时按钮不可点击且不触发 click |
| loading | boolean | false | 是否加载中;显示加载动画并禁止点击(行为同 disabled) |
| block | boolean | false | 是否块级展示,占满父容器整行宽度 |
| pill | boolean | false | 是否全圆角(pill)形态,默认 false;优先级高于全局 componentsShape 的 square 修饰 |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
click | event: MouseEvent | 按钮可点击(非 disabled / 非 loading)时触发,负载为原生点击事件 MouseEvent |
