抖音开放平台Logo
控制台

tt.loadFont
收藏
我的收藏

基础库 1.23.0 开始支持本方法，这是一个同步方法。

加载自定义字体文件。

前提条件无
业务背景无
使用限制无
注意事项无
相关教程无

语法

tt.loadFont(path)

参数说明

path

类型默认值必填说明最低支持版本
string是
字体文件路径，可以是代码包文件路径，也可以是 ttfile:// 协议的本地文件路径
1.23.0

返回值

类型说明最低支持版本
string
字体 family 值。加载失败时返回null
1.23.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

let famliy = tt.loadFont("/common/font_test.ttf");
if (famliy) {
  // 加载成功
  tt.showModal({
    title: "字体family值",
    content: famliy,
  });
} else {
  // 加载失败
  tt.showModal({
    title: "LoadFont Error",
  });
}