跳到正文

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 ​

属性类型默认值说明
iconstring—图标名称,格式 "category/icon-name"
iconSizenumberundefined图标尺寸(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
disabledbooleanfalse是否禁用;禁用后点击不触发 click,并应用半透明/不可点击样式
titlestring—hover/tooltip 提示

Events ​

事件名参数说明
clickevent: MouseEvent点击按钮时触发(disabled 时不触发),负载为原生鼠标事件 MouseEvent