# @gallerist/renderer-dom 中文文档

规范地址：https://npmcn.com/package/%40gallerist/renderer-dom/

版本：0\.5\.2
npm 元数据更新时间：2026-11-09T06:09:01.304Z
中文译文更新时间：2026-11-15T22:59:45.363Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：617 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@gallerist/core \>=0\.3\.0 \<1
- 首次发布：2026-11-04T09:04:21.990Z
- 最新版本发布：2026-11-09T06:09:00.906Z
- 近 30 天下载量：2034（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Gallerist的默认 DOM 渲染器——唯一能触动 DOM 的戒指.

## 安装

```sh
npm install @gallerist/renderer-dom
```

也可以使用：`pnpm add @gallerist/renderer-dom`、`yarn add @gallerist/renderer-dom`、`bun add @gallerist/renderer-dom`

## README

# @gallerist/reser-dom (英语)

Gallerist的默认 DOM 渲染器——唯一能触动 DOM 的戒指.

部分 [盖勒主义者](https://github.com/shafayet9780/gallerist#readme) ——一个无头,框架不可知的媒体取景器,用于组合式/嵌入式画廊并有图像-空间覆盖和虚拟化渲染.

## 安装

```bash
npm i @gallerist/renderer-dom
```

## 使用量

```ts
import { createViewer } from '@gallerist/core'
import { mount } from '@gallerist/renderer-dom'
import '@gallerist/theme-default/gallerist.css'

const viewer = createViewer({ items: [{ id: 'a', type: 'image', source: 'a.jpg' }] })
mount(viewer) // overlay/lightbox mode; pass { container } for inline
viewer.open()
```

完整文件: [单列波读取](https://github.com/shafayet9780/gallerist#readme) 财务报告和审定财务报表 [`docs/`](https://github.com/shafayet9780/gallerist/tree/main/docs)。 。 。 .

## 正在装入 : `placeholder`

一个东西 `placeholder` 显示项目完成的那一刻,在框中图像将画入(其 `naturalSize` 给出框;没有框,则占位符图像本身的形状,或 `--gallerist-media-ratio`) (中文(简体) ). 通过缩略图 URL 或页面已装入: 是 在浏览器缓存中,因此它画出与步骤相同的框架,没有闪出一空相.

```ts
{ id: 'a', type: 'image', source: 'a-2400.jpg', thumb: 'a-320.jpg', placeholder: 'a-320.jpg',
  naturalSize: { w: 2400, h: 1350 } }
```

-   **图像 URL** (或数据 URI)被绘制出模糊(`--gallerist-placeholder-blur`, 6px),被剪辑 至图像的框;图像会在其上方消退(`--gallerist-dur-reveal`150ms)作为模糊 清除。 负载仍在之后运行 `--gallerist-loading-delay` (400ms)在盒子里显示一粒药丸 下端角:"下降的全尺寸..." (正)`strings.loadingFull`),一种礼貌 `role="status"` 线条 在延迟之前是空的(从符文读出),所以一个快的负载什么都不说。 失败 负载保持占位器,锋利,药丸上写着"不能装满" (单位:千美元)`strings.loadFailed`重试按钮 ()`strings.retry`重新加载项目(重点是 如果负载再次出故障, 焦点还在那里, 新的Retry把它.
-   **颜色** (单位:千美元)`#2a3340`, (中文(简体) ), `red`, (中文(简体) ), `rgb(…)`: 一个读取为一体且浏览器解析的值 作为一个颜色, `CSS.supports('color', …)`一个空洞的词,不是一个, `thumb`,是一个 URL)填充 没有药丸 失败显示出错卡 .
-   **无:** 骨架在300ms后填满了盒子,并有发光(`--gallerist-placeholder`, (中文(简体) ), `--gallerist-shimmer`)),在影像出现的时刻就消失了(在舞台上逐渐消失. 失败 显示出错卡.

随着运动的减少 占位器不是模糊的, 骨架和旋转器保持静止 图像仍然在消失。 缩放在内容层上,所以一个轮子, 键入或双取出 图像以缩放占位符表示(一旦知道图像的大小就重新调整); `@gallerist/plugin-zoom`'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''-'+'等''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''.

## 查看器内的密钥和主机UI

取景器的密钥(窄, Home/ End, 数字, `+`编号 :`-`编号 :`0`, (中文(简体) ), `t`,插件密钥)在文本中无所作为 查看器内的字段( e)`input`, (中文(简体) ), `textarea`, (中文(简体) ), `select`可满足的),没有键 a 在观众被带走之前 `preventDefault()`。所以一个主机弹出 关闭了逃逸 在观看者之前: 处理弹出器上的逃逸( 或其场) 并呼叫 `preventDefault()`; 一个 没人能逃过一劫 把观众也关了 将焦点移动到一个 字段(“注”键打开一个注框) `preventDefault()` 或球场得到 字符键.

一个插件的 `keymap` 在查看器自己的密钥( 0. 5) 之前被询问, 因此插件可以重置一个 布局 : 接收密钥调用的处理器 `preventDefault()`,而观看者则无所作为 它; 一个不离开 观众自己的钥匙, 如果它有一个, 运行后。 插件- thumbnails' name `clusterKeys` 在平坦的铁路上, 插件不要求键入 Ctrl, QQ 或 备选案文( AltGr 正常 ): `?` ),或文本字段的密钥(逃脱) 只能是观众的;对于在观众中有箭头的部件的箭头,也不行 自己:在对话框、菜单或滑动器内(`role="dialog"`, (中文(简体) ), `"menu"`, (中文(简体) ), `"slider"`; 覆盖根 不计数),主机的列表框,标签列表,收音机组,菜单栏,树或网格(`role="listbox"`, (中文(简体) ), `"tablist"`, (中文(简体) ), `"radiogroup"`, (中文(简体) ), `"menubar"`, (中文(简体) ), `"tree"`, (中文(简体) ), `"grid"`, (中文(简体) ), `"treegrid"`;不是观众自己的 栏杆或网格,其箭头为取景者,或菜单按钮上(`aria-haspopup`没有 `"false"`) (中文(简体) ). 一个有重点的标题带,滚动保存了QQ/QQ/Home/End,用于在任何人被问到之前滚动. 这么说 主机不再需要抓取相听器取出箭头键. 丢出一个按键映射处理器 不停止取景者自己的密钥( 逃脱仍然关闭); 其出错被报告 (`reportError`,则 `console.error`) (中文(简体) ).

## 标记输入

`bind()` 从 `<a href="big.jpg" data-gallerist="trip">` 链接,没有收藏 写作。 属性列表于 [`@gallerist/cdn`](https://npmcn.com/package/%40gallerist/cdn/README.md),它使它在一个全球 没有构建步骤的页面.

## 许可证

麻省理工学院

## 常见问题

### @gallerist/renderer-dom 是什么？

Gallerist的默认 DOM 渲染器——唯一能触动 DOM 的戒指\.

### 如何安装 @gallerist/renderer-dom？

在项目目录运行 npm install @gallerist/renderer-dom，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@gallerist/core（\>=0\.3\.0 \<1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gallerist/renderer-dom 支持 TypeScript 吗？

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

### @gallerist/renderer-dom 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gallerist/renderer-dom 可以商用吗？

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

### @gallerist/renderer-dom 的下载量有多少？

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

### @gallerist/renderer-dom 还在维护吗？

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

