HarmonyOS NEXT开发案例01注册自定义字体使用自定义字体使用fontFamily属性可以设置文本的字体列表

案例说明

在开发一些应用软件时，会使用独特的字体来增强应用的个性化特色，使用应用更具辨识度。本案例将向您介绍如何使用自定义字体。实例运行效果如下图所示。

在通用属性中，我们可以使用文本样式设置文本的样式，其中fontFamily属性可以设置字体列表。支持注册自定义字体。

要实现自定义字体就需要导入注册自定义字体模块，该模块提供注册自定义字体。如下所示。

import font from '@ohos.font';

调用registerFont方法，就可以注册自定义字体，如下所示。

registerFont(options: FontOptions): void

其中FontOptions就是注册的自定义字体信息。参数说明如下：

使用fontFamily属性可以设置文本的字体列表。使用多个字体，使用’,'进行分割，优先级按顺序生效。例如：‘Arial, HarmonyOS Sans’。当前支持’HarmonyOS Sans’字体和注册自定义字体。

默认情况下，文本使用系统的字体显示。如何在应用程序中使用自定义字体呢？

首先，在项目中添加字体文件。如下图所示。

我们将字体文件添加到项目的font文件夹中，font文件夹要与pages目录同级。

添加了字体文件后，该字体还是无法使用，我们需要导入注册自定义字体模块，如下所示。

import font from '@ohos.font';

导入注册自定义字体模块后，需要在字体管理中注册自定义字体。代码如下:

font.registerFont({
  familyName: 'IndieFlower',
  familySrc: '/font/IndieFlower.ttf'
})

在注册的自定义字体信息中，需要设置注册的字体名称和注册字体文件的路径。现在，您就可以使用自定义字体了，代码如下:

.fontFamily('IndieFlower')

在以上的代码中，我们使用fontFamily属性指定自定义字体的名称，现在文本就不再使用系统的字体了。如下图所示。