@gallerist/renderer-dom

中文文档
0.5.2发布于 2026/11/09MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 2034

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

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 正在装入 : placeholder
  4. 查看器内的密钥和主机UI
  5. 标记输入
  6. 许可证

@gallerist/reser-dom (英语)

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

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

安装

npm i @gallerist/renderer-dom

使用量

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()

完整文件: 单列波读取 财务报告和审定财务报表 docs/。 。 。 .

正在装入 : placeholder

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

{ 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-reveal150ms)作为模糊 清除。 负载仍在之后运行 --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,它使它在一个全球 没有构建步骤的页面.

许可证

麻省理工学院

版本与发布记录

@gallerist/renderer-dom 共发布 10 个版本,首次发布于 2026/11/04;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.2latest2026/11/096 天前
0.5.12026/11/087 天前
0.5.02026/11/088 天前
0.4.12026/11/078 天前
0.4.02026/11/069 天前
0.3.32026/11/069 天前

关于 @gallerist/renderer-dom 的常见问题

@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 和提交记录判断。