微信小程序API 字體

2022-05-09 17:05 更新

wx.loadFontFace(Object object)

基礎(chǔ)庫 2.1.0 開始支持,低版本需做兼容處理。

動態(tài)加載網(wǎng)絡(luò)字體,文件地址需為下載類型。'2.10.0'起支持全局生效,需在 app.js 中調(diào)用。

注意:

  1. 字體文件返回的 contet-type 參考 font,格式不正確時會解析失敗。
  2. 字體鏈接必須是https(ios不支持http)
  3. 字體鏈接必須是同源下的,或開啟了cors支持,小程序的域名是servicewechat.com
  4. canvas等原生組件不支持使用接口添加的字體
  5. 工具里提示 Faild to load font可以忽略
  6. '2.10.0' 以前僅在調(diào)用頁面生效。

參數(shù)

Object object

屬性類型默認值必填說明最低版本
globalbooleanfalse是否全局生效2.10.0
familystring定義的字體名稱
sourcestring字體資源的地址。建議格式為 TTF 和 WOFF,WOFF2 在低版本的iOS上會不兼容。
descObject可選的字體描述符
successfunction接口調(diào)用成功的回調(diào)函數(shù)
failfunction接口調(diào)用失敗的回調(diào)函數(shù)
completefunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

object.desc 的結(jié)構(gòu)

屬性類型默認值必填說明
stylestring'normal'字體樣式,可選值為 normal / italic / oblique
weightstring'normal'字體粗細,可選值為 normal / bold / 100 / 200../ 900
variantstring'normal'設(shè)置小型大寫字母的字體顯示文本,可選值為 normal / small-caps / inherit

object.success 回調(diào)函數(shù)

參數(shù)
Object res
屬性類型說明
statusstring加載字體結(jié)果

object.fail 回調(diào)函數(shù)

參數(shù)
Object res
屬性類型說明
statusstring加載字體結(jié)果

object.complete 回調(diào)函數(shù)

參數(shù)
Object res
屬性類型說明
statusstring加載字體結(jié)果

示例代碼

在開發(fā)者工具中預(yù)覽效果

wx.loadFontFace({
  family: 'Bitstream Vera Serif Bold',
  source: 'url("https://sungd.github.io/Pacifico.ttf")',
  success: console.log
})


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號