画廊手柄

鼠标悬停在画廊行上时显示操作手柄。所有拖拽仅改写 ag:crop 与 ag:group，不保存像素坐标，也不会自动写入 ag:rows。

五类手柄

手柄	位置	作用	写回的参数
分隔条	两格之间	相邻两格宽度互补，行高不变	两格的 ag:crop
行底横条	行下方、图注间隙	整行高度增减，列宽比例不变	每格 ag:crop
前后交换	格子左右两侧	与相邻图片交换位置	交换两行源码
并入相邻行	行首 / 行尾	将图片移入上一行或下一行	重写 ag:group，清除过期的 ag:rows
链接按钮	格子右下角	锁定整行，自动打包不再拆分或合并	每格写入相同 id 的 ag:group

一次拖拽对应一次提交与一步撤销；拖动过程中按 Esc 可取消，并恢复拖动前的几何状态。

拖动竖向分隔条时，相邻两格宽度互补，行高保持不变。

只改参数，不改文件结构

拖动后，源码仅新增参数片段：

![A|ag:crop=1.42:1|ag:top=0:100:18](assets/photo/01-fjord.jpg)

其中不含像素宽度或行内样式。更换主题、字号或窗口宽度后，比例仍按同一规则重新计算。

拖拽不会固定行切分：ag:rows 仅来自手动写入；比例变化后，未绑定的组会重新分行。如需固定成员，使用链接按钮写入 ag:group；解除绑定后，该组恢复自动路由。

控件会自适应降级

格子变窄时，操作区依次降级：双托盘、折叠托盘、竖排、隐藏。各状态均不重叠，也不遮挡图片主体。

无手柄的场景

场景	原因
阅读视图	手柄仅在实时预览中显示
列表项内的图片	项目符号使“行”的边界不明确
表格单元格	宽度由表格决定，仅保留操作按钮
单图（非画廊）	使用右下角调宽角标，参见拖宽与对齐

锁定整行

![G|ag:group=1](assets/ratio/ratio-4x3.svg)
![H|ag:group=1](assets/ratio/ratio-1x1.svg)
![I|ag:group=2](assets/ratio/ratio-3x2.svg)
![J|ag:group=2](assets/ratio/ratio-16x9.svg)

相同 id 的连续图片锁定为一行；相邻两行使用同一 id 时会合并为一行，因此必须以不同正整数区分。锁定后，自动打包不会并入其他图片，也不会拆分该行。

链接按钮为开关：再次点击解除绑定，仅清除 ag:group，该组恢复自动路由；不会同时写入 ag:rows 固定当前分法。

下一步

• 行切分与混合比例
• 参数语法：手柄写回的参数定义
• 拖宽、对齐与复位：单图手势

相关阅读

• 行切分与混合比例
• 拖宽、对齐与复位
• 命令与入口