Element Plus 内置多种 Icon 图标，可参考 Element Plus —— Icon 图标 (opens new window) 的文档。

在项目的 /src/assets/svgs (opens new window) 目录下，自定义了 Icon 图标，默认注册到全局中，可以在项目中任意地方使用。如下图所示：

# 1. Icon 图标组件

Icon 组件位于 src/components/Icon (opens new window) 内，用于项目内组件的展示，基本支持所有图标库（支持按需加载，只打包所用到的图标），支持使用本地 svg 和 Iconify (opens new window) 图标。

# 1.1 基本用法

如果以 svg-icon: 开头，则会在本地中找到该 svg 图标，否则，会加载 Iconify 图标。代码如下：

1
2
3
4
5
6
7

<template>
  <!-- 加载本地 svg -->
  <Icon icon="svg-icon:peoples" />

  <!-- 加载 Iconify -->
  <Icon icon="ep:aim" />
</template>

# 1.2 useIcon

如果需要在其他组件中如 ElButton 传入 icon 属性，可以使用 useIcon。代码如下：

1
2
3
4
5
6
7
8
9
10

<script setup lang="ts">
import { useIcon } from '@/hooks/web/useIcon'
import { ElButton } from 'element-plus'

const icon = useIcon({ icon: 'svg-icon:save' })
</script>

<template>
  <ElButton :icon="icon"> button </ElButton>
</template>

useIcon 的 props 属性如下：

# 2. 自定义图标

① 访问 https://www.iconfont.cn/ (opens new window) 地址，搜索你想要的图标，下载 SVG 格式。如下图所示：

② 将 SVG 图标添加到 /src/assets/svgs (opens new window) 目录下，然后进行使用。

1

<Icon icon="svg-icon:helpless" />