@design-parity/checks

中文文档
1.18.0发布于 2026/11/07Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 4182

确定性 a11y + i18n 光谱检查在一个 DesignReference / CatentRender 配对上. 运行时没有模型——只有承诺的规则和门槛.

中文使用文档
文档目录5 节
  1. 检查
  2. 配置
  3. 验证 CLI
  4. 查找类型
  5. 开发

@ design- parity/ 检查

决定性 无障碍+国际化 光谱检查 a (DesignReference, CandidateRender) 双人 这些是高价值的 被怀疑的 裁决的结果(见 文件/文件 原则2:目标 细节开发者通常会错过,设计工具不会强制执行.

每张支票都是一张 纯函数 表示承诺的阈值和 被俘的语义—— 没有网络呼叫和运行时间的模型 (原则1). 同样的公关总得分.

检查

函数仁爱它声称的
checkContrastcontrastWCAG 1.4.3.1.4.6 每个主题的文本对比;失败 AA − error,满足 AA 但不是 AAA ~ info。 。 。 .
checkTouchTargetsa11y交互式目标为:-48dp(物质3);低于24dp的WCAG 2.5.8层 error。 。 。 .
checkSemanticsa11y互动/图像节点曝光可访问标签/内容描述.
checkTextExpansioni18nPseudolocale 文本增长与可用宽度 = 切变风险(warn) (中文(简体) ).
checkLocaleFormattingi18n硬码地币特有货币/日期/标签中的数字字元.
checkRtlMirroringi18n在 RTL; 从右到左文本下必须映射的方向图标 .
checkHardcodedStringsi18n未按键的用户介面文字选入 ——一个渲染无法证明一个字符串来自资源).

runChecks(reference, candidate, config?) 运行整个套房并返回 调查结果 a11y 首先是i18n,然后是i18n各组按重度排序. runA11yChecks 编号 : runI18nChecks 运行一组.

对比失败保留错误, 除非引用语义树包含 相同的前地/后地对失败相同的阈值。 没错 以设计为主导的匹配被报告为警告 sharedWithReference: true页:1 无障碍债务仍然显而易见,而平等并不要求代码有差异 从它的源。 缺失或无法估计的参考文献从不抑制 候选人失败.

配置

所有政策都是通过下列途径承诺和压倒一切的: ChecksConfig (连续级别, 触控-目标最小,glyph-advance估计,主题,硬码字符串选择入. 默认存在 src/thresholds.ts 和编码 WCAG 2.2

  • 材料 3 + 标准伪地取向.

背书会让这些把手 design-parity.checks.json ——文件 @design-parity/baseline 写在靴子上。 读起来是决定性的 运行时, 它的调制阈值实际到达引擎( 原则 1) :

  • loadChecksConfig(path) 读取、解析和设计验证一个配置文件; 丢出一个可读错误, 如果它缺失, 而不是 JSON, 或 schema- 无效 .
  • loadChecksConfigOrDefault(path) - 一样,但是 缺少 文件解析为 强制的默认,所以在稳定状态下,没有设置的回放仍然有效。 A 类 目前但无效的文件仍然丢出.
  • validateChecksConfig(value) —— 验证一个已分解对象相对于 草案07 计划。 。 。 .

配置形状镜像 ChecksConfig 准确的,所以靴子输出验证 并装入没有翻译。 见 examples/design-parity.checks.json。 。 。 .

验证 CLI

design-parity-validate-checks [path ...] 验证一个或多个配置文件 在第一个无效的装置上不设零,所以可以打开 CI 默认为 design-parity.checks.json 在阴道.

node packages/checks/dist/cli/validate-checks.js design-parity.checks.json

查找类型

此软件包引入了专用 a11y 财务报告和审定财务报表 i18n FindingKind单位 @design-parity/core 所以判决可以和他们一起做. contrast 保持自己的类型( 它带有一个数字比, 并且是标题 a11y) 寻找). 焦点顺序和状态通知空白 没有 声称: SemanticNode 所以加上这些支票就是合同变更 在核心——跟踪而不是伪造.

开发

npm run build --workspace @design-parity/checks
npm test

版本与发布记录

@design-parity/checks 共发布 102 个版本,首次发布于 2026/06/14;过去 12 个月发布了 102 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.18.0latest2026/11/074 天前
1.17.02026/10/2617 天前
1.16.12026/10/1824 天前
1.16.02026/10/1726 天前
1.15.02026/10/1528 天前
1.14.12026/10/1230 天前

关于 @design-parity/checks 的常见问题

@design-parity/checks 是什么?

确定性 a11y + i18n 光谱检查在一个 DesignReference / CatentRender 配对上. 运行时没有模型——只有承诺的规则和门槛.

如何安装 @design-parity/checks?

在项目目录运行 npm install @design-parity/checks,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 design-parity-validate-checks,可以用 npx design-parity-validate-checks 直接运行。

@design-parity/checks 支持 TypeScript 吗?

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

@design-parity/checks 支持 ESM 还是 CommonJS?

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

@design-parity/checks 可以商用吗?

@design-parity/checks 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@design-parity/checks 的下载量有多少?

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

@design-parity/checks 还在维护吗?

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