RageLayer icon

RageLayer

RageLayer 是框架无关的 JavaScript 包,可将网页截图转换为支持破坏的画布,提供 15 种程序化工具、刚体碎片与浏览器特效,适合开发互动网站体验、创意编程项目和自定义浏览器工具。

RageLayer

什么是 RageLayer?

RageLayer 是一个框架无关的网页玩具和 JavaScript 包,可将捕获的网页转换为支持破坏的画布。其引擎可以在内容中打孔、破坏经过测量的网页元素、将其分离为物理碎片,并在网页上渲染火焰、烟雾、裂纹、飞溅和爆炸等特效。

它专为互动式浏览器体验而设计,而不是传统的网页编辑。开发者可以添加现成的集成,或使用框架无关的控制器;可从 15 种程序化工具中进行选择,清除破坏以恢复网页,并使用类型化引擎 API 创建自定义工具和进行高级控制。

功能

可破坏的网页捕获

RageLayer 会捕获或栅格化网页,并提供打孔、燃烧、切割、烧焦和恢复内容的操作,将捕获的表面变为破坏目标。

15 种程序化工具

该包包含 15 种内置工具,分为基础、重型和高级组,包括 Hammer、Gun、Flamethrower、Water Hose、Chainsaw、Paintball、Broom、Demolition、Rocket Launcher、Lightning、Black Hole、Bugs、Laser Cutter、Acid Jar 和 Sticky Bombs。

刚体物理

被破坏的区域可以变成刚体碎片,发生翻滚并堆积。引擎提供断裂和爆炸操作,并在各工具之间采用一致的木质风格物理响应。

多种集成方式

框架专用入口包括 React、Vue 和 Svelte 集成;控制器、自定义元素和工具栏模型则支持纯 JavaScript 及其他技术栈。

类型化扩展能力

引擎支持通过类型化 API 注册自定义工具,并提供生命周期辅助工具、底层绘图与特效原语,以及用于有状态工具的 SDK 工厂。

性能控制

自适应质量设置、有上限的粒子和火焰预算、脏区域渲染、遥测、隐藏标签页时暂停以及 WebGL 回退行为,可为不同运行时条件提供控制。

使用场景

  • 互动式网站特效

    为落地页、作品集、演示或宣传互动添加临时破坏模式,无需将网页重建为独立的游戏场景。

  • 创意编程与原型开发

    使用内置工具和刚体响应,创建基于浏览器的实验,展示普通网页内容上的捕获、渲染、特效和物理效果。

  • 框架集成的浏览器体验

    当体验需要框架生命周期处理而不是独立演示时,可在 React、Vue、Svelte 或纯 JavaScript 项目中嵌入工具栏或无界面控制器。

  • 自定义工具开发

    当内置的 Hammer、Gun、火焰、水流、切割和爆炸行为与预期互动不匹配时,可使用类型化引擎 API 注册项目专用工具。

  • 可逆的破坏会话

    生成破坏结果的 PNG,或在互动会话需要可逆状态或捕获结果时,使用清除、撤销、重做和检查点控制。

Pros and Cons

Pros

  • 可处理捕获的网页内容,而不仅仅是单独的空白画布。
  • 包含 15 种内置程序化工具,每种工具都有不同的破坏和特效行为。
  • 提供刚体碎片、跨工具交互、恢复和历史记录相关的引擎控制,以及 PNG 破坏结果快照。
  • 提供框架专用集成,以及框架无关的控制器和自定义元素选项。
  • 提供类型化 API 和 SDK 工具,用于注册自定义工具。

Cons

  • 文档将实时捕获模式描述为实验性功能,并指出其依赖浏览器支持;快照捕获是默认方式。
  • 该包以现代 ESM 形式分发,因此项目必须考虑这种分发格式以及浏览器/框架兼容性。
  • 该产品是面向开发者的互动式画布,并非用于永久修改网页源代码的通用可视化编辑器。

FAQ

RageLayer 支持哪些框架和环境?

RageLayer 可通过框架无关的控制器、React 和 Next.js 导入、Vue composable、Svelte action 或 <rage-layer> 自定义元素使用。文档还介绍了适用于 Astro、Angular、Solid 和纯 JavaScript 的集成方式,后者通过框架无关的控制器实现。

如何安装 RageLayer?

可使用 npm、pnpm 或 Bun 安装该包。该包以现代 ESM 形式分发,并提供 TypeScript 声明;React 和 react-dom 是可选的对等依赖。

RageLayer 会影响真实网页吗?结果可以恢复吗?

引擎会将真实网页捕获或栅格化为可破坏的表面,同时可以通过 clear 操作恢复原始页面。还可以通过 API 生成破坏结果的 PNG 快照。

开发者可以创建自定义工具吗?

可以。文档介绍了类型化自定义工具 API,包括工具注册、生命周期钩子、绘图访问、粒子、火焰、物理操作以及跨工具交互支持。

有哪些捕获和性能选项?

API 默认记录了快照捕获方式;当浏览器提供所需能力时,也可以使用实验性的实时捕获模式。文档还介绍了自适应质量层级、有上限的粒子和火焰预算、脏区域渲染、遥测以及 WebGL 回退机制。

Quick Facts

类别
开发者工具 / 互动式网页体验
包
ragelayer
内置工具
15
支持方式
框架无关的控制器、React、Vue、Svelte、自定义元素
分发格式
带 TypeScript 声明的现代 ESM
源站域名
parthjadhav.com