# @graview/render 中文文档

规范地址：https://npmcn.com/package/%40graview/render/

版本：0\.2\.5
npm 元数据更新时间：2026-11-16T13:18:28.035Z
中文译文更新时间：2026-11-17T01:12:30.761Z
软件包许可：Elastic-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40graview/render
原文对照：https://npmcn.com/package/%40graview/render/?lang=original
项目主页：https://graview.dev/docs/packages/render.html
源码仓库：https://github.com/en-dash-consulting/graview

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

- 包体积（解压后）：221 kB，55 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.0
- 运行依赖：2 个
- peer 依赖：@webgpu/types ^0\.1\.60
- 首次发布：2026-10-02T04:43:21.915Z
- 最新版本发布：2026-11-16T13:18:27.580Z
- 近 30 天下载量：11971（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

空间渲染器:GPU捕捉路径,浏览器可以捕捉到到WebGPU,DOM路径可以随处可见,两个路径上各有一幅图片和一棵可访问树.

## 安装

```sh
npm install @graview/render
```

也可以使用：`pnpm add @graview/render`、`yarn add @graview/render`、`bun add @graview/render`

## README

# @ graview/ 放弃

空间渲染器: 三平面,每平面一个外缘变换,以及 连接器在 SVG 中绘制在现场.

## 两条路,哪条路

**一个场景从浏览器可以使用的GPU和DOM路径上提取 其他任何地方——沉默地,每页.** `Scene` 编辑 `Shell` 默认为 `renderer="auto"`数字 : `gpuCapturePresent()` 问,没有设备,是否 页面有 WebGPU、 队列上的元素捕获呼叫、 画布 `paint` 和随所绘制的几何图形(下方)的命中测试 已经, `./gpu` 正在获取,并且 `attachGpu()` 带上画布. 如果没有适配器,没有油漆,它的第一帧检查就会回落 到达里面 `FIRST_PAINT_WAIT_MS`,一个框架被拒绝,设备丢失, 或第一个中间 `FIRST_FRAMES` 帧的工作结束了 `FIRST_FRAME_BUDGET_MS`一个没有它的任何一页——Firefox,Safari, 元素捕获前的铬- 永远不获取 `./gpu` 却什么都不说. `?renderer=gpu|dom` 地址(或 `graviewRenderer` 设置在页面上 在装入之前)决定 `auto` 操作员; `GRAVIEW_RENDERER` 显示 每页都一样.

元素捕获( E)`CanvasDrawElement`)默认在Chromium 158 和 后面 `--enable-blink-features=CanvasDrawElement` 在它开始之前 加那利语 158 重新拼写 API (`content="drawable"` 在画布上, `drawable` 每个 视图, 一个平面 `{ texture }` ; 两种拼写都写出.

**两道画一相相.** 每个视图都是普通元素 两者: 在DOM路径上,它携带一个CSS `matrix3d`,不透明和过滤器 gPU路径,它是画布的孩子,被俘虏, 和阴影画 从相同数目得到的相同待遇(`treatmentOf`, (中文(简体) ), `recededOpacity`) (中文(简体) ). 这个 两者的无障碍树相同,而且 `scripts/verify-renderer.mjs` 拿着,照片,还有沉默.

**Blu.** 后退飞机模糊不清,焦距飞机总是锋利. 打开 GPU 遮蔽器不计成本绘制; DOM 路径的 CSS `filter: blur()` 如果页面框架被覆盖,则该页面剩余部分将被删除 一个相框和一个相片移动的时候. `blur={false}` 在现场或 贝壳关闭了它,所以 `prefers-reduced-motion`, (中文(简体) ), `prefers-reduced-transparency` 和读者的动作设置 (单位:千美元)`planeBlurOn`) (中文(简体) ).

捕捉成本约0.22毫秒 在Chromium 158上, 所以重取每活 查看每个框架只保留 60 帧, 仅次于下 64 个视图( 6 fps) 第512页. `attachGpu()` 在下面保留一页:它只有在 浏览器 `paint` 事件说它改变了,跳过画布上的东西, 最多花费 `CAPTURE_BUDGET` 重新取出一个相框,并手握一个保持 变化快于此到 DOM 路径, 绘制在同一变换中 画布。 碟片有大约500英尺的视线 512个现场视线 (单位:千美元)`scripts/verify-scale.mjs`) (中文(简体) ).

**命中测试.** 关于158铬的观测结果 `updateElementGeometry` 在抽取时被击中试验—— `elementsFromPoint`,盘旋并按住 在所画视图上着陆——所以浏览器回答和画布上说 `data-graview-hit="platform"`,让视图的内容带走 指针. 更早的建筑 `layoutSubtree` 拼写, Chrome 155 为 抓取在其中切换) 接受几何并忽略它: 一个视图的 盒子一直放在原地 所以媒体 屏幕阅读器 自动化,所有土地,除了画景的地方. `gpuCapturePresent()` 页面引用 DOM 路径. `PointerRouter` (单位:千美元)`data-graview-hit="router"`留给驾驶者 `Compositor` 在这样的建筑上 一个锅通过变换来移动画布, 当它移动DOM路径的舞台, 并重新绘图 直到它着陆.

## 这里什么是稳定的

-   `PLANE_STYLES`, (中文(简体) ), `styleFor`, (中文(简体) ), `mixStyles`, (中文(简体) ), `transformFor` -飞机模型.
-   `planFrame` ——捕捉什么,画什么,每个景点都落地.
-   `PointerRouter`, (中文(简体) ), `hitTest` ——点击所绘制的几何图形进行点击.

组合体、工作组和 `html-in-canvas` 平台绑定随 浏览器特性.

## 常见问题

### @graview/render 是什么？

空间渲染器:GPU捕捉路径,浏览器可以捕捉到到WebGPU,DOM路径可以随处可见,两个路径上各有一幅图片和一棵可访问树\.

### 如何安装 @graview/render？

在项目目录运行 npm install @graview/render，或使用 pnpm add / yarn add / bun add。

### @graview/render 支持 TypeScript 吗？

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

### @graview/render 支持 ESM 还是 CommonJS？

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

### @graview/render 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.22\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @graview/render 可以商用吗？

@graview/render 使用 Elastic-2\.0 许可。声明的许可为 Elastic-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @graview/render 的下载量有多少？

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

### @graview/render 还在维护吗？

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

