FontData：family 属性

实验性： 这是一个 实验性技术
在生产环境中使用之前，请仔细查看 浏览器兼容性表。

family 是 FontData 接口的只读属性，它返回字体字体的族名。

这是从代码中引用字体族时使用的名称，例如，在 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);
  }
}

规范

规范
本地字体访问
# ref-for-dom-fontdata-family

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅