小程序中使用Symbol类型图标 | 彩色图标

IconFont 阿里巴巴图标库    ||    IconPack 字节图标库

iconfont-阿里巴巴矢量图标库iconfont-国内功能很强大且图标内容很丰富的矢量图标库，提供矢量图标下载、在线存储、格式转换等功能。阿里巴巴体验团队倾力打造，设计和前端开发的便捷工具https://www.iconfont.cn/ByteDance IconParkIconPark, park your icon. Made by ByteDancehttps://iconpark.oceanengine.com/home

---

1、在小程序根目录下安装插件 mini-program-iconfont-cli

# Yarn
yarn add mini-program-iconfont-cli --dev

# Npm
npm install mini-program-iconfont-cli --save-dev

---

 2、生成配置文件

npx iconfont-init

# 可传入配置文件输出路径
# npx iconfont-init --output iconfont.json

此时项目根目录会生成一个 iconfont.json 文件，内容如下：

{
  "symbol_url": "请参考README.md，复制 http://iconfont.cn 官网提供的JS链接",
  "save_dir": "./iconfont",
  "use_rpx": false,
  "trim_icon_prefix": "icon",
  "default_icon_size": 18
}

配置参数说明：

symbol_url
复制iconfont官网提供的 Symbol 项目链接。请务必看清是.js后缀而不是.css后缀。

save_dir
根据iconfont图标生成的组件存放的位置。每次生成组件之前，该文件夹都会被清空。

use_rpx
使用微信提供的尺寸单位rpx还是普通的像素单位px。默认值为false，即使用px。

trim_icon_prefix
如果你的图标有通用的前缀，而你在使用的时候又不想重复去写，那么可以通过配置这个选项把前缀统一去掉。

default_icon_size
我们将为每个生成的图标组件加入默认的字体大小，当然，你也可以通过传入props的方式改变这个size值。

---

3、生成小程序标准组件

# 微信小程序
npx iconfont-wechat

# 支付宝小程序
npx iconfont-alipay

# 百度小程序
npx iconfont-baidu

# 头条小程序
npx iconfont-toutiao

# 快手小程序
npx iconfont-kuaishou

# QQ小程序
npx iconfont-qq

---

4、引入图标

微信小程序 | QQ小程序

// 在根目录的app.json文件中全局引入图标组件
{
    "usingComponents": {
        "iconfont": "/iconfont/iconfont"
    }
}

支付宝小程序 | 百度小程序 | 头条小程序 ｜ 快手小程序

// 不支持全局引入，您需要在各自page的.json文件中引入。
{
    "usingComponents": {
        "iconfont": "/iconfont/iconfont"
    }
}

---

5、Page页面中使用图标

// 原色彩
<iconfont name="alipay" />

// 单色：红色
<iconfont name="alipay" color="red" />

// 多色：红色+橘色
<iconfont name="alipay" color="{{['red', 'orange']}}" size="300" />

// 不同格式的颜色写法
<iconfont name="alipay" color="{{['#333', 'rgb(50, 124, 39)']}}" />

// 与文字对齐
<view style="display: flex; alignItems: center;">
  <text>Hello</text>
  <iconfont name="alipay" />
</view>

---

6、修改更新图标

# 当您在iconfont.cn中的图标有变更时，只需更改配置symbol_url，然后再次执行 步骤3 即可生成最新的图标组件。
# 修改 symbol_url 配置后执行：

# 微信小程序
npx iconfont-wechat

# 支付宝小程序
npx iconfont-alipay

# 百度小程序
npx iconfont-baidu

# 头条小程序
npx iconfont-toutiao

# 快手小程序
npx iconfont-kuaishou

# QQ小程序
npx iconfont-qq

---

mini-program-iconfont-cli 插件 GitHub 地址：

GitHub - iconfont-cli/mini-program-iconfont-cli: 把iconfont图标批量转换成多个平台小程序的标准组件。支持多色彩，支持自定义颜色把iconfont图标批量转换成多个平台小程序的标准组件。支持多色彩，支持自定义颜色. Contribute to iconfont-cli/mini-program-iconfont-cli development by creating an account on GitHub.https://github.com/iconfont-cli/mini-program-iconfont-cli#save_dir