有序集合重排设计规格¶
用户意图¶
对列表或行集合进行重排的人应了解正在移动的是什么、它将落在哪里,以及更改何时被提交。指针和键盘路径应传达相同的候选位置,而不会让周围项目过早跳动。
此处理方式用于更改集合内的顺序。自由画布放置和文件拖放目标需要单独的设计规格。
设计原则¶
- DR1 — 重排从显式手柄开始。 交互 MUST 从专用控制件开始,使激活是有意为之,且其他项目操作仍然可用。
- DR2 — 移动中的项目保持可识别,且不显得被抬高。 源项目和跟随指针的预览 MUST 体现为同一项目处于临时移动状态,并且 MUST NOT 暗示抬高的卡片。
- DR3 — 放置位置在集合改变之前预览。 清晰的插入提示 MUST 标记候选位置,同时周围项目在提交前保持稳定。
- DR4 — 仅提交一次。 集合 MUST 在拖放或释放时采用新顺序,而不是在指针经过项目时反复提交。
- DR5 — 完成后恢复正常层级。 临时拖拽处理 MUST 在拖放或取消时立即消失,已就位项目 MUST 恢复其正常对比度和深度。
结构与层级¶
| 角色 | 目的 | 必需关系 |
|---|---|---|
| 重排手柄 | 启动并保留对交互的所有权 | 属于一个项目,且仍可与项目激活区分 |
| 静止源项目 | 在活动拖拽期间保留项目来源 | 在提交前保持原位,并与预览共享临时处理 |
| 移动预览 | 跟随指针移动 | 复刻源身份,而不增加抬升卡片的立体感 |
| 插入提示 | 标记候选的有序位置 | 出现在集合排序轴上的项目之间 |
| 周围项目 | 提供稳定的空间上下文 | 在重排提交前不发生移动 |
| 已就位的集合 | 显示最终顺序 | 完成后让每个项目恢复到正常状态 |
状态表示¶
| 状态 | 必需表示 | 允许的变化 |
|---|---|---|
| 静止 | 手柄可被发现,且不会压过项目内容 | 手柄位置可遵循集合家族风格 |
| 拖拽中 | 源项目和移动预览使用相同的临时弱化强调处理 | 指针预览可在两个轴上自由移动 |
| 候选位置 | 一条清晰的强调插入线标记项目将落下的位置 | 线条长度和缩进可遵循行几何 |
| 已放置 | 项目按已提交的顺序就位,临时拖拽处理清除 | 就位动效可使用系统的快速移动语言 |
| 已取消 | 原始顺序和正常对比度立即返回 | 即使启用了常规动效,取消也可立即发生 |
响应式与输入行为¶
- DR6 — 放置位置遵循集合轴。 指针预览可以自由移动,而候选顺序 MUST 在集合的排序轴上计算。
- DR7 — 键盘和指针共享插入提示。 键盘重排 MUST 暴露与指针重排相同的候选位置表示。
- DR8 — 减少动效时直接更新。 当动效减少时,最终顺序 MUST 无需动画移动即可更新。
可访问性意图¶
焦点应贯穿整个操作留在重排手柄上。位置变化、取消和完成应使用无需看到预览即可理解的语言宣告。临时弱化强调处理仅在主动重排期间可以接受,且不得降低内容的持久可读性。
焦点机制、键盘命令、实时区域措辞和集合变更属于组件与家族契约。
代表性示例¶
- 一行从其手柄开始移动;原始行和指针预览暂时弱化,同时一条线标记候选间隙。
- 键盘移动一次改变一个位置的同一个插入提示,同时焦点保持在手柄上。
- 拖放提交一次,然后集合进入新顺序。
视觉参考¶
不包含规范性资产。指针和键盘序列归属于 docs/design/assets/ordered-collection-reordering/。
组件契约链接¶
spec:AST-103 将此处理方式应用于每个可重排集合,包括其键盘重排模式(DR7)。
决策日志¶
DEC-1 — 重排遵循本设计,而非滑开模式¶
参考: design:ordered-collection-reordering/DEC-1
决策者: cixzhang, 2026-10-26
当项目被拖拽时,周围项目保持在原处,源项目保持原位并变暗,移动预览跟随指针,项目之间的强调插入线标记其将落下的位置;项目在拖放时一次性重新排列,取消则立即恢复。键盘重排显示相同的插入线。与指针下移动的相邻项目相比,仅在释放时才产生动作的放置标记对于较小的放置目标更精确。
已否决:拖动过程中相邻项向旁侧滑开。
未决问题¶
- OQ1 — 预览处理。 在浅色、深色和高对比度主题下,对静止源项和移动预览同时采用弱化强调是否仍然合适?
- OQ2 — 插入几何。 哪些集合族需要对默认的项间插入线做出刻意例外?
- OQ3 — 代表性属主。 哪个组件或族应提供规范的指针和键盘证据?
内容边界¶
本文件定义有序重排的视觉和交互意图。它不定义事件处理、键盘命令、焦点实现、播报字符串、列表变更、令牌名称、画布放置或文件拖放行为。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx