FontData：family 属性

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

FontData 接口的 family 只读属性返回字体的字体族。

这是在代码中引用字体族时使用的名称，例如在 font-family 属性中或在 @font-face at-规则中，如 local() 函数。

示例包括：

  • Apple SD Gothic Neo
  • Arial Black
  • Avenir Next
  • Katari
  • YuMincho +36p Kana

值

一个字符串。

示例

以下代码片段将查询所有可用的字体并打印元数据。例如，这可以用于填充字体选择器控件。

js
async function logFontData() {
  try {
    const availableFonts = await window.queryLocalFonts();
    for (const fontData of availableFonts) {
      console.log(fontData.postscriptName);
      console.log(fontData.fullName);
      console.log(fontData.family);
      console.log(fontData.style);
    }
  } catch (err) {
    console.error(err.name, err.message);
  }
}

规范

Specification
Local Font Access
# ref-for-dom-fontdata-family

浏览器兼容性

BCD tables only load in the browser

参见