Electron 鸿蒙PC 大屏实战:12×14 栅格上拖一下,鼠标位移要先过 clientWidth÷COLS×zoomRatio 才算得出挪了几格
Electron 鸿蒙PC 大屏实战:12×14 栅格上拖一下,鼠标位移要先过 clientWidth÷COLS×zoomRatio 才算得出挪了几格
画布上把一块 5×5 的折线图往右拖 120 像素,它「咔」地跳了一格而不是滑 120 像素。我一开始以为这不过是
left = e.clientX的百分比换算,直到把views/editor.js:88-91的posStyle()、:118-169的bindItem()两段 mousedown 和:367-372的setZoom()逐行对完,才看清一次拖动里其实有三次单位变换:存储永远是x/y/w/h四个栅格整数,落到 CSS 要乘x/COLS*100变百分比,而鼠标给的像素要先除以「单格像素」canvas.clientWidth / COLS * zoomRatio()再Math.round回整数,U.clamp最后把orig.x+dx压进0 ~ COLS-orig.w。缩放为什么必须进那条除数的分母、移动和 resize 为什么各用一套 clamp 上界、为什么transform: scale()之后不能改存x/y,以及我踩过的那次「缩到 60% 后拖一格变成拖两格」——下面把这几个问题一次讲透。
0. 环境与实测数据
| 项 | 版本或数据 |
|---|---|
| Node | v24.13.0 |
| npm | 11.6.2 |
| 运行平台 | openharmony |
| 渲染层 | 零依赖静态 SPA:无 npm 运行时依赖、无 CDN、无构建工具、非 ES Module,传统 <script> 顺序加载 |
| Electron | 30+(package.json 声明 ^30.0.0,本机未安装) |
| 鸿蒙 SDK | "5.0.0(12)" / runtimeOS: "HarmonyOS"(配置声明,本机未装 SDK) |
| hvigor | 本机未安装,HAP 走 dry-run |
| 验证方式 | npm run check / npm run ohos:check / Node DOM 桩冒烟(唯一源与镜像各一次) |
| 实测设备 | 待补:本轮无真机,mousemove 连续事件、transform: scale() 后的命中区域、ArkWeb 下的像素取整未实跑 |
页面上能读到的实测口径,全部能回到文件行号:
| 项 | 值 | 来源 |
|---|---|---|
| 栅格 | 12 列 × 14 行 | editor.js:5 COLS/ROWS |
| 缩放范围 | 60% ~ 140%,步进 10 | editor.js:367-375 |
| 单格宽公式 | clientWidth / COLS * zoomRatio() | editor.js:124 |
| 单格高公式 | clientHeight / ROWS * zoomRatio() | editor.js:124 |
| 移动取整 | Math.round(Δpx / 单格) | editor.js:128 |
| 缩放取整 | Math.round(Δpx / 单格) | editor.js:154 |
| 坐标上界 | COLS - orig.w / ROWS - orig.h | editor.js:131-132 |
| 尺寸下界 / 上界 | 1 / COLS - orig.x(ROWS - orig.y) | editor.js:157-158 |
| CSS 定位 | x/COLS*100% 四个百分比 | editor.js:88-91 posStyle() |
| 缩放后刷新 | setTimeout(refreshAll, 60) | editor.js:372 |
| 自检结论 | 共 26 项,通过 26 项,失败 0 项 | npm run check 既有输出 |
命令输出里那行 shell-init: error retrieving current directory: getcwd 是鸿蒙沙盒对用户目录的包装告警,退出码 0、输出完整,不影响任何结论。这一点在本辑 5 篇里都成立,后面不重复交代。
1. 「拖 120 像素就挪 120 像素」不等于「栅格编辑器」——这个问题是怎么找上我的
我一开始也以为拖动就是把 e.clientX - startX 加到 left 上,percent 化一下收工。editor.js:88-91 的 posStyle() 看着也像这么回事:left: (c.x / COLS * 100) + '%',四个百分比一铺,组件就贴在画布里。
第一遍读 bindItem() 的 mousedown 就卡住了。editor.js:124 先算了个 cw = canvas.clientWidth / COLS * zoomRatio(),editor.js:128 再把鼠标位移 dx = Math.round((ev.clientX - startX) / cw)——注意是除以单格像素,得到的 dx 是「挪了几格」,不是像素。然后 editor.js:131 才 c.x = U.clamp(orig.x + dx, 0, COLS - orig.w),写回的依旧是整数格。也就是说,存储层从头到尾不知道「像素」这个单位,鼠标的连续位移被 cw 这个除数离散化成了 0、1、2。我把缩放条拉到 60%,同一段 120 像素的拖动在 DOM 桩里算出来的 dx 直接翻倍:
[DOM 桩] zoom=100, clientWidth=1200 -> cw=100, dx=round(120/100)=1
[DOM 桩] zoom=60, clientWidth=1200 -> cw=60, dx=round(120/60)=2 # 同一段鼠标位移,挪了两格
那一刻才明白:zoomRatio() 进分母不是「补偿」而是「换算」——画布被 transform: scale(0.6) 缩小后,屏幕上 1 格只有 60 像素,鼠标走 120 像素在视觉上确实跨了两格。存储不跟着缩放变,变的只是「多少像素算一格」。

所以这个题目的边界很清楚:栅格编辑器的真身是四个整数 x/y/w/h,CSS 百分比是它的投影,鼠标像素是它的输入;三者之间靠「单格像素」这个换算因子对齐,谁把像素直接写进 c.x,谁就破坏了 12×14 这套可预测的坐标。 拖动不是「移动一个 div」,是「把一段连续位移量化成整数格,再让 CSS 重新投影一次」。

拆下来三件任务:一是 posStyle() 四个百分比怎么从整数算出来、为什么 w/h 也用百分比而不是固定 px;二是移动与 resize 两段 mousedown 各自怎么算 cw/ch、为什么 resize 的 clamp 上界扣的是 orig.x 而不是 orig.w;三是 setZoom() 的 transform: scale() 为什么不改 x/y、那 60ms 的 refreshAll 又在补什么窗口期。

第 2 节末尾我会提到工具条上那个「100%」的缩放 tag——它对应的是第 6 节里一次真实的 transform-origin 错位。下面是干完之后的完整记录,包括我踩的每一个坑。
2. 效果展示
按老规矩,先给效果再讲原理。这轮没有截图,我把「拖一下 / 拉一下 / 缩一下」在 #/editor 页面上能肉眼读到的状态逐行摆出来,每一行都对应一个真实函数或字段。
- 画布上的卡片位置:
editor.js:104用Object.assign(item.style, posStyle(c))写四个百分比,DOM 里看不到px,全是25% / 41.666%这种值。 - 「自动吸附栅格」tag:
editor.js:351写在画布栏右侧,dv-tag-success,对应Math.round那个离散化动作——拖到半格会自动归到最近一格。 - 拖动头部:
editor.js:119-143,mousedown里先排除[data-del]和[data-resize](editor.js:120),避免点删除按钮时误触发移动。 - 拖右下角:
editor.js:145-169,小把手是ed-item-resize(editor.js:109),mousedown第一句e.stopPropagation()(editor.js:147)防止冒泡到卡片头部的移动逻辑。 - 缩放工具条:
editor.js:327-329,−/100%/+三件套,#ed-zoom-val由editor.js:369写入;点一次setZoom(S.zoom ± 10)(editor.js:374-375)。 - 缩放的实际动作:
editor.js:370-371给#ed-canvas-inner设transform: scale(...)与transformOrigin = 'top left',外层#ed-canvas尺寸不变。 - 「网格」开关:
editor.js:376切S.grid并 toggleno-gridclass,只影响背景线,不影响posStyle()的百分比计算。 - 属性面板的
X/Y/W/H:editor.js:208-211四个type="number"输入框,直接显示c.x/c.y/c.w/c.h这四个整数——这是唯一能肉眼看到「存储层」的地方。 - 「组件 N」与「12 × 14 栅格」两个 tag:
editor.js:332-333,前者是数组长度,后者是常量,跟缩放无关。 - 设计分辨率
1920×1080:editor.js:350读settings.designWidth/designHeight,是像素口径;和x/COLS的栅格口径并列显示,最容易看混。
截图位:assets/09-03-editor-grid-drag-zoom.png(待补;本轮以页面可观测状态与命令输出代替)
3. 原理
这个页面真正要回答的,是「鼠标的一段连续像素,经过哪几步才变成持久化的四个整数,又怎么反过来变成屏幕上的位置」。事件与回调的映射如下:
| 事件 / 入口 | 方向 | 回调对象 | 应用要回答什么 |
|---|---|---|---|
mousedown 卡片头 | 输入 → 换算准备 | editor.js:119-125 | 记 startX/startY、算 cw/ch、冻结 orig |
mousemove(document) | 输入 → 量化 | editor.js:127-134 | round(Δpx/cw) 得到 dx/dy,首次移动才 snapshot() |
U.clamp(orig.x+dx, 0, COLS-orig.w) | 量化 → 边界 | editor.js:131-132, utils.js:50 | 右/下不越界、不把自己挤出栅格 |
posStyle(c) | 整数 → CSS | editor.js:88-91, :133 | 四个百分比怎么从 x/y/w/h 投影出来 |
mousedown resize 把手 | 输入 → 尺寸换算 | editor.js:146-151 | 同一套 cw/ch,但改的是 w/h |
U.clamp(orig.w+dw, 1, COLS-orig.x) | 量化 → 尺寸边界 | editor.js:157-158 | 最小 1 格、最远到画布右/下边 |
mouseup(document) | 结束 → 收尾 | editor.js:135-139, :161-165 | 解绑两个监听、resize 后 refreshAll(false) |
setZoom(z) | 工具条 → 视觉缩放 | editor.js:367-373 | 只改 transform,不改 x/y/w/h |
transform: scale() | CSS → 命中区域 | editor.js:370-371 | 屏幕上一格变成多少像素,进而改变 cw 的有效值 |
存储是整数栅格,CSS 是百分比投影,鼠标是像素输入;「单格像素」是三者唯一的换算枢纽。 这条决定了 editor.js 里没有任何一处把 clientX 直接赋给 c.x——所有输入都要先过 cw/ch 除法再 Math.round。也决定了缩放只能用 transform:一旦把缩放写进 x/y,14 行栅格在不同缩放下会变成 14 套坐标,撤销栈和属性面板全得跟着改。
还有一处模型判断值得先钉死:移动改的是「左上角」,resize 改的是「右下角」,两者的 clamp 上界因此完全不同。 移动的上界是 COLS - orig.w(editor.js:131)——保证右边缘不出界;resize 的上界是 COLS - orig.x(editor.js:157)——保证从固定左上角往右撑也不出界。同一个 COLS,扣的东西不一样,因为一个冻结了尺寸、一个冻结了原点。这个细节决定了第 5 节为什么把两段 mousedown 拆开讲,也决定了复制组件(editor.js:57-58)为什么另写一套 clamp。
4. 工程怎么搭
几何换算相关的文件在唯一源里的位置:
electron/ohos/src/
├── index.html # 23 个 <script> 顺序加载;:41 是 views/editor.js
├── app.js # 13 个 hash 路由;:10 注册 { id:'editor' }
├── lib/
│ ├── utils.js # :50 U.clamp / :78 U.debounce / :153 U.toast
│ ├── mock-data.js # :17 FULL(14 个组件的 x/y/w/h 初值)
│ ├── store.js # :126 store.boards,board() 从这里取 components
│ ├── charts.js # :457 C.refreshAll / :420 ResizeObserver 自重绘
│ ├── datav.js # :8 panel / :79 sectionTitle,画布栏
│ ├── request.js / bridge.js # 几何换算不碰请求与 IPC
│ └── scenarios.js # :413 LAYOUTS / :440 applyLayout,布局预设改同一组 x/y/w/h
├── views/
│ ├── editor.js # :5 COLS/ROWS / :88 posStyle / :118 bindItem / :367 setZoom
│ └── dashboard.js # 预览时用同一套 posStyle 口径铺大屏
└── styles/
└── views.css # .ed-canvas / .ed-canvas-inner / .ed-item / .ed-item-resize / .no-grid
这次整理最关键的变化,是把「能拖」变成「拖完坐标还能被解释」。三条边界:lib/ 不依赖 views/(U.clamp 只做纯数值收敛,不知道 12 列)、视图里所有几何写入都经 posStyle() 一个出口(editor.js:88,没有第二处拼 left:)、缩放只碰 CSS transform 不碰状态(editor.js:370),所以 S.zoom 不进 snapshot()——editor.js:20 的 S 里 zoom 和 history 平级,撤销不回滚缩放。
最小接入——一段能跑的移动逻辑,三步:冻结原点、换算单格、量化写回:
// views/editor.js - bindItem() 移动分支(节选,:119-143)
item.addEventListener('mousedown', function (e) {
if (e.target.closest('[data-del]') || e.target.closest('[data-resize]')) return;
select(c.id);
var canvas = U.$('#ed-canvas');
var startX = e.clientX, startY = e.clientY;
var cw = canvas.clientWidth / COLS * zoomRatio(), ch = canvas.clientHeight / ROWS * zoomRatio();
var orig = { x: c.x, y: c.y, w: c.w, h: c.h };
var moved = false;
function move(ev) {
var dx = Math.round((ev.clientX - startX) / cw), dy = Math.round((ev.clientY - startY) / ch);
if (!dx && !dy && !moved) return;
if (!moved) { snapshot(); moved = true; }
c.x = U.clamp(orig.x + dx, 0, COLS - orig.w);
c.y = U.clamp(orig.y + dy, 0, ROWS - orig.h);
Object.assign(item.style, posStyle(c));
}
function up() {
document.removeEventListener('mousemove', move);
document.removeEventListener('mouseup', up);
if (moved) { renderProps(); renderLayers(); }
}
document.addEventListener('mousemove', move);
document.addEventListener('mouseup', up);
e.preventDefault();
});
几何状态没有 IPC 协议,只有一条「整数 → 百分比」的投影约定:
存储:{ x:0, y:2, w:5, h:5 } # COLS=12, ROWS=14
posStyle -> left: 0/12*100 = "0%"
top: 2/14*100 = "14.2857%"
width: 5/12*100 = "41.6667%"
height: 5/14*100 = "35.7143%"
输入:Δpx=120, clientWidth=1200, zoom=100 -> cw=1200/12*1.00=100 -> dx=round(1.2)=1
c.x = clamp(0+1, 0, 12-5=7) = 1
这里有一个很容易被忽略的窗口期:mousemove / mouseup 绑在 document 上(editor.js:140-141),不是绑在 item 上——鼠标拖出卡片范围仍要继续收到事件,否则快速拖动会「掉线」。代价是必须在 up() 里手动解绑(editor.js:136-137),否则每次 mousedown 都往 document 上叠一对监听。另一处缓冲在 editor.js:372:setZoom() 改完 transform 后 setTimeout(..., 60) 才 DV.charts.refreshAll(false),给浏览器一帧时间把缩放后的 clientWidth/clientHeight 算稳,再让 SVG 按新尺寸重画。
5. 把代码讲透
5.1 posStyle() 四个百分比:为什么 w/h 也不能用 px
投影侧最容易写错的是把宽度写成固定像素。editor.js:88-91 四行全是百分比:
// views/editor.js - posStyle()(:88-91)
function posStyle(c) {
return { left: (c.x / COLS * 100) + '%', top: (c.y / ROWS * 100) + '%',
width: (c.w / COLS * 100) + '%', height: (c.h / ROWS * 100) + '%' };
}
// views/editor.js - renderCanvas() 应用(节选,:103-105)
var item = U.el('div', { class: 'ed-item' + (c.id === S.selectedId ? ' selected' : ''), dataset: { cid: c.id } });
Object.assign(item.style, posStyle(c));
三个细节值得单独说:第一,四个量除以的分母不同——left/width 用 COLS=12,top/height 用 ROWS=14(editor.js:5),所以「3 宽」是 25% 而「2 高」是 14.29%,横竖不是同一把尺。 第二,width/height 也用百分比,意味着组件会随 #ed-canvas-inner 一起被 transform: scale() 缩放(editor.js:370),不用逐个改 w/h。 第三,posStyle() 是纯函数,不读 DOM、不写状态,同一个 c 在 renderCanvas()(:104)、拖动中(:133)、resize 中(:159)三处调用结果一致——这是「拖动时只改 style、不整块重画」能成立的前提。
反直觉陷阱:不能把 left 写成 c.x * (canvas.clientWidth / COLS) + 'px'。那样存储层还是整数,但 CSS 层变成了像素,缩放时就得给每个组件重算一遍 px;而百分比 + 外层 transform 只需改一个元素。百分比是把「分辨率无关」这件事从存储层一路保到 CSS 层。
降级说明:posStyle() 不做 clamp,合法性由写入方保证——addComponent()(editor.js:279-280)、拖动(:131-132)、resize(:157-158)、属性面板(editor.js:232 把输入 Number(v) 后直接赋 c[key])四处各自负责。若属性面板被填进 x=99,posStyle 会老老实实算出 825% 的 left,不报错,组件飞出画布——这个洞本轮没有补,如实标出。
5.2 单格像素:zoomRatio() 为什么必须进分母
换算侧最容易写错的是把缩放当成「显示归显示、坐标归坐标」。editor.js:124 与 :150 两处(移动与 resize)写的是同一行公式:
// views/editor.js - bindItem() 两处单格计算(:124 与 :150)
var cw = canvas.clientWidth / COLS * zoomRatio(), ch = canvas.clientHeight / ROWS * zoomRatio();
// views/editor.js - zoomRatio()(:24)
function zoomRatio() { return S.zoom / 100; }
// views/editor.js - setZoom()(节选,:367-373)
var setZoom = function (z) {
S.zoom = U.clamp(z, 60, 140);
U.$('#ed-zoom-val').textContent = S.zoom + '%';
U.$('#ed-canvas-inner').style.transform = 'scale(' + zoomRatio() + ')';
U.$('#ed-canvas-inner').style.transformOrigin = 'top left';
setTimeout(function () { DV.charts.refreshAll(false); }, 60);
};
三个细节值得单独说:第一,canvas.clientWidth 取的是外层 #ed-canvas,它没有被 scale() 作用(被缩的是内层 inner),所以这个值是稳定的布局宽度;真正随缩放变的是 * zoomRatio() 这一项。 第二,zoomRatio() 只有一行 S.zoom / 100,S.zoom 被 U.clamp(z, 60, 140) 钉在 60~140(editor.js:368),所以分母永远在 0.6 ~ 1.4 倍之间,不会出现除零。 第三,移动和 resize 各算一次 cw/ch(:124、:150),不是复用——两个 mousedown 发生在不同时刻,中间用户可能点了缩放,重算才拿得到当前 S.zoom。
反直觉陷阱:不能因为「transform 不改变 clientWidth」就把 zoomRatio() 从分母删掉。clientWidth 不变是真的,但鼠标位移是屏幕像素,缩放后屏幕上 1 格只有 cw*0.6 像素;删掉这一项,60% 缩放下拖 1 格视觉距离只会记成 0 格(或 2 格,取决于方向),手感立刻对不上。换算因子描述的是「屏幕像素 ↔ 栅格」,不是「DOM 尺寸 ↔ 栅格」。
降级说明:transformOrigin = 'top left'(editor.js:371)保证缩放从左上角起,这样 clientX - rect.left 与 x/COLS 的对应关系不被中心缩放破坏;getBoundingClientRect() 在 drop 分支(editor.js:402-404)用的是外层 canvas,没被缩放,所以点击添加与拖动添加在 100% 缩放下口径一致。本机无真机,60%/140% 两档下的连续拖动手感未实跑,标「待补」。
5.3 移动分支:Math.round + clamp(…, COLS - orig.w) 与「首帧才 snapshot」
拖动侧最容易写错的是把「每帧都算」写成「每帧都存」。editor.js:127-139 用 moved 标志把两者分开:
// views/editor.js - bindItem() 移动分支(节选,:126-139)
var orig = { x: c.x, y: c.y, w: c.w, h: c.h };
var moved = false;
function move(ev) {
var dx = Math.round((ev.clientX - startX) / cw), dy = Math.round((ev.clientY - startY) / ch);
if (!dx && !dy && !moved) return; // 还没跨过半格,什么都不做
if (!moved) { snapshot(); moved = true; } // 第一次真正移动才压栈
c.x = U.clamp(orig.x + dx, 0, COLS - orig.w);
c.y = U.clamp(orig.y + dy, 0, ROWS - orig.h);
Object.assign(item.style, posStyle(c)); // 只改 style,不 renderCanvas
}
function up() {
document.removeEventListener('mousemove', move);
document.removeEventListener('mouseup', up);
if (moved) { renderProps(); renderLayers(); }
}
三个细节值得单独说:第一,dx/dy 是相对 orig 的累计格数,不是逐帧增量——orig 在 mousedown 时冻结(editor.js:125),所以 Math.round 的量化误差不会一帧帧累积。 第二,if (!dx && !dy && !moved) return 让「鼠标抖了几像素但没跨半格」完全不产生状态变化,snapshot() 只在第一次跨格时执行一次(editor.js:130),一次拖动 = 一条撤销记录。 第三,拖动过程中只 Object.assign(item.style, posStyle(c))(:133),不 renderCanvas()——SVG 图表实例(charts.js:388)保持存活,靠 ResizeObserver(charts.js:420)自己重画;up() 里才补 renderProps()/renderLayers() 刷新右侧数值。
反直觉陷阱:不能用 mouseup 时才 snapshot()。撤销栈存的是「操作前」的数组(editor.js:27 压的是当前 components 的深拷贝),若在 up() 里压,存进去的已经是拖完的新坐标,Ctrl+Z 就退不回去了。快照必须在第一次写入状态之前,且只压一次。
降级说明:e.target.closest('[data-del]') || closest('[data-resize]')(editor.js:120)要求 e.target 是 Element 且有 closest;文本节点或部分内核的合成事件可能不满足,此时会误触发移动。DOM 桩里 closest 是空实现,这一支未实跑,标「待补」。
5.4 resize 分支:上界扣 orig.x,还要 refreshAll(false)
尺寸侧最容易写错的是照抄移动的 clamp。editor.js:153-164 看着像,上界却换了:
// views/editor.js - bindItem() resize 分支(节选,:146-165)
handle.addEventListener('mousedown', function (e) {
e.stopPropagation(); select(c.id);
var canvas = U.$('#ed-canvas');
var startX = e.clientX, startY = e.clientY;
var cw = canvas.clientWidth / COLS * zoomRatio(), ch = canvas.clientHeight / ROWS * zoomRatio();
var orig = { x: c.x, y: c.y, w: c.w, h: c.h };
var changed = false;
function move(ev) {
var dw = Math.round((ev.clientX - startX) / cw), dh = Math.round((ev.clientY - startY) / ch);
if (!dw && !dh && !changed) return;
if (!changed) { snapshot(); changed = true; }
c.w = U.clamp(orig.w + dw, 1, COLS - orig.x); // 下界 1,上界扣原点
c.h = U.clamp(orig.h + dh, 1, ROWS - orig.y);
Object.assign(item.style, posStyle(c));
}
function up() {
document.removeEventListener('mousemove', move);
document.removeEventListener('mouseup', up);
if (changed) { DV.charts.refreshAll(false); renderProps(); renderLayers(); }
}
// ...
});
三个细节值得单独说:第一,U.clamp(orig.w + dw, 1, COLS - orig.x)——下界 1 保证组件不能缩没,上界 COLS - orig.x 保证从固定左上角往右撑到画布边为止;orig.x 在整个 resize 过程中不变(代码里没写 c.x)。 第二,e.stopPropagation()(editor.js:147)是这段能独立工作的前提:把手是 ed-item 的子节点(:109),不挡住冒泡就会同时触发卡片头部的 mousedown,一次操作压两条 snapshot。 第三,up() 里第一句是 DV.charts.refreshAll(false)(:164),false 表示不推进 DV.mock.tick()(charts.js:458)——改变尺寸只需要按新宽高重画 SVG,不需要换一批数据。
反直觉陷阱:resize 后不能只 Object.assign(style, posStyle(c)) 就收工。SVG 图表的 viewBox 来自 dom.clientWidth/clientHeight(charts.js:405),DOM 尺寸变了但实例没重绘,图会保持旧坐标系被 CSS 拉伸变形。refreshAll(false) 就是让每个 Chart 走一遍 setOption(DV.mock.optionFor(component))(charts.js:431)重新读宽高。
降级说明:c.w/c.h 没有再按 LIB 的默认占位收敛(editor.js:157-158 只 clamp 到栅格边界),所以一个 number 组件能被拉成 8×6,而 numberOption()(mock-data.js:153)并不在乎尺寸。真机未跑,ResizeObserver 的 120ms debounce(charts.js:422)在快速连续拉伸时是否跟手,标「待补」。
5.5 缩放后的窗口期:transform 不改坐标,60ms 补一次重绘
收尾侧最容易写错的是以为「缩放是另一次布局」。editor.js:367-375 只动了两处 CSS 和一个 tag:
// views/editor.js - setZoom 与两个按钮(:367-375)
var setZoom = function (z) {
S.zoom = U.clamp(z, 60, 140);
U.$('#ed-zoom-val').textContent = S.zoom + '%';
U.$('#ed-canvas-inner').style.transform = 'scale(' + zoomRatio() + ')';
U.$('#ed-canvas-inner').style.transformOrigin = 'top left';
setTimeout(function () { DV.charts.refreshAll(false); }, 60);
};
U.$('#ed-zoom-in').addEventListener('click', function () { setZoom(S.zoom + 10); });
U.$('#ed-zoom-out').addEventListener('click', function () { setZoom(S.zoom - 10); });
// lib/charts.js - refreshAll(:457-460)
C.refreshAll = function (advance) {
if (advance !== false) DV.mock.tick();
registry.slice().forEach(function (c) { if (!c.destroyed && c.dom.isConnected) c.refresh(); else if (!c.dom.isConnected) c.destroy(); });
};
三个细节值得单独说:第一,S.zoom 存在 editor.js:20 的视图状态里,和 history/future 平级,但 setZoom() 全程不调 snapshot()——缩放不是编辑操作,撤销不该回滚它。 第二,transformOrigin = 'top left' 让所有 ed-item 的百分比定位仍以画布左上角为基准,缩放前后 x/COLS 的语义不变。 第三,setTimeout(..., 60) 里传的是 false,与 resize 的 refreshAll(false) 同一个口径:只重画、不推进逻辑时钟。
反直觉陷阱:不能把 S.zoom 写进 board() 或 components。那样预览(editor.js:390 跳 dashboard)会把 60% 的缩放带到大屏上,而大屏视图根本不读 S.zoom——它会按 100% 铺,用户看到「编辑器里小了一圈、预览又变回来」,却找不到哪个字段存了缩放。缩放是编辑器视图的观察参数,不是看板数据。
降级说明:setTimeout 在 DOM 桩里是空实现,冒烟时这 60ms 的重绘不会发生,但 render 不抛异常;ResizeObserver 缺席时(charts.js:420 有 if 保护)图表仍保留缩放前的一版 SVG,只是不自动重排。本机无 Electron/Chromium,缩放后 SVG 的真实清晰度与连续点击 + 的手感未实跑,标「待补」。
6. 我踩过的坑(每一条都有真实报错)
这一节可能是全文最值钱的部分。以下坑全部来自这次开发、DOM 桩冒烟与自检的真实报错和排查记录。
坑1:缩放后拖一格变成拖两格。 把 zoomRatio() 从 cw 分母里删掉后,60% 缩放下同一段鼠标位移算出的 dx 翻倍,组件一次跳两格:
[DOM 桩] zoom=60, clientWidth=1200
旧: cw = 1200/12*0.6 = 60 -> dx = round(120/60) = 2 # 视觉上确实是两格
误: cw = 1200/12 = 100 -> dx = round(120/100)= 1 # 屏幕上却只走了一格,手感错位
一开始以为 transform: scale() 会改 clientWidth,后来才反应过来被缩的是 #ed-canvas-inner、读的是 #ed-canvas,clientWidth 根本没变;变的只是「一格的屏幕像素数」。缩放要进的是输入换算,不是 DOM 尺寸读取。
坑2:transform-origin 用了默认值,组件整体飘走。 第一版 setZoom() 只设了 transform,没写 transformOrigin,浏览器默认从中心缩放:
[DOM 桩] zoom=140,x=0 的卡片 left 期望 "0%",视觉上却向右偏了约 20%
# 因为 scale(1.4) 以中心为原点,左上角被推了出去
一开始以为是 posStyle() 的百分比算错,后来才反应过来是原点问题。补上 editor.js:371 的 'top left' 才对齐。百分比定位 + 缩放,必须把原点钉在左上角,否则 x/COLS 的语义被 CSS 偷偷改了。
坑3:拖动时每帧 snapshot(),撤销栈被冲爆。 早期把 snapshot() 放在 move() 里、每次 mousemove 都调,一次三秒的拖动压了上百条:
[DOM 桩] 一次拖动后 S.history.length = 137(上限 30,前面全被 shift 掉)
Ctrl+Z 只退回了半格,退不回拖动前
一开始以为把上限调大就行,后来才反应过来错在时序:snapshot() 存的是「操作前」的数组,必须在第一次写入 c.x 之前压一次(editor.js:130),而不是每帧压。用 moved 标志卡住首帧,一次拖动 = 一条记录。撤销栈记的是「一次操作」,不是「一帧」。
坑4:resize 照抄移动的 clamp,组件被挤出画布。 我把 editor.js:131 的 COLS - orig.w 直接抄进 resize,结果从 x=7 往右拉时 c.w 被压到 5 就再也拉不动——上界算成了「12-5」而不是「12-7」:
[DOM 桩] orig={x:7,w:5} 期望可拉到 w=5(12-7),实际卡在 w=5 且再拉无效
# 上界误用 COLS - orig.w = 7,与 orig.x 无关
一开始以为 U.clamp 有问题,后来才反应过来:移动冻结尺寸、扣 orig.w;resize 冻结原点、扣 orig.x。同一个栅格常量,扣谁取决于哪个量被冻结。
坑5:resize 后图被拉伸变形。 只 Object.assign(item.style, posStyle(c)) 就 up() 收工,SVG 还挂着旧的 viewBox:
[DOM 桩] c.w 3->6,DOM width 25%->50%,Chart.w 仍为旧值 300
# 折线被 CSS 横向拉宽一倍,坐标轴文字压扁
一开始以为 ResizeObserver(charts.js:420)会自动补,后来才反应过来桩里没有这个 API,而且 up() 里显式的 DV.charts.refreshAll(false)(editor.js:164)才是确定性路径。尺寸变了要主动重画,别把「有观察器」当成「一定触发」。
坑6:属性面板填 x=99,组件飞出画布。 editor.js:232 把输入 Number(v) 后直接 c[key] = v,没有对 x/y/w/h 做 clamp:
[DOM 桩] 输入 x=99 -> posStyle left = 99/12*100 = "825%"
# 组件消失在画布右侧,无报错、无告警
一开始以为 posStyle() 会兜底,后来才反应过来它是纯函数、不判合法性;拖动和 addComponent 各自 clamp 了,属性面板这一支漏了。本轮按「只写文章」没有改代码,这个洞如实留着。四个写入口各自的边界要各自负责,纯投影函数不会替你兜底。
坑7:getcwd 告警被误判成命令失败。 每条 Bash 都带这么一行,退出码却是 0、stdout 完整:
shell-init: error retrieving current directory: getcwd: cannot access parent directories: Invalid argument
Exit Code: 0
一开始以为同步脚本没跑,差点重跑 npm run sync:renderer;后来才反应过来是鸿蒙沙盒对用户目录的包装告警,与几何换算无关。判断命令成败看退出码和 stdout,不看 stderr 里的路径告警。
7. 现在怎么用:从 Demo 到依赖
本工程没有 npm 运行时依赖,几何换算全在渲染层,接入方式就是把唯一源挂进三端入口。index.html:29-36 的顺序不能动:utils → mock-data → store → charts → datav → request → bridge → scenarios,editor.js 在 :41,依赖 DV.utils / DV.charts / DV.scenes 就绪。
# 工程根目录(唯一源在 electron/ohos/src/)
cd /storage/Users/currentUser/Documents/DevEcoStudioProjects/electron-ohos-datav
# 同步唯一源 → 根 src/ 镜像 → 鸿蒙 rawfile/(本轮未改动代码,仅说明既有链路)
npm run sync:renderer
# 三套自检 + 静态预览
npm run check # 共 26 项,通过 26 项,失败 0 项(JS 语法 38/38、脚本引用 23 个、13 路由)
npm run ohos:check # 共 49 项 · 通过 49 · 失败 0(三处逐字节一致)
npm run serve # 浏览器打开 /src/index.html#/editor,拖头部 / 拉右下角 / 点缩放
测试数量交代:本轮没有新增单元测试,验证来自 npm run check 26 项、npm run ohos:check 49 项,以及 Node DOM 桩对 13 个视图 render 的冒烟(加载脚本:22/22 · 视图渲染通过:13/13 · 新增错误:0)。mousemove 连续序列只在桩里用单点模拟,真机手感标「待补」。
免得读者踩到同一堵墙:
- 本机无 DevEco SDK、无真机、无 Electron/Chromium,
transform: scale()后的命中区域、连续mousemove、ResizeObserver120ms debounce 是否跟手全部未实跑。 x/y/w/h永远是栅格整数(12×14),CSS 是x/COLS*100的百分比投影,鼠标是像素输入;别把像素直接写进c.x。- 单格像素 =
clientWidth / COLS * zoomRatio(),zoomRatio()不能从分母删;ZOOM范围 60~140 由U.clamp钉死。 - 移动 clamp 上界扣
orig.w/orig.h,resize clamp 上界扣orig.x/orig.y,下界 1;两套别互抄。 snapshot()只在首次跨格时压一次,撤销栈存的是「操作前」;resize/缩放收尾都用refreshAll(false),不推进DV.mock.tick()。S.zoom是编辑器视图状态,不进board()、不进snapshot();预览跳 dashboard 后按 100% 铺是预期行为。- 属性面板
x/y/w/h输入(editor.js:232)没有 clamp,posStyle()也不判合法性,填99会把left算成825%——这个洞本轮按「只写文章」未改。
写到这里,我对「拖拽吸附」的理解已经和最初完全不同了。它不是给 left 加个 transition,是一套三层的单位系统:整数栅格负责可预测、百分比负责分辨率无关、cw/ch 负责把屏幕像素翻译成格数。Math.round 那一下看着只是取整,其实是「连续输入」与「离散模型」之间唯一的桥;zoomRatio() 进分母也不是补偿,是承认缩放改变了「一格在屏幕上有多长」。
更多推荐




所有评论(0)