uni.loadFontFace(Object object)

动态加载网络字体。文件地址需为下载类型。

注意:

  • 引入中文字体,体积过大时会发生错误,建议抽离出部分中文,减少体积,或者用图片替代
  • 字体链接必须是https。
  • 字体链接必须是同源下的,或开启了cors支持,微信小程序的域名是servicewechat.com
  • canvas等原生组件不支持使用接口添加的字体
  • 工具里提示 Faild to load font可以忽略平台差异说明
5+AppH5微信小程序支付宝小程序百度小程序头条小程序
1.9.0+ 自定义组件编译模式x基础库 2.1.0+xxx

参数说明

属性类型默认值必填说明
familyString定义的字体名称
sourceString字体资源的地址。建议格式为 TTF 和 WOFF,WOFF2 在低版本的iOS上会不兼容。
descObject可选的字体描述符
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

Object.desc 的结构

属性类型默认值必填说明
styleStringnormal字体样式,可选值为 normal / italic / oblique
weightStringnormal字体粗细,可选值为 normal / bold / 100 / 200../ 900
variantStringnormal设置小型大写字母的字体显示文本,可选值为 normal / small-caps / inherit

代码示例

  1. uni.loadFontFace({
  2. family: 'Bitstream Vera Serif Bold',
  3. source: 'url("https://sungd.github.io/Pacifico.ttf")',
  4. success() {
  5. console.log('success')
  6. }
  7. })

发现错误?想参与编辑?在 GitHub 上编辑此页面!