Skip to content

Icon 图标

基于 Element Plus Icon 增强的图标组件。

支持 Iconify 图标。

图标使用方式

图标提供多种使用方式,可根据场景选择:

1. 直接使用 Iconify 图标(推荐)

无需安装任何依赖,可直接使用 Iconify 中的 Tabler Icons 图标库。使用示例可参考 基本用法

2. 通过 UnoCSS 安装图标集

安装你所需的 Iconify 图标合集,并结合 UnoCSS 使用

bash
pnpm add -D @iconify-json/mdi

然后通过 i- 前缀使用:

vue
<bk-icon icon="i-mdi:home" />

3. Element Plus 图标

安装 Element Plus 图标集并使用:

bash
pnpm add @element-plus/icons-vue
vue
<script setup>
import { Edit } from "@element-plus/icons-vue"
</script>

<template>
  <el-icon><Edit /></el-icon>
</template>

基础用法

通过 Iconify 图标名称展示图标。

使用 icon 属性配合 Iconify 图标名称(例如 'tabler:home')。若未传入 i- 前缀,组件会自动补充。

Icon API

Icon 属性

属性名说明类型默认值
iconIconify 图标名称string
Element Plus Icon 原生属性
属性名说明类型默认值
colorSVG 标签的 fill 属性string继承自 color
sizeSVG 图标大小,宽高相等number / string继承自字体大小

Icon 插槽

插槽名说明
default extended自定义默认内容