# @documentdrivendx/umf-schema-browser 中文文档

规范地址：https://npmcn.com/package/%40documentdrivendx/umf-schema-browser/

版本：2\.1\.0
npm 元数据更新时间：2026-11-02T21:47:01.243Z
中文译文更新时间：2026-11-12T14:20:46.509Z
软件包许可：MIT OR Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40documentdrivendx/umf-schema-browser
原文对照：https://npmcn.com/package/%40documentdrivendx/umf-schema-browser/?lang=original
项目主页：https://github.com/DocumentDrivenDX/umf#readme
源码仓库：https://github.com/DocumentDrivenDX/umf

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

- 包体积（解压后）：118 MB，115 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-11T02:27:47.466Z
- 最新版本发布：2026-11-02T21:47:00.847Z
- 近 30 天下载量：6753（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

可重复使用的UMF表格、文物和肿瘤图案浏览器

## 安装

```sh
npm install @documentdrivendx/umf-schema-browser
```

也可以使用：`pnpm add @documentdrivendx/umf-schema-browser`、`yarn add @documentdrivendx/umf-schema-browser`、`bun add @documentdrivendx/umf-schema-browser`

## README

# UMF 计划浏览器

版本 **2.1.0 国家** 项目记录地图和结构比较 视频1.3.0 并使用其公开的Lini渲染器 在一个奉献的工人. 见 [迁移记录](https://npmcn.com/package/04-build/visual-rendering-migration.md) 范围核查. 直接地图消费者可以等待 `handle.ready` 财务报告和审定财务报表 `handle.update(model)`; 服务 `visual-worker.js` 财务报告和审定财务报表 `lini/` 除了他们的捆绑入内。 准确的包裹 `assets/` 复制为 iframe 探索者提供这些资源.

用于 UMF 文档的可重用、框架中立的浏览器, TableSpec 表格, 域包、原始文物收藏和肿瘤图。 这是 uMF微站台使用的同一种渲染器. 2.1.0版船舶编译浏览器 ESM, TypeScript申报和静态资产. 没有Bun,节点运行时间,框架, 需要将公共实体或网络连接到UMF微站.

## 安装和嵌入

安装公共 npm 软件包 :

```sh
npm install @documentdrivendx/umf-schema-browser@2.1.0
```

对于本地发行审查,从已建软件包目录中安装. 一个网站 消费者必须贴上准确的已公布的软件包并验证其安装 部署前分发.

1.1.0版本 添加 [版本主机合同](https://npmcn.com/package/%40documentdrivendx/umf-schema-browser/HOST_CONTRACT.md),发表 分类计划、选择/导航/错误事件、自定义类别、说明、, 主题、有界限的懒惰源、修订历史和结构比较。 可重复使用 属性/映射/diff组件在主机DOM中直接工作。 JSON 启动用途固定 在严格的CSP下建立时间验证器,有懒惰的YAML和本土恢复. 微站安装了精确的完整锁放,并检查完整 运行时间资产关闭和工作空间标记。 见 [变动](https://npmcn.com/package/%40documentdrivendx/umf-schema-browser/CHANGELOG.md)。 。 。 .

2.0.0版本 运行 UMF 站点的本体学,对象参考和模型目录 通过一个主机,同时保持独立和嵌入包表面. 软件包使用已清点的可选本地-schema 校验符 组群,仍与UMF核心相分离.

复制 `node_modules/@documentdrivendx/umf-schema-browser/assets/` 到您的静态 例如,服务器 `/schema-browser/`。对导出的 API 使用捆绑器,或者 服务软件包 `index.js` 直接作为浏览器的ESM.

```ts
import {mountSchemaBrowser} from '@documentdrivendx/umf-schema-browser';

const browser = mountSchemaBrowser(document.getElementById('schema-view')!, {
  assetsUrl: '/schema-browser/',
  catalogUrl: '/my-schema-catalog.json',
  assetBaseUrl: '/my-domain-packs/',
  height: '850px',
});
await browser.ready;
// When unmounting a React/Vue/Svelte component:
browser.destroy();
```

改为 `catalogUrl`,通过 `entries: Entry[]`. 入口用品 `id`, (中文(简体) ), `title`, (中文(简体) ), `category` (呼号), `path`一个 `text` 或懒惰的 HTTP( S) `url`,以及 `format: 'json' | 'yaml'`可选 `pack`, (中文(简体) ), `packVersion`, (中文(简体) ), `schemaFormat`, (中文(简体) ), `aliases` 财务报告和审定财务报表 `assets` 描述链接的包图和已核实的源下载。 这个 导出类型描述完整的结构。 为一包,提供其清单, 已申报的表格/肿瘤图和文物收集条目一起使用 身份证 `pack:<id>@<version>`, (中文(简体) ), `schema:<id>@<version>:<schema-id>` 财务报告和审定财务报表 `artifact:<id>@<version>:<collection-id>`就像微站目录那样.

`initialRoute` 使用 URLSearchParams 语法(`schema=...&definition=...`) (中文(简体) ). 每个 挂载自有 iframe: CSS、散列路线、过滤器和下载被隔离 父母和从其他山上. `iframe` 可用在返回的控点上 用于主机大小/可访问性. `ready` 指目录和UI已初始化. 目录失败拒绝承诺 并通知 `onCatalogError`· ; `select(selection)` 在源渲染后解决。 通话 `destroy` 在此之前 装入拒绝 `ready`,因此在提前卸载时处理拒绝.

## 独立

服务 `assets/` 超过 HTTP( S) 并打开 `assets/index.html`替换空的 `assets/schema-catalog.json` 与 `{ "version": 1, "entries": [...] }`,或使用 开放本地计划. 使用 `?catalogUrl=<encoded-http-url>` 以不更改软件包文件而提供目录,或使用HOST CONTRACT.md中原产地检查的配置协议。 来源停留在浏览器中. 相对下载 URL 解析 相对于独立页面中的目录主机基础,或 `assetBaseUrl` 在一个 内嵌 只获取明确提供的目录; 原始来源为 链接供用户下载,而不是自动获取.

## 东道国和边界

服务JavaScript作为JavaScript,CSS作为CSS. 同一来源的东道国资产, 或配置模块/目录请求的CORS。 您的内容安全政策 对同一来源资产和目录(只添加您主机需要的来源)使用此经过测试的严格政策 :

```text
default-src 'none'; base-uri 'none'; script-src 'self' 'wasm-unsafe-eval'; style-src 'self'; frame-src 'self' about:; connect-src 'self'; worker-src 'self'
```

母页否认 JavaScript `unsafe-eval` 和内置可执行脚本。 它允许WebAssembly为Rust比较运行时间和Lini地图的同源工人进行汇编。 服务 `visual-worker.js` hOST CONTRACT.md中说明了其单独的执行政策。 srcdoc 挂载会继承主机策略; 没有插入基准元素 。 固定验证器在制作者建造期间编译. 任意的本地语义汇编是有条件的,而不是通过削弱CSP来实现的. 使用独立的页面作为普通的 Iframe 源 当你的政策禁止srcdoc。 软件包没有外部字体要求. 这一政策是两种嵌入式的测试基线,而不是通用的 起码 可选图像显示、 跨源主机和 Iframe 沙盒/下载 权限解释如下: [机场](https://npmcn.com/package/%40documentdrivendx/umf-schema-browser/HOST_CONTRACT.md)浏览器 下载不需要 Blob 获取字节读取测试所使用的允许 .

Catalogs 是调用者选中的数据; 计划源字符串从未作为 HTML 或执行 。 这是源/源检查,不是 PDF/DICOM 查看器, 收集器、本体学解释器或本地执行引擎。 验证和出口 范围在UI中仍然是限定的. 未知元数据,原始源文本, 许可证/再分配声明和原始/衍生区别依然存在 可用。 已宣布的下载 URL 必须解决到 HTTP( S); 其他方案被拒绝 。 网络抓取和本地浏览器内存没有未设定资源 服务; 本地文件拾取器保留其4 MB 限制 . 懒包清单和肿瘤学同伴在选定之前一直被卸下. 元数据依赖的细节在尚未加载时链接到其源概览 .

## 构建

当前源默认制作人构建所需的比较 WASM from 然后用浏览器包捆绑:

```sh
bun run build:schema-browser /tmp/schema-browser-a
```

它使用Bun,并要求预先安装的Rust 1.90.0工具链及其 `wasm32-unknown-unknown` 目标,并预设 `wasm-bindgen 0.2.100` CLI 打开 `PATH`。该建筑已下线,不安装工具或目标. 生成的货运产出保持在 `target/schema-browser-rust-wasm/`; 数据 构建验证工具版本, 生成文件和 WASM 头 替换目的地。 包出处记录了建筑的散列 包装,货物清单/锁文件,WASM绑定和核心Rust源. 这个 装货船和资产船在货包入境点和 `assets/`双方 公共API模块和浏览器渲染器使用顶级等待初始化; 当模块导入解析后,它们的比较功能仍然同步. 缺少或无效的资产拒绝模块加载而无需TypeScript倒置.

下级 `build.ts` 执行细节,要求 包装出WASM输出. 正常消费者应使用上述命令; 没有呼叫器提供的 WASM 软件包覆盖 .

构建一个孤立的软件包目录并用:

```sh
npm pack /tmp/schema-browser-a
```

可重复使用的软件包中没有样本数据集档案;用户提供 目录和原始资产.

出厂的2.1.0生产商使用了1.4.2号舱,并投入使用 `build.ts` 进入点。 重复其来源的释放;当前来源 上面的"生锈"建设指令描述了后期的工作树.

## npm 发布

新释放用途 [`release-schema-browser.yml`](https://npmcn.com/.github/workflows/release-schema-browser.yml) 将确切的承付来源与被冻结的依赖关系加以限定. 它比较了两个干净的建筑, 验证记录的源关闭 将归档装入一个新鲜的消费者, 检查 TypeScript 模块模式和 在严格-CSP Chromium中运行已安装的示例。 只有在那些门经过之后 是否在草稿中附上完整的归档/显示/检查和/接收组 GitHub 发布, 发布不可改变的发布并发送主 npm 确切来源和存档针的出版社。 明确的主分支发送 选择源和新发布标记; 私有 SDK 和站点的分隔 已安装的浏览器针位于此路径之外.

如果创作草稿后升级停止,通过草稿的数字 `draft_release_id` 使用相同的标记和源。 动作重运行完成 要求现有草案的确切标记、源码和全部四 发布前匹配的资产摘要。 它不取代资产草案. 由于 GitHub 的标签搜索不可用, 校验草稿使用释放的 ID 返回未公布的草稿.

公共软件包 `@documentdrivendx/umf-schema-browser` 仅由 动作工作流程 [`publish-schema-browser-npm.yml`](https://npmcn.com/.github/workflows/publish-schema-browser-npm.yml)。 。 。 . 出版核实准确公开的GitHub发布, 不可改变的标签目标, 包装出处, `SHA256SUMS`字节 使用 npm OIDC。 它接受不可改变的发布后自动运行 或带有明确来源和消化针的默认分支手动回填. 遗产 释放没有 GitHub 不可改变的旗帜 需要所有手动标记,源, `SHA256SUMS` 和焦油弹针。 登记册的版本必须不存在或载有 相同的 tarball; 已经匹配的版本跳过上传并记录为 已存在的精确字节。 从公共npm和 导入软件包条目.

GitHub 释放不可改变性被允许用于未来的释放. 附加所有资产 在发布之前, 现有释放保留其 原始状态; `schema-browser-v2.0.0` 因此,使用精确的本位手册 倒满。 见 [GitHub 的发布设置](https://docs.github.com/en/code-security/how-tos/secure-your-supply-chain/establish-provenance-and-integrity/prevent-release-changes)。 。 。 .

仅限主机 `npm` 环境和精确的软件包 信任的出版商现在 配置,包括 **允许 npm 发布**编辑 [页:1 行动出版物](https://npmcn.com/package/%40documentdrivendx/evidence/schema-browser-npm-2.1.0/README.md) 通过了完整的生产者资格、OIDC上传、准确的公共字节 校验和新的公共-npm安装/进口。 成功上传于 2026-10-26 22:35:51 世界协调时 在其出版前验证了待出版的 2026-10-28 19:22 UTC截止日期. 独立 npm 签名和出处检查 也通过了。 历史 [2.0.0 核查](https://npmcn.com/package/%40documentdrivendx/evidence/schema-browser-npm-2.0.0/README.md) 仍然是一个不变的匹配字节跳过,而不是 OIDC 上传请求 .

工作流程唯一的发布身份是主要唯一的 GitHub `npm` 环境和 npm 信任的出版商 `DocumentDrivenDX/umf`工作流程 `publish-schema-browser-npm.yml`启用可信任的出版商 **允许 npm 发布** 允许; npm 将其与相机出版分开处理。 见 [npm 信任的出版](https://docs.npmjs.com/trusted-publishers/)无 npm 符号被存储 。 私人 `@umf/core` 开发软件包及其 GitHub SDK 存档不是此出版物的一部分 .

要复制一个候选人,请将它分两次编成单独的输出目录,其中 1.4.2号舱,然后比较 `release-manifest.json`, (中文(简体) ), `asset-manifest.json` 财务报告和审定财务报表 `provenance.json` 字节的字节。 将审查的产出包成 `npm pack` 并核对档案 `SHA256SUMS` 并公开宣布。 这个 证明该来源候选人的可复制性,而不是出版物或消费者 针.

## 许可证

麻省理工学院提供这种分布中的UMF授权软件 许可证或 Apache 许可证 2.0, 由您选择 (`MIT OR Apache-2.0`) (中文(简体) ). 装入了第三个 政党软件保留自己的许可证;见 `THIRD_PARTY_NOTICES.md`。 。 。 .

嵌入控制包括 `hideHero`, (中文(简体) ), `readOnlyLocalFiles`, (中文(简体) ), `theme`, (中文(简体) ), `themeVariables`, (中文(简体) ), `categories`, (中文(简体) ), `focus()` 财务报告和审定财务报表 `onContentHeight`。 。 。 . `height: '100%'` 将容器装入明确高度。 运行 `bun docs/helix/05-deploy/schema-browser/example-host.ts <package-directory>` 用于通用可执行集成主机.

装有的货包也装有船 `examples/index.html`:在HTTP(S)上服务软件包目录,并打开该页面,用于不构建,严格-CSP主机,并带有内线条目,选择回调,暗模式跟随和焦点控制. 它包含一个微小的作者计划,没有公共数据集.

## 常见问题

### @documentdrivendx/umf-schema-browser 是什么？

可重复使用的UMF表格、文物和肿瘤图案浏览器

### 如何安装 @documentdrivendx/umf-schema-browser？

在项目目录运行 npm install @documentdrivendx/umf-schema-browser，或使用 pnpm add / yarn add / bun add。

### @documentdrivendx/umf-schema-browser 支持 TypeScript 吗？

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

### @documentdrivendx/umf-schema-browser 支持 ESM 还是 CommonJS？

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

### @documentdrivendx/umf-schema-browser 可以商用吗？

@documentdrivendx/umf-schema-browser 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @documentdrivendx/umf-schema-browser 的下载量有多少？

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

### @documentdrivendx/umf-schema-browser 还在维护吗？

最新版本 2\.1\.0 发布于 2026/11/03（10 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/10/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。