---
title: FontFace
slug: Web/API/FontFace
tags:
  - Интерфейс
  - Шрифты
translation_of: Web/API/FontFace
---
<p>{{APIRef("CSS Font Loading API")}}{{SeeCompatTable}}</p>

<p>Интерфейс <code><strong>FontFace</strong></code> представляет единый используемый шрифт. Он позволяет контролировать источник шрифта, являющийся URL-адресом внешнего ресурса или буфера; а также контролировать момент загрузки шрифта и его текущее состояние.</p>

<h2 id="Конструктор">Конструктор</h2>

<dl>
 <dt>{{domxref("FontFace.FontFace", "FontFace()")}}</dt>
 <dd>Создает и возвращает новый объект <code>FontFace</code>, созданный из внешнего ресурса, описанного  URL-адресом или из {{domxref("ArrayBuffer")}}.</dd>
</dl>

<h2 id="Свойства">Свойства</h2>

<p><em>Этот интерфейс не наследует свойства.</em></p>

<dl>
 <dt>{{domxref("FontFace.display")}}</dt>
 <dd>{{domxref("CSSOMString")}} определяет способ отображения шрифта, основываясь на информации о статусе его загрузки и готовности к использованию.</dd>
 <dt>{{domxref("FontFace.family")}}</dt>
 <dd>{{domxref("CSSOMString")}} получает или устанавливает <em>семейство</em> шрифта. Эквивалентен дескриптору {{cssxref("@font-face/font-family", "font-family")}}.</dd>
 <dt>{{domxref("FontFace.featureSettings")}}</dt>
 <dd>{{domxref("CSSOMString")}} получает или устанавливает редко используемые возможности шрифта. Эквивалентен дескриптору {{cssxref("@font-face/font-feature-settings", "font-feature-settings")}}.</dd>
 <dt>{{domxref("FontFace.loaded")}} {{readonlyinline}}</dt>
 <dd>Возвращает {{domxref("Promise")}}, которое выполняется для текущего объекта  <code>FontFace</code>, когда специфичный шрифт, указанный в конструкторе объекта, завершает загрузку, либо отклоняется с помощью <code>SyntaxError</code>.</dd>
 <dt>{{domxref("FontFace.status")}} {{readonlyinline}}</dt>
 <dd>Возвращает перечисляемое значение, указывающее на состояние шрифта : <code>"unloaded"</code>, <code>"loading"</code>, <code>"loaded"</code>, или <code>"error"</code>.</dd>
 <dt>{{domxref("FontFace.stretch")}}</dt>
 <dd>{{domxref("CSSOMString")}} получает или устанавливает свойство <em>растягивания </em>шрифта. Эквивалентен дескриптору {{cssxref("@font-face/font-stretch", "font-stretch")}}.</dd>
 <dt>{{domxref("FontFace.style")}}</dt>
 <dd>{{domxref("CSSOMString")}} получает или устанавливает <em>стиль</em> шрифта. Эквивалентен дескриптору {{cssxref("@font-face/font-style", "font-style")}}.</dd>
 <dt>{{domxref("FontFace.unicodeRange")}}</dt>
 <dd>{{domxref("CSSOMString")}} получает или устанавливает<em> диапазон точек кодирования Юникод</em>, охватывающих шрифт. Эквивалентен дескриптору {{cssxref("@font-face/unicode-range", "unicode-range")}}.</dd>
 <dt>{{domxref("FontFace.variant")}}</dt>
 <dd>{{domxref("CSSOMString")}} получает или устанавливает <em>вариант</em> шрифта. Эквивалентен дескриптору {{cssxref("@font-face/font-variant", "font-variant")}}.</dd>
 <dt>{{domxref("FontFace.weight")}}</dt>
 <dd>{{domxref("CSSOMString")}} содержит <em>толщину</em> шрифта. Эквивалентен дескриптору {{cssxref("@font-face/font-weight", "font-weight")}}.</dd>
</dl>

<h2 id="Методы">Методы</h2>

<p><em>Этот интерфейс не наследует методы.</em></p>

<dl>
 <dt>{{domxref("FontFace.load()")}}</dt>
 <dd>Загружает шрифт, основываясь на переданных требованиях конструктора текущего объекта, включая расположение или ресурсный буфер, и возвращает {{jsxref('Promise')}}, которое выполняется для текущего объекта FontFace.</dd>
</dl>

<h2 id="Спецификации">Спецификации</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Спецификация</th>
   <th scope="col">Статус</th>
   <th scope="col">Комментарии</th>
  </tr>
  <tr>
   <td>{{SpecName('CSS3 Font Loading','#FontFace-interface','FontFaceSet')}}</td>
   <td>{{Spec2('CSS3 Font Loading')}}</td>
   <td>Первое определение</td>
  </tr>
 </tbody>
</table>

<h2 id="Поддержка_браузерами">Поддержка браузерами</h2>

<div>


<p>{{Compat("api.FontFace")}}</p>
</div>