跳到正文

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 ​

属性类型默认值说明
namestring—图标名称,格式 "category/icon-name",如 "trash";传入 name 后无需 slot
sizenumber20图标尺寸(px),同时作用于宽高,默认 20
colorstring'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 值。