精读《自由布局吸附线的实现》

本篇精读来自笔者代码实践，没有原文出处请谅解。

自由布局吸附线的效果如下图所示：

那么如何实现吸附线呢？我们先归纳一下吸附线的特征：

• 正在拖动的 box 与其他 box 在水平或垂直位置距离接近时，会显示对齐线。
• 当吸附作用产生时，鼠标在一定范围内移动都不会改变组件位置，这样鼠标对齐就产生了一定的容错性，用户不需要一像素一像素的调整位置。
• 当鼠标拖动的足够远时，吸附作用消失，此时 box 跟手移动。

根据这些规则，我们首先要实现的就是判断当前拖动 box 与哪些组件的边足够接近。

判断 box 离哪条边最近

距离最近的边可能不止一条，水平与垂直位置要分别判断。我们以水平位置为例，垂直同理。

拖动 box 在水平位置可能有 上、中、下 三条边可以产生吸附，而其他 box 同样也有 上、中、下 三条边可以与之产生交互，因此对于每一个目标 box，我们需要计算 9 个距离：

• source 上 vs target 上
• source 上 vs target 中
• source 上 vs target 下
• source 中 vs target 上
• source 中 vs target 中
• source 中 vs target 下
• source 下 vs target 上
• source 下 vs target 中
• source 下 vs target 下

因为 source 的每条边最多只能出现一条吸附线，所以按照 source 聚合一下每条边的最近 target 边：

• source 上 vs min(target 上、中、下) = min 上
• source 中 vs min(target 上、中、下) = min 中
• source 下 vs min(target 上、中、下) = min 下

可以想象，当 source 与 target box 完全一样大时，最多产生三条吸附线（上 vs 上，中 vs 中，下 vs 下）。但一旦 box 高度不同，结果就不一样了，所以我们还需要计算 source 上、中、下 最接近的距离是多少：

source 所有位置最小距离 = min(min 上、min 中、min 下)

然后按照 source 所有位置最小距离筛选 min 上、min 中、min 下，留下来的就是要 source 距离 target 水平位置最近的吸附线。

我们还需要设置吸附阈值，否则所有鼠标位置都会产生吸附。所以当 source 所有位置最小距离大于吸附阈值时，就不产生吸附效果了。

产生吸附效果

吸附的实现方式与拖拽的实现方式有关。

假设拖拽的实现方式是：dragStart 时记录鼠标的起始位置 mouseStartX（Y 同理），在 drag 时产生了位移 movementX，那么组件当前位置就是 mouseStartX + movementX。

如果我们可以拿到吸附产生的反向位移 snapX，那么组件位置就可以实现为：

mouseStartX + movementX + snapX

可以想象当鼠标从上往下移动时，当产生吸附时，snapX 会产生反向作用抵消 box 的向下位移，从而保证 box 在吸附时在垂直方向没有产生移动，这样吸附效果就实现了。

snapX 的值如何计算呢？其实就是上一步的 “source 所有位置最小距离” 取反。

resize 时中间对齐线需要放大双倍吸附力

resize 与 drag 不同，设想鼠标拖动 box 的下方边缘向下做 resize，此时除了组件移动外，还产生了组件高度变高的效果，那么从上、中、下三段观察 box，其位置与鼠标位移的变化关系是：

• 上：位置不变。
• 中：位置向下位移为鼠标位移 * 0.5
• 下：位置向下位移为鼠标位移 * 1

因此如果中间位置产生了吸附线，为了抵消鼠标向下移动，需要产生两倍的 snap 反向位移：

mouseStartX + movementX + snapX * 2

总结

我们梳理了吸附的判断条件与吸附作用如何生效，以及 resize 时中间线吸附的特殊处理逻辑。

自由布局除了吸附之外，还有哪些边界的交互，如何实现呢？希望大家思考与留言。

讨论地址是：精读《自由布局吸附线的实现》· Issue #490 · dt-fe/weekly