---
title: FontFaceSet
slug: Web/API/FontFaceSet
tags:
  - API
  - Fonts
translation_of: Web/API/FontFaceSet
---
<div>{{APIRef("CSS Font Loading API")}}{{SeeCompatTable}}</div>

<p><a href="/en-US/docs/Web/API/CSS_Font_Loading_API">CSS 字体加载 API</a> 的 <strong><code>FontFaceSet</code></strong> 管理着字体们的加载和可查询的字体们下载状态。</p>

<h2 id="Properties">Properties</h2>

<dl>
 <dt>{{domxref("FontFaceSet.status")}} {{readonlyinline}}</dt>
 <dd>表示 font-face's 的加载状态，可能是 <code>'loading'</code> 或 <code>'loaded'</code></dd>
</dl>

<h2 id="Events">Events</h2>

<dl>
</dl>

<dl>
 <dt>{{domxref("FontFaceSet.onloading")}}</dt>
 <dd>当{{event("loading")}}相关事件发生时触发{{domxref("EventListener")}} ，表示 font-face 集已经开始加载了。</dd>
 <dt>{{domxref("FontFaceSet.onloadingdone")}}</dt>
 <dd>当{{event("loading")}}相关事件发生时触发{{domxref("EventListener")}} ，表示 font-face 集已经完成加载了。</dd>
 <dt>{{domxref("FontFaceSet.onloadingerror")}}</dt>
 <dd>当{{event("loading")}}相关事件发生时触发{{domxref("EventListener")}} ，表示 font-face 集加载时产生了一个错误。</dd>
</dl>

<h2 id="Methods">Methods</h2>

<dl>
 <dt>{{domxref("FontFaceSet.add","FontFaceSet.add()")}}</dt>
 <dd>向字体集添加一个字体。</dd>
 <dt>{{domxref("FontFaceSet.check","FontFaceSet.check()")}}</dt>
 <dd>一个{{domxref("Boolean")}} 用于表示一个字体是否加载完成，但它不回初始化你的加载。</dd>
 <dt>{{domxref("FontFaceSet.clear", "FontFaceSet.clear()")}}</dt>
 <dd>移除字体集的所有字体。</dd>
 <dt>{{domxref("FontFaceSet.delete","FontFaceSet.delete()")}}</dt>
 <dd>从字体集中移除一个字体。</dd>
 <dt>{{domxref("FontFaceSet.load","FontFaceSet.load()")}}</dt>
 <dd>返回解析为请求的字体的列表的 {{jsxref("Promise")}}。</dd>
 <dt>{{domxref("FontFaceSet.ready", "FontFaceSet.ready()")}}</dt>
 <dd>准备操作已完成且开始解析字体时返回一个 {{jsxref("Promise")}} 。</dd>
</dl>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('CSS3 Font Loading','#FontFaceSet-interface','FontFaceSet')}}</td>
   <td>{{Spec2('CSS3 Font Loading')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatChrome(35.0)}}</td>
   <td>{{CompatGeckoDesktop(41)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatSafari(10)}}</td>
  </tr>
  <tr>
   <td>clear() method</td>
   <td>{{CompatChrome(48.0)}}</td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Android Webview</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatChrome(35.0)}}</td>
   <td>{{CompatGeckoMobile(41)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatSafari(10)}}</td>
   <td>{{CompatChrome(35.0)}}</td>
  </tr>
  <tr>
   <td>clear() method</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatChrome(48.0)}}</td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td>{{CompatChrome(48.0)}}</td>
  </tr>
 </tbody>
</table>
</div>

<p> </p>