FontFace: load() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("CSS Font Loading API")}}{{AvailableInWorkers}}

The **load()** method of the {{domxref("FontFace")}} interface requests and loads a font whose source was specified as a URL. It returns a {{jsxref('Promise')}} that resolves with the current FontFace object.

If the source for the font face was specified as binary data, or the font {{domxref("FontFace/status", "status")}} property of the font face is anything other than unloaded, then this method does nothing.

Syntax

js-nolint
load()

Parameters

None.

Return value

A {{jsxref('Promise')}} that resolves with a reference to the current FontFace object when the font loads or rejects with a NetworkError {{domxref("DOMException")}} if the loading process fails.

Exceptions

  • NetworkError {{domxref("DOMException")}}
  • : Indicates that the attempt to load the font failed.

Examples

This simple example loads a font and uses it to display some text in a canvas element (with an id of js-canvas).

html hidden
js
const canvas = document.getElementById("js-canvas");

// load the "Bitter" font from Google Fonts
const fontFile = new FontFace(
  "FontFamily Style Bitter",
  'url("https://mdn.github.io/shared-assets/fonts/bitter/Bitter-Regular.woff2")',
);
document.fonts.add(fontFile);

fontFile.load().then(
  () => {
    // font loaded successfully!
    canvas.width = 650;
    canvas.height = 100;
    const ctx = canvas.getContext("2d");

    ctx.font = '36px "FontFamily Style Bitter"';
    ctx.fillText("Bitter font loaded", 20, 50);
  },
  (err) => {
    console.error(err);
  },
);

{{EmbedLiveSample('Examples')}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}