1# @ohos.font (注册自定义字体) 2 3本模块提供注册自定义字体。 4 5> **说明** 6> 7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> 本模块接口为系统接口。 10 11## 导入模块 12 13```ts 14import font from '@ohos.font' 15``` 16 17## font.registerFont 18 19registerFont(options: FontOptions): void 20 21在字体管理中注册自定义字体。 22 23**系统能力：** SystemCapability.ArkUI.ArkUI.Full 24 25**参数：** 26 27| 参数名 | 类型 | 必填 | 说明 | 28| ------- | --------------------------- | ---- | ----------- | 29| options | [FontOptions](#fontoptions) | 是 | 注册的自定义字体信息。 | 30 31## FontOptions 32 33| 名称 | 类型 | 必填 | 说明 | 34| ---------- | ------ | ---- | ------------ | 35| familyName | string | 是 | 设置注册的字体名称。 | 36| familySrc | string | 是 | 设置注册字体文件的路径。 | 37 38## 示例 39 40```ts 41// xxx.ets 42import font from '@ohos.font'; 43 44@Entry 45@Component 46struct FontExample { 47 @State message: string = '你好，世界' 48 49 aboutToAppear() { 50 font.registerFont({ 51 familyName: 'medium', 52 familySrc: '/font/medium.ttf' 53 }) 54 } 55 56 build() { 57 Column() { 58 Text(this.message) 59 .align(Alignment.Center) 60 .fontSize(20) 61 .fontFamily('medium') // medium：注册自定义字体的名字 62 .height('100%') 63 }.width('100%') 64 } 65} 66``` 67 68