tencent cloud

腾讯云超级应用服务

文档腾讯云超级应用服务小程序开发指南API界面字体

字体

PDF
聚焦模式
字号
最后更新时间： 2025-01-23 17:55:06

loadFontFace

该 API 使用方法为 wx.loadFontFace(Object object)
功能说明：动态加载网络字体，文件地址需为下载类型，需在 js 中调用。
注意：
字体文件返回的 content-type 参考 font，格式不正确时会解析失败；
为了真机器的兼容性，字体链接必须是 https;
字体链接必须是同源下的，或开启了 cors 支持，默认小程序的域名是 servicewechat.com (如果客户端有自定义域名，这里请按照自定义配置进行调整);
工具里提示 Faild to load font 可以忽略。
参数及说明：Object object
属性
类型
默认值
必填
说明
family
string
-
是
定义的字体名称
source
string
-
是
字体资源的地址。建议格式为 TTF 和 WOFF，WOFF2 在低版本的 iOS 上会不兼容
desc
object
-
否
可选的字体描述符
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用成功的回调函数
complete
function
-
否
接口调用结束的回调函数（调用成功、失败都会执行）
desc 结构值
结构属性
类型
默认值
必填
说明
style
string
normal
否
字体样式，可选值为 normal / italic / oblique
weight
string
normal
否
字体粗细，可选值为 normal / bold / 100 / 200/ 900
variant
string
normal
否
设置小型大写字母的字体显示文本，可选值为 normal / small-caps / inherit
object.success 回调函数参数：Object res
属性
类型
说明
status
string
加载字体结果
object.fail 回调函数参数：Object res
属性
类型
说明
status
string
加载字体结果
object.complete 回调函数参数：Object res
属性
类型
说明
status
string
加载字体结果
示例代码：
// https://sungd.github.io/Pacifico.ttf 字体链接需要启用https并且开启跨域设置
wx.loadFontFace({
  family: 'MyFont',
  source: 'url("https://sungd.github.io/Pacifico.ttf")',
  success: console.log
})
page {
  font-family: 'MyFont';
}

上一篇: 窗口下一篇: 交互

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈