FontFaceSet: load() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

注意:此功能在 Web Workers 中可用。

FontFaceSet 介面的 load() 方法強制載入引數中給定的所有字型。

語法

js
load(font)
load(font, text)

引數

font

使用 CSS 值語法指定的字型規範,例如:“italic bold 16px Roboto”

文字

將字型限制為 Unicode 範圍包含 text 中至少一個字元的那些字型。這不會檢查單個字形覆蓋

返回值

一個 Promise,它在載入完成時使用已載入的 FontFace 物件的 Array 進行兌現。當所有字型載入完成時,Promise 將兌現;如果其中一個字型載入失敗,它將被拒絕。

示例

以下示例返回一個 Promise,該 Promise 將根據“MyFont”的載入成功與否進行兌現或拒絕。then() 中的程式碼可以假定該字型可用。

js
document.fonts.load("12px MyFont", "ß").then(/* ... */);

規範

規範
CSS 字型載入模組等級 3
# dom-fontfaceset-load

瀏覽器相容性