本文详解 Konva.js 使用 fillPatternImage 时因图像缩放导致图案偏移错位的根本原因，并提供基于实际坐标映射的动态 offset 计算方法，确保放大镜等交互效果精准对齐。
本文详解 konva.js 使用 `fillpatternimage` 时因图像缩放导致图案偏移错位的根本原因，并提供基于实际坐标映射的动态 offset 计算方法，确保放大镜等交互效果精准对齐。
在 Konva.js 中，fillPatternImage 常用于实现纹理填充、放大镜或局部高亮等视觉效果。但一个高频陷阱是：图案显示位置与预期严重偏移——尤其当 Konva.Image 被缩放（即其 width/height 与原始 <img alt="Konva.js 中 fillPatternImage 偏移错位的解决方案" > 尺寸不一致）时，直接用鼠标坐标设置 fillPatternOffset 会导致错位。根本原因在于：fillPatternOffset 的单位是原始图像像素（image pixel），而非舞台（stage）或 Konva 形状的逻辑坐标。
以下代码展示了正确处理方式的核心逻辑：
// 假设原始图片 img 已加载完成，konvaImage 是已缩放的 Konva.Image 实例
stage.on('mousemove', function (e) {
const pos = stage.getPointerPosition();
// 关键：将舞台坐标映射回原始图像像素坐标
// konvaImage.width()/height() 是它在 Konva 中渲染的尺寸
// img.width/img.height 是原始图片固有分辨率
const scaleX = img.width / konvaImage.width();
const scaleY = img.height / konvaImage.height();
// fillPatternOffset 需以原始图像像素为单位
const offsetX = (pos.x - magnifier.x()) * scaleX;
const offsetY = (pos.y - magnifier.y()) * scaleY;
magnifier.fillPatternOffset({ x: offsetX, y: offsetY });
});⚠️ 注意事项：
-
fillPatternOffset的(0, 0)对应原始图像左上角，而非舞台原点； - 若
konvaImage启用了scaleX/scaleY或被父容器变换影响，需额外叠加变换矩阵反向计算； -
fillPatternRepeat: 'no-repeat'下，offset 超出图像范围将留白，建议配合clipFunc或边界校验防止空白闪烁； - 动态更新 offset 时，务必在
img.onload后再绑定事件，确保img.width/height可读。
总结：Konva 的图案填充不是“所见即所得”的坐标系，而是严格绑定原始图像像素空间。解决偏移问题的关键，在于建立「舞台坐标 → Konva 形状坐标 → 原始图像像素坐标」的完整映射链。只要在 mousemove 中实时执行该映射并更新 fillPatternOffset，即可实现像素级精准的图案跟随效果。
