@docfonts/fallbacks

中文文档
0.16.0发布于 2026/06/11MITTypeScriptES Module零依赖近 30 天下载 51.2万

为专有文档字体所测量的开窗倒置.

中文使用文档
文档目录6 节
  1. 安装
  2. 渲染字体
  3. 解释决定
  4. 构建解析器地图
  5. 敬业领域
  6. 证明

@ docfonts/ 倒计时

为专有文档字体所测量的开窗倒置.

包船的决定,不是字体:当一个家族被审查时,哪个家族可以打开它,它是多么的忠实,当不应该使用开放倒计时.

安装

npm install @docfonts/fallbacks

仅限无害环境管理.

渲染字体

使用 getRenderableFallback 当你需要 一个家庭现在。 过 canRenderFamily 因此结果只包含您应用程序可以加载的字体 .

import { getRenderableFallback } from "@docfonts/fallbacks";

const fallback = getRenderableFallback("Helvetica", {
  canRenderFamily: (family) => bundledFamilies.has(family),
});

回返 null 当cfonts无法从你的可用资产中变回时.

解释决定

使用 getFallbackDecision 用于UI,诊断和报告.

import { getFallbackDecision } from "@docfonts/fallbacks";

getFallbackDecision("Aptos");
// { kind: "customer_supplied", evidenceId: "aptos", generic: "sans-serif" }

getFallbackDecision("Georgia", {
  canRenderFamily: (family) => bundledFamilies.has(family),
});
// { kind: "asset_missing", substituteFamily: "Gelasio", verdict: "near_metric", ... }

重要的决策类型:

  • fallback - 准备 fallback.substituteFamily。 。 。 .
  • asset_missing - cfonts有一个倒置, 但你的应用程序没有加载它.
  • face_missing - 倒计时不能提供所要求的面孔.
  • customer_supplied, (中文(简体) ), preserve_only,或 no_recommended_fallback - 不要代替.
  • unknown - cfonts没有这个家庭的证据.

构建解析器地图

使用 createFallbackMap 当勾起一个解析器时. canRenderFamily 因此,地图从不指向无法加载的字体.

import { createFallbackMap, normalizeFamilyName } from "@docfonts/fallbacks";

const map = createFallbackMap({
  canRenderFamily: (family) => bundledFamilies.has(family),
});

map[normalizeFamilyName("Times New Roman")];

有的倒背被面镜. faces 报告真实的面部报道。 使用 getRenderableFallbackForFace 样式文本;结果可能包括 faceSource时 synthetic 表示从指示的相向渲染,并让你的渲染器合成所要求的样式.

敬业领域

  • verdict - 衡量忠诚程度,例如: metric_safe, (中文(简体) ), near_metric, (中文(简体) ), cell_width_only,或 visual_only。 。 。 .
  • lineBreakSafe - 当垫款保存出行中断时是真实的.
  • glyphExceptions - 命名为可以回流的格言.
  • advance.basis - 用于平均和最大三角洲的样本/模型,例如 latin_full, (中文(简体) ), latin_text,或 monospace_cell。 。 。 .
  • generic - CSS 通用家族,用于最后的倒计时.
  • evidenceId - 被审查证据行的可靠身份证明.

SUBSTITUTION_EVIDENCE 揭露被审查的整行内容,以丰富报告内容.

证明

量产量用所持证正本. 此软件包不分发专有二进制,原始专有度量衡,或字体文件.

candidateLicense 是候选许可证标识或表达式: SPDX 当精确,稳定的 docfonts 标签另加.

版本与发布记录

@docfonts/fallbacks 共发布 16 个版本,首次发布于 2026/06/06;过去 12 个月发布了 16 个版本。

版本发布日期距今
0.16.0latest2026/06/115 个月前
0.15.02026/06/105 个月前
0.14.02026/06/105 个月前
0.13.02026/06/105 个月前
0.12.02026/06/105 个月前
0.11.02026/06/095 个月前

关于 @docfonts/fallbacks 的常见问题

@docfonts/fallbacks 是什么?

为专有文档字体所测量的开窗倒置.

如何安装 @docfonts/fallbacks?

在项目目录运行 npm install @docfonts/fallbacks,或使用 pnpm add / yarn add / bun add。

@docfonts/fallbacks 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@docfonts/fallbacks 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@docfonts/fallbacks 可以商用吗?

@docfonts/fallbacks 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@docfonts/fallbacks 的下载量有多少?

根据 npm 官方下载统计,@docfonts/fallbacks 在 2026/10/13 – 2026/11/11 这 30 天内被下载 511,719 次,日均约 17,057 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@docfonts/fallbacks 还在维护吗?

最新版本 0.16.0 发布于 2026/06/11(5 个月前);至今共发布 16 个版本,其中过去 12 个月发布了 16 个;首次发布于 2026/06/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。