本模块提供自定义Symbol图标资源与动效参数资源注册加载能力。

**起始版本：** 5.1.1(19)

## 导入模块

PhonePC/2in1TabletTV



```
1. import { symbolRegister } from '@kit.UIDesignKit';
```

## symbolRegister.registerSymbol

PhonePC/2in1TabletTV

registerSymbol(ttfSrc: resourceManager.Resource, jsonSrc: resourceManager.Resource): boolean

注册自定义Symbol资源。

**模型约束：** 此接口仅可在Stage模型下使用。

**系统能力：** SystemCapability.UIDesign.Core

**起始版本：** 5.1.1(19)

**参数：**

展开

| **参数名** | **类型** | 必填 | **说明** |
| --- | --- | --- | --- |
| ttfSrc | [resourceManager.Resource](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-types#resource) | 是 | 自定义Symbol图标资源。 |
| jsonSrc | [resourceManager.Resource](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-types#resource) | 是 | 自定义Symbol动效参数资源。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| boolean | 返回注册结果，true：注册成功，false：注册失败。 |

**错误码：**

以下错误码的详细介绍请参见[ArkTS API错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-design-error-code)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. |
| 801 | Device Type error. |
| 1012600002 | TTF or JSON resource out of size. |
| 1012600003 | TTF or JSON resource content error. |

**示例：**



```
1. import { symbolRegister } from '@kit.UIDesignKit';
2. import { BusinessError } from '@kit.BasicServicesKit';

4. @Entry
5. @Component
6. struct test {
7. aboutToAppear(): void {
8. try {
9. // 注册自定义的Symbol资源，在resource/rawfile目录下配置图标资源
10. let result =
11. symbolRegister.registerSymbol($rawfile("symbol/symbol_register.ttf"), $rawfile("symbol/symbol_register.json"));
12. } catch (error) {
13. let err = error as BusinessError;
14. console.error("errCode:" + err.code)
15. console.error("error " + err.message);
16. }
17. }

19. build() {
20. Column() {
21. SymbolGlyph($r('app.string.symbol_custom_phone_fill_1'))
22. }
23. }
24. }
```

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/12/v3/-1fT0DIzQQqsD4q_hlor-A/zh-cn_image_0000002568760174.png?HW-CC-KV=V1&HW-CC-Date=20260511T044209Z&HW-CC-Expire=86400&HW-CC-Sign=FB6CDB6383F18B4A4D0130A5D11599C341B4EFDB3114BDE203690445F14C2B9F)