::: tip 组件名：uni-icons
> 代码块： `uIcons`
[点击下载&安装](https://ext.dcloud.net.cn/plugin?name=uni-icons)
:::
用于展示 icon 图标 。
## 介绍
### 基本用法
```html
```
## 图标示例
**点击复制图标类型**
## API
### Icons Props
|属性名 |类型 |默认值 |说明 |
|:-: |:-: |:-: |:-: |
|size |Number |24 |图标大小 |
|type |String |- |图标图案，参考示例 |
|color |String |- |图标颜色 |
|customPrefix |String |- |自定义图标|
### Icons Events
|事件名 |说明 |返回值|
|:-: |:-: |:-: |
|@click|点击 Icon 触发事件|- |
## 自定义图标
::: warning 注意
nvue 页面暂时不支持自定义图标，如需在 nvue 中使用 ，请自行引入字体文件
:::
`uni-icons` 已经收录了日常开发中常用的图标 ，但是因为体积问题 ，不可能一直无限添加新图标 ，所以`uni-icons` 也提供了扩展的方法。
使用 `custom-prefix` 和 `type` 属性自定义图标
```html
```
### 获取图标
**以下所有说明都是基于[阿里图标库](https://www.iconfont.cn/)进行扩展，其他图标库同理，明白原理即可方便扩展**
1. 访问 [阿里图标库](https://www.iconfont.cn/)，搜索图标并加入购物车：
2. 点击页面右上角购物车图标 ，点击`添加至项目`，如没有项目，需要点击下图第二步的图标添加一个项目目录，如已经有项目则可以略过第二步，选择项目后点击确定：
3. 确定后进入项目，点击项目设置 ，对图标库进行一些设置：
4. 项目名称和项目描述根据自己需求填写， `fontClass` 是图标的前缀 ，需要传入组件`type`属性，`fontFamily` 是图标集名称，需要传入组件`custom-prefix` 属性，字体格式可以只勾选 `ttf`:
5. 点击保存后 ，可以下载图库库到本地：
6. 下载解压后，需要用到的文件暂时有两个 `iconfont.css`、`iconfont.ttf`:
7. 将 `iconfont.ttf`、`iconfont.css` 放到项目根目录 `static` 下。
8. 打开 `iconfont.css` ,修改 `@font-face` 如下,注意 src 字体文件的引用路径是否正确：
```css
@font-face {
font-family: "iconfont";
src: url('/static/iconfont.ttf') format('truetype');
}
.iconfont {
font-family: "iconfont" !important;
font-size: 16px;
}
.icon-search:before {
content: "\e65c";
}
```
通过上述操作 ，现在就获得一个可以自定义的图标库，
### 在 vue 页面使用自定义图标
在项目根目录的 `App.vue` 中，引入上述的 `iconfont.css`，注意自己存放的路径，且通过 `@import` 引入的外部样式，需要写在 `style` 标签有效内容中的最前面
```html
```
使用 `custom-prefix` 和 `type` 属性自定义图标
```html
```
注意：因为本质上还是使用的字体，所以多色图标还是不支持的。