前言
Pixelium Design 是一套 Vue 3 像素风组件库,大量采用 canvas 绘制的方案渲染像素风格 UI。在使用这个组件库做一个小应用时发现了一个问题。
问题
Card 和自动增高的 Textarea 嵌套一起时,在 Textarea 里粘贴一段长文本撑开高度,Card 的高度跟着变大,但是像素 UI 会出现闪烁,先显示旧尺寸的边框,下一帧才突然跳成正确尺寸。
Card 的边框由一张 canvas 位图绘制,Card 自己的 ResizeObserver 回调中按当前盒子尺寸重建位图。
Textarea 的高度由组件逻辑计算,ResizeObserver 回调中算出 Textarea 应有的新高度,先写入响应式状态,再由 Vue 在微任务 flush 时把新高度写回 style.height。
这两个机制单独看都正常。放到一起时,Textarea 被撑高时,Card 的盒子确实变高了,但边框位图仍停留在上一次的尺寸,要等下一帧才重绘。
事件循环
为了解释清楚发生了什么,我们先来复习一下浏览器的事件循环机制。
主线程同时只能跑一段代码。样式计算和绘制只能排在脚本后面执行。一个任务执行完,引擎先清空微任务队列,再进入渲染阶段。渲染阶段内部也有固定顺序,先重算样式,再做布局,然后执行 ResizeObserver 回调,最后绘制。ResizeObserver 回调属于脚本。回调返回时 JS 栈为空,引擎会做一次微任务检查点。
flowchart A(从任务队列取出任务) --> B执行任务 B --> C清空微任务队列 C --> D{有渲染机会吗} D -- 没有 --> A D -- 有 --> E进入渲染阶段 E --> E1执行动画帧回调 E1 --> E2清空微任务队列 E2 --> E3样式计算 E3 --> E4布局 E4 --> E5执行其他回调 E5 --> E6清空微任务队列 E6 --> E7重排 E7 --> E8绘制并提交 E8 --> A
浏览器绘制阶段也会清空微任务队列这件事情,详见:
- WHATWG HTML 规范,clean up after running script --- https://html.spec.whatwg.org/multipage/webappapis.html#clean-up-after-running-script
- WPT 测试 microtask_after_raf.html,专门验证 rAF 回调之后微任务会执行 --- https://github.com/web-platform-tests/wpt/blob/master/html/webappapis/scripting/event-loops/microtask_after_raf.html
原因
打开控制台的 Performance 看看发生了什么。
借助 AI 的分析,我们发现:
| 时间 | 活动 | 说明 |
|---|---|---|
| 1319.0 | use-textarea-height 的 RO 回调(2.0ms) | 测量 Textarea 的隐藏 textarea 高度,写响应式变量 height.value |
| 1323.0 | Textarea 的 drawFunc(0.1ms) | |
| 1324.9 | Card 的 drawFunc(3.7ms) | 在 Vue flush 之前,画的还是旧尺寸 |
| 1326.9 | 微任务 9.9ms | Vue flush:在 Textarea 中,watch(height) → setHeight() 写 inputRef.style.height(纯样式写入,只标记布局失效) |
| 1327.8 / 1328.2 | 样式重算 + 布局 | Card 尺寸这时才真正变大 |
| 1329 | 画图 / 提交 | 这一帧 paint 的 Card canvas 位图仍是旧尺寸 |
| 下一帧(~1350--1357) | Card RO 补投递 → 重画 | Card 闪烁结束 |
事实上,在 1329ms 节点后,事件回调表格里面,我们没有看到后续的重画事件,但是我们可以通过在浏览器执行脚本,来发现这种重绘行为。
在 AI 的帮助下,生成了这份脚本:
js
const card = document.querySelector('.px-card')
const canvas = card.querySelector('canvas')
const box = canvas.parentElement
let draws = 0
const proto = CanvasRenderingContext2D.prototype
for (const m of ['fillRect', 'fill', 'clearRect', 'putImageData']) {
const orig = proto[m]
proto[m] = function (...args) {
if (this.canvas === canvas) draws++
return orig.apply(this, args)
}
}
let last = draws
requestAnimationFrame(function tick() {
const rect = box.getBoundingClientRect()
const w = Math.floor(rect.width)
const h = Math.floor(rect.height)
const n = draws - last
last = draws
if (n > 0 || w !== canvas.width || h !== canvas.height) {
console.log(`盒子=${w}x${h} 位图=${canvas.width}x${canvas.height} 本帧绘制次数=${n}`)
}
requestAnimationFrame(tick)
})
在未修复的里输入文本,录到这样的输出:
text
盒子=1470x509 位图=1470x488 本帧绘制次数=0 ← 盒子已变高,位图还是旧尺寸,本帧没有重画
盒子=1470x509 位图=1470x509 本帧绘制次数=35 ← 下一帧完成重画,尺寸对上
盒子=1470x530 位图=1470x509 本帧绘制次数=0 ← 下一行换行,重复同样的一帧
盒子=1470x530 位图=1470x530 本帧绘制次数=35
每加一行(高度 +~21px)都出现一次这种情况:
盒子变大、位图停在上一个尺寸、本帧零次绘制 → 下一帧才有一次完整重画。
总之,这个问题的原因是重绘时序滞后。Textarea 高度更新要经过响应式状态、微任务 flush 和 style.height 写入;Card 的边框重绘虽然由自己的 ResizeObserver 负责,但它与这条高度更新链路不在同一时间点上完成,于是出现边框位图相对盒子尺寸慢了一帧的情况。
text
帧 N
布局 → Card 是 S0(上一帧写入的结果)
ResizeObserver 投递:
Card 的回调按 S0 重画,位图追上布局
同一轮里,Textarea 的回调又算出 S1,写进状态
微任务:Vue flush 把 S1 写进 DOM,布局失效
重排:Card 变成 S1
绘制:新布局 S1 + 旧位图 S0,闪一帧
帧 N+1
布局 → Card 是 S1
ResizeObserver 投递:这次报 S1,重画
帧 N 里 Card 的 ResizeObserver 收到的是上一帧那次写入造成的 S0,并且已经按 S0 把位图重绘好了;问题出在紧接着的 S1 写入落在投递之后,本帧不会再有第二次投递,绘制时位图还停在 S0。下一帧投递把 S1 报告上来,重绘才补上;如果输入还在继续,那一帧又会有新的写入落在投递之后,位图就总是慢一帧。
ResizeObserver 有一个 resize loop 的机制:回调执行时机在绘制前,若回调修改 DOM 又触发新的尺寸变化,浏览器会循环派发通知执行 ResizeObserver 的回调函数,直到没有待处理通知。
但是,事实上规范里的 resize loop 只覆盖在 ResizeObserver 回调里同步改布局这种情况,回调改完布局会重新布局并再投递一轮;微任务里的写入不在这个循环里,不会被它补上。这也是 CSSWG 讨论 ResizeObserver.takeRecords() 的背景,社区把这种现象叫作 canvas flickering problem。ResizeObserver 通知的是已经观察到的尺寸变化,不承诺这就是本帧最终的尺寸。
最小可复现用例
为了直观展示问题,在 AI 大人的帮助下制作了最小可复现用例。
下面这段代码不依赖组件库,也不用构建工具。隐藏的镜像 textarea 元素高度跟着文本变,它的 ResizeObserver 回调算出 textarea 的新高度,再用 queueMicrotask 模拟 Vue 的微任务 flush。在 textarea 里快速输入直到换行,边框会有一帧停在旧尺寸。
html
<!doctype html>
<style>
body { margin: 40px; }
#card { position: relative; display: inline-block; padding: 8px; }
#ta { display: block; width: 220px; padding: 0; border: 0; outline: 0;
resize: none; overflow: hidden; box-sizing: border-box;
font: 14px/20px monospace; }
#mirror { position: absolute; width: 220px; visibility: hidden;
white-space: pre-wrap; word-break: break-word;
font: 14px/20px monospace; }
#border { position: absolute; left: 50%; top: 50%;
transform: translate(-50%, -50%); pointer-events: none; }
</style>
<div id="card">
<textarea id="ta"></textarea>
<div id="mirror"></div>
<canvas id="border"></canvas>
</div>
<script>
const card = document.querySelector('#card')
const ta = document.querySelector('#ta')
const mirror = document.querySelector('#mirror')
const canvas = document.querySelector('#border')
const ctx = canvas.getContext('2d')
const draw = () => {
const { width, height } = card.getBoundingClientRect()
canvas.width = Math.floor(width)
canvas.height = Math.floor(height)
ctx.strokeStyle = '#222'
ctx.lineWidth = 2
ctx.strokeRect(1, 1, canvas.width - 2, canvas.height - 2)
}
new ResizeObserver(draw).observe(card)
new ResizeObserver(() => {
queueMicrotask(() => {
ta.style.height = Math.max(mirror.offsetHeight, 20) + 'px'
})
}).observe(mirror)
ta.addEventListener('input', () => {
mirror.textContent = ta.value
})
</script>
修复
重绘要在引起尺寸变化的 DOM 写入生效之后、本帧绘制之前完成。ResizeObserver 的回调确实在本帧绘制之前运行,但它在框架写入 DOM 之前执行,所以单靠它必然会漏掉这一帧。
在上面的最小复现里,让 card 变高的最后一步是 ta.style.height = ... 那次写入。在它之后、本帧绘制之前再重绘一次就行。把下面这段接在 new ResizeObserver(draw).observe(card) 之后:
js
let queued = false
const scheduleDraw = () => {
if (queued) return
queued = true
queueMicrotask(() => {
queued = false
draw()
})
}
new MutationObserver(() => scheduleDraw()).observe(card, {
attributes: true,
attributeFilter: ['style', 'class'],
childList: true,
subtree: true,
})
MutationObserver 的回调本身就是一个微任务,DOM 变更时它会被排进队列,执行时间在写入之后、本帧绘制之前。回调里读 Card 的尺寸会强制一次同步布局,拿到的正是写入之后的新尺寸。queueMicrotask 把同一轮里的多次请求合并成一次,canvas 绘制只发生一次,而且仍然在浏览器绘制之前。
结论
Card 变高后的那一帧,盒子已经按新高度布局,边框位图仍然按旧高度绘制,看上去出现闪烁。下一帧位图按新高度重画,画面恢复正常。问题在两条更新链路的时机不同步。
Card 的边框位图只在 ResizeObserver 回调里重建。这个回调在每帧布局完成之后运行,读取当时的盒子尺寸并重画位图。Textarea 的高度更新走另一条链路。组件先把新高度写入响应式状态,Vue 的 watcher 在微任务里把这个值写进 style.height,浏览器收到写入后才重新布局。这次重新布局发生在 ResizeObserver 投递之后。位图在投递时读到的是更新前的尺寸,这一帧的边框因此还是旧高度。
修复的做法是在写 DOM 之后、本帧绘制之前再重画一次,让位图重建时读到这一帧最终的盒子尺寸。
参考文献
- W3C CSSWG issue #9717,why we need ResizeObserver.takeRecords --- https://github.com/w3c/csswg-drafts/issues/9717
- W3C ResizeObserver 规范,布局后的投递算法与 takeRecords --- https://drafts.csswg.org/resize-observer/
- web.dev ResizeObserver,像元素版的 document.onresize --- https://web.dev/articles/resize-observer
- Vue 3 文档,watcher 的 flush 时机 --- https://vuejs.org/guide/essentials/watchers.html#callback-flush-timing
- MDN ResizeObserver,元素尺寸变化监听 --- https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver
- MDN MutationObserver,DOM 变化监听 --- https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver
- WHATWG HTML 规范,perform a microtask checkpoint --- https://html.spec.whatwg.org/multipage/webappapis.html#perform-a-microtask-checkpoint
- WHATWG HTML 规范,clean up after running script --- https://html.spec.whatwg.org/multipage/webappapis.html#clean-up-after-running-script
- WPT 测试 microtask_after_raf.html,专门验证 rAF 回调之后微任务会执行 --- https://github.com/web-platform-tests/wpt/blob/master/html/webappapis/scripting/event-loops/microtask_after_raf.html