Icon 图标
基于本地 SVG 图标资源的图标组件,支持通过 name 引用内置图标或使用默认插槽传入自定义 SVG 路径。
使用方式
组件以 EmIcon 为名导出,全局注册后可直接使用:
vue
<template>
<em-icon name="check/single">
<path d="..." />
</em-icon>
</template>name 为图标的唯一标识(用于注册与索引),图标形状通过默认插槽传入 SVG 路径。
尺寸
颜色
color 属性对描边图标(stroke="currentColor")与填充图标(fill="currentColor")均生效,无需针对 filled 图标额外使用 :style 传色。
动画
API
Icon API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| name | string | — | 图标名称,格式 "category/icon-name",如 "trash";传入 name 后无需 slot |
| size | number | 20 | 图标尺寸(px),同时作用于宽高,默认 20 |
| color | string | 'currentColor' | 图标颜色,默认 currentColor(跟随文字颜色);描边图标与填充图标均适用 |
| type | 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | — | 语义色类型;与 color 同时存在时 color 优先级更高 |
| anim | 'spin' | 'pulse' | 'shake' | 'flash' | — | 内置动画:spin 旋转(无限)/ pulse 脉冲(无限)/ shake 摇摆(一次)/ flash 闪烁(一次)。 时长与曲线跟随主题动画 token(--uikit-anim-duration / --uikit-anim-easing), 全局动画开关与 prefers-reduced-motion 自动生效;触发一次性动画请用 :key 或切换 anim 值。 |
