---
navTitle: icons
---
# icons - 图标扩展

为系统提供一个新的图标集。在制作仪表板、门户App等内容时都需要选用合适的图标，系统默认已经提供了一些可选字体图标，第三方也可以扩展新的图标。

## package.json

```json
{
    // ...
    "contributes": {
        "font": "fontawesome", // 如果是字体图标，需要传递字体名称，不带后缀。支持eot、otf、ttf、woff、woff2后缀的文件。
        "icons": {
            "action": [ // 图标分类，可以是已有的图标分类，比如"action"、"tools"、"file"等等
                {
                    "desc": "笑脸",
                    "code": "0xf118" // 字体图标编码，一般用0x开头的16进制，表示特殊编码的字体字符。
                },
                {
                    "desc": "篮球",
                    "image": "篮球.webp" // 图片图标路径，相对于扩展的icons目录。
                },
                // ...
            ],
            "新分类1": [ // 图标分类，可以是新的自定义的分类，比如"新分类1"
                {
                    "desc": "点赞",
                    "image": "thumbs-up.svg"
                },
                {
                    "desc": "点踩",
                    "image": "thumbs-down.svg"
                }
                // ...
            ],
            // ...
        }
    }
}
```

扩展目录结构如下：

1. `package.json`
2. `fontawesome.ttf` - 字体图标的文件，支持ttf、woff，名称必须和`package.json`中的font设置相同。
3. `icons/` - 图标文件目录。
   2\. `xxx.png` - 图片图标
   3\. ... 可以有目录，目录里包含图片；如果有图片图标，那么一个文件一个图标