Fabric.js 图层的〔拼合〕与〔拆组〕:处理组合后的坐标换算
多个图层合成一个组、再把组打散回独立图层,是编辑器的基本能力。难的不是 Group 本身,而是拆组那一刻:子对象的坐标、缩放、旋转、镜像,只要组合时经历过整体变换,拆出来就得全部重新换算,不然画面上会「瞬间跳变」。这篇就把最难的拆组坐标换算一次讲清楚。
一、组合(Group)
new fabric.Group(objects) 会把多个对象包成一个组,并以它们外接矩形的几何中心作为组的坐标原点。组合之后:
- 组的
left/top是组几何中心的坐标; - 子对象的
left/top变成"相对组中心的偏移"。
组合这步本身不难,麻烦在于组合后要保留偏移,让一堆对象作为一个整体去移动、缩放:
function makeGroup(objects, canvas) {
const group = new fabric.Group(objects);
group.set({ originX: 'center', originY: 'center' });
canvas.add(group);
canvas.setActiveObject(group);
return group;
}
二、拆组的坐标换算(核心难点)
先拆最简单的情况:组没旋转、没镜像。这时把子对象直接「提溜」出来,转换关系一目了然:
function splitGroupSimple(group, canvas) {
const list = group._objects;
const groupPos = group.getCenterPoint();
const sx = group.scaleX, sy = group.scaleY;
const created = [];
list.forEach((child) => {
child.set({
left: group.left + child.left * sx, // 相对于组中心的偏移 * 组缩放
top: group.top + child.top * sy,
scaleX: child.scaleX * sx, // 组外缩放乘到子对象上
scaleY: child.scaleY * sy,
angle: group.angle + child.angle, // 组角度和到子上
originX: 'center',
originY: 'center',
});
canvas.add(child);
created.push(child);
});
canvas.remove(group);
return created;
}
可一旦组带了旋转角度,就得把旋转造成的位置偏移也算进去。Fabric 提供了 fabric.util.rotatePoint,能把一个点在组坐标系里旋转:
// 先绕 (0,0) 旋转 group.angle,再加组中心
function rotatePointAround(x, y, degree) {
const rad = fabric.util.degreesToRadians(degree);
return {
x: x * Math.cos(rad) - y * Math.sin(rad),
y: x * Math.sin(rad) + y * Math.cos(rad),
};
}
子对象的世界坐标 = rotatePoint(child.offsetX, child.offsetY, group.angle) + group.left/top。拆组时补上这一步,画面就不会跳。
三、镜像(flipX/flipY)最坑
水平、垂直镜像会翻转坐标符号。如果组同时 flipX + rotate(angle),换算顺序就特别讲究。经验法则是:先在未翻转的坐标系里做旋转换算,再对坐标取镜像,最后转回原坐标。可以拆成三步手写,也可以封装一个「旋转+镜像」的坐标函数:
function mirrorRotate(x, y, angleDeg, axis) {
const rad = Math.PI / 180 * angleDeg;
// 1. 先逆旋到旋转前坐标系
const rx = x * Math.cos(-rad) - y * Math.sin(-rad);
const ry = x * Math.sin(-rad) + y * Math.cos(-rad);
// 2. 在旋转前坐标系里做镜像
const mx = axis === 'x' ? -rx : rx;
const my = axis === 'y' ? -ry : ry;
// 3. 再旋回来
return {
x: mx * Math.cos(rad) - my * Math.sin(rad),
y: mx * Math.sin(rad) + my * Math.cos(rad),
};
}
四、子层的角度处理
组的旋转角是 group.angle,子对象自己还有个 angle。拆开后子对象的最终角度 = group.angle + child.angle;要是组的翻转次数是奇数,角度还得取反,不然内容会「镜像了但角度不对」。
五、避坑
- 坐标系基准搞混 :拆组坐标计算时
child.left/top在组内是相对组中心的偏移,而最终对象在画布坐标系是绝对坐标。中间按顺序换算,别混。 - 忘了
originX/Y:拆出来的对象若不设origin: center,left/top语义是左上角,导致位置瞬移。统一用中心。 - 旋转 + 镜像叠加 :三个因素(位移、角度、镜像)必须照顺序处理,任何一项错,都会导致图案有 90° 或镜像不对称的"错乱"。
- 组的
_objects顺序 :group._objects是内部的集合,直接改前先slice()拷贝,避免 in-place 修改污染。 - 组合和拆分后的历史 :两者都会改变画布结构,记得 pushHistory,保证 undo。
六、验证
验证办法:构造三个矩形加一个组,给组旋转 30°、加水平镜像,然后拆组。逐项核对每个子对象的最终坐标、角度、镜像方向,再截图对比「拆前整体 vs 拆后逐个」,两边应该完全一致。
FAQ 常见问题
- 问:拆出来之后子对象位置乱飞、不在原来的地方?
说明换算顺序或基准不对:child.left/top在组内是相对组中心的偏移,最终在画布坐标得把组的旋转/缩放/位移一起换算进去,并且统一origin: center。别混用 组内相对坐标 和 画布绝对坐标。 - 问:
flipX/flipY镜像过的组,拆组后图案歪了或反了?
镜像会影响子对象的 x/y 与角度符号。拆组时要按"位移 → 旋转 → 镜像"的固定顺序处理,任一项漏掉都会导致图案错 90° 或镜像不对称。 - 问:怎么避免操作过程把组内部的
_objects弄坏?
_objects是 Fabric 内部集合,直接 in-place 修改有风险。先slice()拷贝一份再遍历处理,不污染组本身;拆完记得把历史记录 push 进去,保证可 undo。