# @docfonts/fallbacks 中文文档

规范地址：https://npmcn.com/package/%40docfonts/fallbacks/

版本：0\.16\.0
npm 元数据更新时间：2026-06-10T19:05:11.241Z
中文译文更新时间：2026-11-12T13:45:13.872Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40docfonts/fallbacks
原文对照：https://npmcn.com/package/%40docfonts/fallbacks/?lang=original
项目主页：https://github.com/superdoc-dev/docfonts#readme
源码仓库：https://github.com/superdoc-dev/docfonts

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：77.3 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-06-05T19:37:52.877Z
- 最新版本发布：2026-06-10T19:05:11.115Z
- 近 30 天下载量：511719（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

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

## 安装

```sh
npm install @docfonts/fallbacks
```

也可以使用：`pnpm add @docfonts/fallbacks`、`yarn add @docfonts/fallbacks`、`bun add @docfonts/fallbacks`

## README

# @ docfonts/ 倒计时

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

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

## 安装

```sh
npm install @docfonts/fallbacks
```

仅限无害环境管理.

## 渲染字体

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

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

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

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

## 解释决定

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

```ts
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` 因此,地图从不指向无法加载的字体.

```ts
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 是什么？

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

### 如何安装 @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 和提交记录判断。