使用 Opentype.js 生成字体子集的实例代码详解

什么是 Opentype.js

Opentype.js 是一个 JavaScript 库，主要用于解析和操作 OpenType 字体。通过使用 Opentype.js，我们可以将 OpenType 字体嵌入到 Web 页面中，并对其进行各种操作，如显示、排版、模糊和旋转等。

什么是字体子集

字体子集是指从完整字体中提取的包含特定字符的子集。它通常用于通过网络传输字体，以减小字体文件大小并提高网站性能。

如何使用 Opentype.js 生成字体子集

使用 Opentype.js 生成字体子集，需要先加载完整的字体文件，然后使用 compileGlyphs 方法编译字形，并使用 subset 方法生成子集。下面是具体的实现步骤：

步骤一：加载完整字体文件

const font = opentype.loadSync('my-font.otf');

步骤二：编译字形

const charList = ['A', 'B', 'C']; // 要生成子集的字符列表
const glyphs = charList.map(char => font.charToGlyph(char)); // 将字符映射为字形
font.compileGlyphs(glyphs); // 编译字形

步骤三：生成字体子集

const subfont = font.subset(glyphs); // 生成字体子集
const buffer = subfont.toArrayBuffer(); // 将子集转换为 ArrayBuffer

以上代码演示了使用 Opentype.js 生成字体子集的主要步骤。下面来看两个具体的示例说明。

示例一：生成包含中英文字符的字体子集

在这个示例中，我们将使用 Opentype.js 生成包含中英文字符的字体子集。假设我们的字体文件是 MyFont.otf，存放在 fonts 目录下。

首先，我们需要在页面中加载 Opentype.js 库：

<script src="path/to/opentype.min.js"></script>

接下来，我们可以在页面加载完成后使用如下代码生成字体子集：

const fontUrl = 'fonts/MyFont.otf';
const fontPromise = opentype.load(fontUrl); // 加载完整的字体文件
const charList = ['A', 'B', 'C', '你', '好', '啊']; // 要生成子集的字符列表
fontPromise.then(font => {
  const glyphs = charList.map(char => font.charToGlyph(char)); // 将字符映射为字形
  font.compileGlyphs(glyphs); // 编译字形
  const subfont = font.subset(glyphs); // 生成字体子集
  const buffer = subfont.toArrayBuffer(); // 将子集转换为 ArrayBuffer
  const blob = new Blob([buffer], { type: 'font/otf' }); // 创建 Blob 对象
  const fontUrl = URL.createObjectURL(blob); // 获取生成的字体子集 URL
  // 输出字体子集 URL，可以将其添加到样式表中
  console.log(fontUrl);
});

代码中，我们通过 opentype.load 方法异步加载字体文件，在字体文件加载完成后，创建字符列表并生成字体子集。最后输出字体子集 URL，并将其添加到样式表中即可。

示例二：生成包含图标的字体子集

在这个示例中，我们将使用 Opentype.js 生成包含图标的字体子集。假设我们的图标集是 MyIcons.svg，存放在 icons 目录下。

首先，我们需要将图标集转换为 TTF 格式，可以使用在线工具如 svg2ttf 或在命令行中使用如下命令：

npx svg2ttf icons/MyIcons.svg icons/MyIcons.ttf

得到 TTF 格式的图标集后，我们可以使用 Opentype.js 加载 TTF 文件，并将其中的字形编译为子集。如下：

const fontUrl = 'icons/MyIcons.ttf';
const fontPromise = opentype.load(fontUrl); // 加载 TTF 文件
const codeList = [0xe001, 0xe002, 0xe003]; // 待生成子集的代码点列表
fontPromise.then(font => {
  const glyphs = codeList.map(code => font.glyphForCodePoint(code)); // 将代码点映射为字形
  font.compileGlyphs(glyphs); // 编译字形
  const subfont = font.subset(glyphs); // 生成子集
  const buffer = subfont.toArrayBuffer(); // 转换为 ArrayBuffer
  const blob = new Blob([buffer], { type: 'font/ttf' }); // 创建 Blob 对象
  const fontUrl = URL.createObjectURL(blob); // 获取生成的字体子集 URL
  // 输出字体子集 URL，可以将其添加到样式表中
  console.log(fontUrl);
});

注意，在这个示例中，我们使用了字形对应的代码点而不是字符。这是因为在图标集中，相同的图标可能对应了不同的字符，这样可能会出现字符冲突的情况。因此，我们使用了代码点来表示字形。