字體

loadFontFace

TIP

該API使用方法為： wx.loadFontFace(Object object)

• 功能說明： 動態加載網絡字體，文件地址需為下載類型，需在js中調用。

  TIP

  • 字體文件返回的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 Font links need to have https enabled and cross-domain settings turned on
wx.loadFontFace({
  family: ‘Bitstream Vera Serif Bold’,
  family: ‘MyFont’.
  source: ‘url(’https://sungd.github.io/Pacifico.ttf‘)’,
  Success: console.log
})

page {
  font-family: 'MyFont';
}