跳转至

有序集合重排设计规格

{
  "paths": ["packages/lab/src/ListInput/**", "packages/lab/src/TransferList/**"]
}

用户意图

对列表或行集合进行重排的人应了解正在移动的是什么、它将落在哪里,以及更改何时被提交。指针和键盘路径应传达相同的候选位置,而不会让周围项目过早跳动。

此处理方式用于更改集合内的顺序。自由画布放置和文件拖放目标需要单独的设计规格。

设计原则

  • 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