教程 ↗

做一个单 Canvas WebGL 列表指示器:从弹簧移动到触摸降级

用可下载的原创最小示例拆解列表输入、弹簧位置、调色板与 seed、文字淡入淡出,并实测键盘、模拟触摸、减少动态和无 WebGL 降级。

一张装饰画布随列表中的指针、键盘和触摸输入切换

鼠标滑过作品列表时,一个有纹理的小方块跟着选中行移动,颜色在途中慢慢变化。这样的 hover index 很容易先做成鼠标演示;加上键盘、手机和 WebGL 失败的条件后,真正需要理清的是:谁决定选中行,谁负责展开正文,哪一部分必须依赖 GPU。

本文做了一个可下载的原创最小示例:四个 HTML 按钮控制列表,一张 WebGL Canvas 绘制装饰纹理。悬停或聚焦改变选中项,点击、Enter、Space 或触摸展开正文。它使用普通 HTML、CSS 和 JavaScript,没有构建步骤,也没有第三方脚本或数据上传。

下载原创示例与运行说明。解压进入 one-canvas-example 文件夹后运行:

python3 -m http.server 8774 --bind 127.0.0.1

用浏览器打开 http://127.0.0.1:8774/,结束时按 Ctrl+C 停止服务。压缩包包含 index.html、style.css、app.js、英文 README 和 MIT 许可证;下文截图来自将下载包解压到另一个新目录后运行的版本。

从原作者的机制出发

灵感来自 r/webdev 的 Hover Index 帖子。当前原帖正文已被版主移除,仍可读到作者 u/Ashishgogula 的评论:始终使用一张 Canvas,悬停时给 shader 一个新的目标调色板,每帧向目标靠近约 8%,方块位置则由独立的弹簧过程移动。作者还描述了隐藏标签页暂停及 context 恢复后重建 GPU 资源的处理。

这些是作者对自己组件的说明。本文的按钮、纹理、配色、触摸手风琴、文字 crossfade 和减少动态逻辑由本站独立编写,使用原创代码与图形,没有购买、复制 Planes 的付费源码或素材。最小示例在 context loss 后保留 HTML 操作,重载页面再恢复装饰;它没有实现作者描述的自动恢复流程。

先让列表成立,再加 Canvas

列表用 ol 和 li 表达顺序,每行标题里放一个原生 button,正文是独立的 p。aria-controls 关联按钮与正文,JavaScript 启动后再设置 aria-expanded 并控制 hidden。Canvas 带 aria-hidden="true" 和 pointer-events: none,因此按钮的名称、焦点和点击区域始终由 DOM 提供。

这里有两个不同的状态:active 是装饰跟随的行,open 是展开正文的行。悬停和聚焦只调用 select(index);按钮的 click 再更新 open。读者可以用 Tab 浏览标题,也可以在已打开一段正文时把指针移到另一行,正文不会被悬停动作关闭。

点击同一行会折叠它,点击另一行会关闭旧段落再展开新段落。这是单项展开的手风琴。使用原生按钮让 Enter 和 Space 产生浏览器提供的点击行为,省去了另写键盘模拟点击的处理。触摸同样走点击路径;pointerenter 会过滤 pointerType === 'touch',避免把触摸设备的指针进入事件当成悬停前提。

英文示例中,键盘展开 Color studies,单个纹理方块跟随第二行

键盘展开第二行后,正文、焦点轮廓和装饰同时可见。

把输入交给状态,把状态交给绘制

选中项改变时,先更新行的 CSS class 和文字预览,再测量目标位置。getBoundingClientRect() 返回当前视口中的坐标;按钮顶部减去列表顶部,得到 Canvas 在列表内部的目标偏移。再加上按钮高度与 Canvas 高度差的一半,使方块中心对齐按钮中心。下面的 button 和 rect 都是测量得到的矩形:

target = button.top - rect.top
       + (button.height - canvas.clientHeight) / 2;

展开正文会推低后面的行,窄屏又会改变 Canvas 和按钮尺寸。因此点击展开、窗口缩放和 ResizeObserver 都会重新测量。目标来自实际布局,代码不假定每行永远相隔同一个像素数。Canvas 在 CSS 中绝对定位,位置只通过 translateY() 改变,跟随时不把整份列表推来推去。

输入更新选中状态,绘制读取弹簧位置、调色板与 seed,并在离屏或降级条件下切换

输入、状态和绘制分别负责一件事,暂停与降级作用于绘制路径。

示例里每一帧有两种收敛过程。位置保存当前坐标 y 和速度 velocity,朝目标 target 运动:

velocity += (180 * (target - y) - 24 * velocity) * h;
y += velocity * h;

180 是回到目标的力度,24 是抑制速度的阻尼;它们是这个示例的视觉参数。直接把 y 设为目标会立即跳转,保留速度后,换目标时能接着当前运动继续。每帧时间差最多取 1/30 秒,再分成四个小步积分,防止一次很慢的帧让这个简单数值模型迈出过大的步子。暂停时清空上一帧时间,恢复后的第一帧用新的小步开始。

调色板和 seed 不需要速度,因此采用指数逼近:

const gain = 1 - Math.exp(-12 * dt);
palette += (active - palette) * gain;
seed += (active + 1 - seed) * gain;

作者评论中的“每帧约 8%”容易理解,但每秒渲染的帧数会影响这种固定每帧比例的速度。这里让比例由 dt 决定,使同样的时间间隔更接近同样的过渡进度;不同设备的调度和数值误差仍会影响实际观感。

一张画布怎样换颜色与纹理

WebGL 初始化时编译顶点与片元 shader,上传覆盖画布的两个三角形。每帧更新 viewport 和 uniforms,再调用一次 drawArrays。Canvas 的显示尺寸由 CSS 决定,内部像素尺寸乘以设备像素比,示例将像素比上限设为 2,避免高像素比屏幕无限增加这个装饰的像素工作量。

palette 是连续的调色板索引。例如 1.4 表示第二组与第三组颜色之间,shader 读取前后两组颜色和 0.4 的混合比例。seed 也是连续数值,在本例里是正弦纹理的相位偏移,不是每帧产生的随机数。这样重新绘制同一状态时,图案仍可重现。

从第一行直接跳到第四行时,这个教学实现会经过中间的配色,方便用一个连续索引解释插值。若希望任何两行之间直接混合,需要在选中时保存当下颜色,再向新目标颜色插值;复杂度增加在状态管理处,Canvas 数量不必改变。

描述预览采用两层 HTML 段落。一层放旧文本,另一层放新文本,透明度在 180 毫秒内交叉切换。预览整体标为 aria-hidden,供阅读的正文仍在按钮关联的段落里,避免将正在淡入淡出的重复文本又读一遍。它展示了选中项的简介;真正的展开状态仍由 open 决定。

少一点动态,以及失败时的行为

开启 prefers-reduced-motion: reduce 后,位置直接设为目标,速度归零,调色板和 seed 立即切换,CSS 同时取消文字预览的过渡。减少动态会影响位置、纹理与文字三条路径,按钮操作和正文保留。

390 像素宽的英文界面中,模拟触摸展开 Quiet motion,正文在原行下显示

浏览器触摸模拟展开第三行;这张截图来自 390 像素宽的视口。

Canvas 创建失败、shader 编译或链接失败时,程序显示 HTML 模式提示并隐藏画布。监听到 webglcontextlost 后也会取消动画帧,进入同样的降级。preventDefault() 为浏览器允许 context 恢复保留条件,但本例的应用状态会继续停留在 HTML 模式,重载才重建 WebGL 资源。

无 JavaScript 时,初始化尚未隐藏任何段落,因此四段正文全部可读,按钮保持 disabled。要把这个例子改成真实作品目录,可以把作品链接放在正文中,让静态 HTML 同样有完整去向。

实际运行看到了什么

这次在 Ego 的 Chromium 152 中运行解压后的示例,分别查看了 1200 像素宽桌面、390 像素宽触摸模拟,以及明暗主题。Tab 聚焦按钮,Enter 展开第一段,Tab 后 Space 展开第二段,旧段落折叠;触摸模拟连续点击第三行得到展开与折叠,窄屏没有横向溢出。开启减少动态后,位置和目标相等,调色板、seed 已到目标,文字过渡为 0s。

还在加载前模拟 getContext('webgl') 返回空值,并用浏览器禁用 JavaScript 重新加载。前者保留按钮展开,后者保留四段静态正文。通过 WEBGL_lose_context 扩展触发真实 context loss 后,绘制停止,HTML 正文仍可展开;重新加载后 WebGL 装饰恢复。

暂停用两道条件控制:IntersectionObserver 检查整段列表是否还在视口内,visibilitychange 检查 document.hidden。离屏检查中,在过渡尚未结束时把列表滚出视口,绘制计数在随后 350 毫秒保持不变,回到视口后继续更新。隐藏标签页条件已写入代码;本次共享浏览器切换页面时没有产生真实的 document.hidden 状态,该分支的运行结果尚未核实。

示例还会在位置、速度、配色与 seed 都收敛后停止请求下一帧。你可以在开发者控制台调用 hoverIndexDiagnostics() 查看本地状态和累计绘制次数。绘制暂停说明这个路径已停止提交新的帧;本次没有比较多 Canvas 版本、测量 GPU 用时、电量或页面整体性能,也没有进行屏幕阅读器与实体手机测试。

这个实现适合用来学习如何把列表操作和图形装饰连接起来。移入正式项目时,先保留 HTML 的阅读与操作路径,再按实际设备决定纹理、恢复机制和动画参数。

相关接口可查阅 MDN:WebGLRenderingContext、prefers-reduced-motion、Intersection Observer、Page Visibility 和 webglcontextlost。

← 返回列表