From 82868b7742111f78f63084600dd2bd09dfe72838 Mon Sep 17 00:00:00 2001 From: yamila Date: Thu, 25 May 2023 18:18:04 +0800 Subject: [PATCH] update font Signed-off-by: yamila --- .../reference/apis/Readme-CN.md | 2 +- .../reference/apis/js-apis-font.md | 65 +++++++++++++++++++ 2 files changed, 66 insertions(+), 1 deletion(-) create mode 100644 zh-cn/application-dev/reference/apis/js-apis-font.md diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index e8a9c68a2e..c175e93b3d 100755 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -165,13 +165,13 @@ - UI界面 - [@ohos.animator (动画)](js-apis-animator.md) - [@ohos.curves (插值计算)](js-apis-curve.md) + - [@ohos.font(注册自定义字体)](js-apis-font.md) - [@ohos.matrix4 (矩阵变换)](js-apis-matrix4.md) - [@ohos.mediaquery (媒体查询)](js-apis-mediaquery.md) - [@ohos.pluginComponent(PluginComponentManager)](js-apis-plugincomponent.md) - [@ohos.promptAction (弹窗)](js-apis-promptAction.md) - [@ohos.router (页面路由)](js-apis-router.md) - [@ohos.measure (文本计算)](js-apis-measure.md) - - 图形图像 - [@ohos.animation.windowAnimationManager (窗口动画管理)](js-apis-windowAnimationManager.md) - [@ohos.application.WindowExtensionAbility (窗口扩展能力)](js-apis-application-windowExtensionAbility.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-font.md b/zh-cn/application-dev/reference/apis/js-apis-font.md new file mode 100644 index 0000000000..2a4d2cd856 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-font.md @@ -0,0 +1,65 @@ +# @ohos.font(注册自定义字体) + +本模块提供注册自定义字体。 + +> **说明** +> +> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```ts +import font from '@ohos.font' +``` + +## font.registerFont + +registerFont(options: FontOptions): void + +在字体管理中注册自定义字体。 + +**系统能力:** SystemCapability.ArkUI.ArkUI.Full + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | --------------------------- | ---- | ---------------------- | +| options | [FontOptions](#fontoptions) | 是 | 注册的自定义字体信息。 | + +## FontOptions + +| 名称 | 类型 | 必填 | 说明 | +| ---------- | ------ | ---- | ------------------------ | +| familyName | string | 是 | 设置注册的字体名称。 | +| familySrc | string | 是 | 设置注册字体文件的路径。 | + +## 示例 + +```ts +// xxx.ets +import font from '@ohos.font'; + +@Entry +@Component +struct FontExample { + @State message: string = '你好,世界' + + aboutToAppear() { + font.registerFont({ + familyName: 'medium', + familySrc: '/font/medium.ttf' + }) + } + + build() { + Column() { + Text(this.message) + .align(Alignment.Center) + .fontSize(20) + .fontFamily('medium') // medium:注册自定义字体的名字 + .height('100%') + }.width('100%') + } +} +``` + -- GitLab