SuperAPI AI 工具集

shaders-cursor-ripples

设计与创作

查看项目

更新于 10-16 00:28

技能介绍

用途:在已有页面图片上叠加跟随光标的流体扭曲效果,使用 Shaders 库的 ImageTexture 与 CursorRipples 组件,不替换原有内容与语义图片。

主要能力:通过一个 Shader 画布渲染源图,CursorRipples 置于 ImageTexture 之后做后处理;由库自行跟踪光标,无需自定义聚光灯坐标、径向遮罩或指针动画循环。

使用方式:安装 npm install shaders,按框架从 shaders/react、shaders/vue、shaders/svelte 或 shaders/solid 导入。基础组合为 <Shader toneMapping="aces"><ImageTexture url={imageUrl} objectFit="cover" /><CursorRipples decay={7.3} radius={0.6} /></Shader>。React 可参考 assets/react/cursor-ripple-shader.tsx 与 cursor-ripple-media.css。仅在浏览器确认 WebGPU 且允许动态效果后懒加载挂载,保留底层真实图片作为加载与回退。

限制与注意:Vite 项目不要把 shaders 加入 optimizeDeps.exclude;商业发布前需确认当前许可条款。画布需 pointer-events: none 并置于回退图之上,控件层级更高;减少动态效果或 WebGPU 不可用时禁用着色器。需删除旧的 data-reveal-hover、radial mask-image、重复图片与手动指针监听等实现。验证时确认仅一个 canvas[data-renderer="shaders"]、回退图仍在、链接可点击、无控制台报错。具体版本与 API 以实际安装为准。