IconButton 图标按钮
纯图标按钮组件,支持三种变体、五种语义类型与禁用状态。
使用方式
组件以 EmIconButton 为名导出,全局注册后可直接使用:
vue
<template>
<em-icon-button icon="actions/plus" variant="solid" />
</template>变体与类型
尺寸与禁用
使用建议
| ✅ Do | ❌ Don't |
|---|---|
| 用于工具栏、标题栏等空间受限的场景 | 用 IconButton 替代带文案的主操作 |
为图标按钮提供 aria-label 或相邻文字说明 | 仅展示图标,无任何可访问标签 |
destructive 操作使用 type="danger" | 用默认色表达删除等危险语义 |
| 在列表右侧放置一组相关操作(最多 2 个) | 同一行塞入超过 3 个图标按钮 |
| H5 场景下利用组件自带的热区扩展 | 为扩大点击区域而 hack 外层 padding |
API
IconButton API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| icon | string | — | 图标名称,格式 "category/icon-name" |
| iconSize | number | undefined | 图标尺寸(px),默认 22 |
| type | 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'default' | 按钮语义类型 |
| variant | 'solid' | 'outline' | 'ghost' | 'ghost' | 视觉变体:solid 实心填充 / outline 描边 / ghost 透明 |
| size | 'small' | 'medium' | 'medium' | 按钮尺寸档位(已废弃,仅为兼容保留):全局统一为 icon 22 + padding 4 = 30×30, 传入 'small' / 'medium' 不再影响尺寸;如需特殊图标大小请用 iconSize |
| disabled | boolean | false | 是否禁用;禁用后点击不触发 click,并应用半透明/不可点击样式 |
| title | string | — | hover/tooltip 提示 |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
click | event: MouseEvent | 点击按钮时触发(disabled 时不触发),负载为原生鼠标事件 MouseEvent |
