FontFaceSet

Baseline 廣泛可用 *

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

* 此特性的某些部分可能存在不同級別的支援。

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

FontFaceSet 介面是 CSS 字型載入 API 的一部分,用於管理字型的載入以及查詢它們的下載狀態。

FontFaceSet 例項是一個 類似 Set 的物件,可以包含一個有序的 FontFace 物件集合。

此屬性可以透過 Document.fonts 訪問,或者在 Web Workers 中透過 self.fonts 訪問。

EventTarget FontFaceSet

例項屬性

FontFaceSet.status 只讀

指示字型的載入狀態。它將是 'loading''loaded' 之一。

FontFaceSet.ready 只讀

一個 Promise,當字型載入和佈局操作完成後,它將解析。

FontFaceSet.size 只讀

返回 FontFaceSet 中值的數量。

事件

loading

當字型集開始載入時觸發。

loadingdone

當字型集載入完成時觸發。

loadingerror

當載入字型集時發生錯誤時觸發。

例項方法

FontFaceSet.add()

將一個字型新增到字型集中。

FontFaceSet.check()

一個布林值,指示字型是否已載入,但當字型未載入時不會啟動載入。

FontFaceSet.clear()

從字型集中移除所有手動新增的字型。CSS 連線的字型不受影響。

FontFaceSet.delete()

從字型集中移除手動新增的字型。CSS 連線的字型不受影響。

FontFaceSet.entries()

返回一個新迭代器,其中包含 FontFaceSet 中每個元素的值,按插入順序排列。

FontFaceSet.forEach()

FontFaceSet 物件中的每個值執行提供的函式。

FontFaceSet.has()

返回一個 Boolean 值,指示是否存在具有給定值的元素。

FontFaceSet.keys()

FontFaceSet.values() 的別名。

FontFaceSet.load()

返回一個 Promise,該 Promise 解析為一個請求的字型的字型列表。

FontFaceSet.values()

返回一個新的迭代器物件,該物件按插入順序產生 FontFaceSet 物件中每個元素的值。

規範

規範
CSS 字型載入模組等級 3
# FontFaceSet-介面

瀏覽器相容性