• uni.loadFontFace(Object object)

    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 上编辑此页面!