---
navTitle: font
---
# font - 字体扩展

为系统提供多个新的字体。在制作仪表板、报表等内容时可以选用合适的字体。一个字体文件扩展包需要包括以下内容：

1. [package.json](#package.json)定义扩展的配置信息
2. `字体.ttf` - 字体的ttf文件。格式为:`字体名.ttf`，可以有多个字体文件
3. `thumbnail.png` - 扩展缩略图。格式为：`图片名.png`

## package.json

```json
{
	"name": "template-font-blank",/**扩展名，和扩展所在的目录同名**/
	"displayName": "空白字体模板",/**扩展标题**/
	"description": "一个空白的字体模板",/**扩展描述信息**/
	"version": "1.0.0",/**扩展的版本**/
	"thumbnail": "thumbnail.jpg",/**缩略图名称，可更改，建议用thumbnail.jpg**/
	"compatibilities": {
		"platform": "^4.0.0"
	},
	"author": {
		"name": "YourName",/**发布者信息**/
		"email": "name@xxx.com",
		"homePage": "https://www.succez.com/"
	},
	"categories": [
		"font"
	], /**扩展所属类别，可以属于多个类别**/
	"main": "main",
	"contributes": {
		"font": ["字体1","字体2"]
	} /**扩展字体文件名称，可以有多个**/
}
```

:::tip
在`font`属性中是字体名称的数组。
:::

字体文件格式支持：eot、otf、ttf、woff、woff2，后缀名小写，如下表格所示：

| 字体文件格式        | 文件名    |
| :--------:  | :-----:  |
| eot       | 字体.eot    |
| otf       | 字体.otf    |
| ttf       | 字体.ttf    |
| woff       | 字体.woff    |
| woff2       | 字体.woff2    |