跳转至

操作组契约

{
  "scope": "global",
  "triggers": {
    "interaction": ["FR1", "FR2", "FR3", "FR4", "FR5"]
  }
}

意图

一个人可以按下一组同级操作中的某一项,在其余操作上滑动,高亮随之移动,并在抬起时所在的操作上触发,所有组都以相同方式工作,SegmentedControl 是唯一被点名的例外。每个成员都从同一个共享实现获得该行为;菜单以及 Selector 和 MultiSelector 的选项则从菜单按下模型获得,因此没有任何成员自行实现。

成员规则

当某个组件渲染一组两个或更多同级操作,且这些操作是瞬时、切换或选项类操作,用户从中选择一个时,该组件即为成员。当前成员包括:

  • 菜单:DropdownMenu、ContextMenu 及其子菜单,TopNav 的导航菜单(TopNavMenu)、SideNavHeading、TopNavHeading 和 NavHeadingMenu;以及 BreadcrumbItem 的 menu,它渲染 DropdownMenu 的项;
  • TabMenu 的选项卡选项菜单;
  • 选项列表:Selector 和 MultiSelector 的选项,以及 DateInput、DateTimeInput 和 TimeInput 的滚轮;
  • AlertDialog 的操作;
  • ButtonGroup 和 ToggleButtonGroup;
  • DateRangeInput 的预设,即一个带标签的预设按钮组;
  • Toolbar 的按钮;工具栏内部的字段会被跳过;
  • Banner 和 Toast 的操作行,当一行含有两个或更多同级操作时。

Dialog 的页脚、Card 的页脚或任何 LayoutFooter 中的操作行通过组合 ButtonGroup 获得该行为。

之后构建的符合该规则的组件会自动按规则加入,包括操作面板、标签栏或导航栏、筛选标签组和评分。

SegmentedControl 是点名的例外:本系列的规则对其不具约束力。

以下不是成员:

  • 文本输入框和作为一个整体的 InputGroup,其输入框保留光标和选区,其附加控件属于该输入框而不是构成一组;
  • TabList,其可滚动行需要拖拽来滚动,且其标签切换视图;
  • Pagination 和 Stepper,是页面流程中的内联页面控件,而非菜单;
  • TopNavMegaMenu 的面板,是 role="group" 中的链接浏览网格,不是菜单(component:TopNavMegaMenu FR5);
  • SideNavItem 的折叠轨道浮出层,是该项导航行的弹出层,不是菜单;
  • Popover 本身,是一个内容拥有自身角色的表面;其中的菜单遵循其自身组件;
  • Calendar 的日期网格,是带有自身键盘和范围选择模型的二维日期网格,滑动提交会破坏它;
  • RadioList、CheckboxList 和 SelectableCard,它们的行和卡片位于滚动列表中;
  • Token 芯片,它们可移除且没有组控制;
  • Typeahead(也包括 Tokenizer 的)、CommandPalette 的建议列表,以及聊天撰写器的触发菜单,其焦点保持在文本输入框内,与文本输入框的行为相同。

共享所有者

一个共享的内部实现为除菜单以及 Selector 和 MultiSelector 的选项之外的每个成员提供 FR1–FR5(architecture:interaction-modality INV13);那些成员从 module:DropdownMenu/useMenuPress 获得这些行为。没有任何成员另存一份副本。

规范概念

  • 操作组(Action group): 一个人从中选择一个的两个或更多同级操作。
  • 按住指针(Held pointer): 尚未抬起的按下,跨组跟踪。
  • 抬起操作(Lifted action): 指针抬起时其下方已启用的操作。

跨组件不变量

  • FR1 — 抬起决定。 在触控呈现下(spec:AST-094 FR13),在成员中,按下某个操作并滑过其同级操作时,会作用于指针抬起时所在的操作,并通过该操作自身的激活机制执行;从未离开其操作的按下则作用于该操作。一个手势最多触发一次(spec:AST-094 FR26)。滑动之后,焦点行为与点击抬起操作时的行为相同。鼠标按下行为与平台原生按钮相同:作用于它开始按下时所在的操作,并在该操作上释放。
  • FR2 — 高亮跟随指针。 当指针保持按住时,其下方已启用的操作被高亮,一次至多一个;在禁用操作、间隙或组外上方不高亮任何内容(spec:AST-094 FR27)。
  • FR3 — 滑出即取消。 在组外抬起的手势不作用于任何内容;第二根手指以无任何作用的方式结束手势(spec:AST-094 FR28),如同失去焦点或指针被取消时那样(spec:AST-094 FR44)。为该手势而打开的成员是否保持打开,由该成员自行决定。
  • FR4 — 切换组仅切换抬起时所在的操作。 在切换组中,只有抬起时所在的操作发生切换;滑过其他操作永远不会切换被经过的操作。
  • FR5 — 手指与笔,同一目标规则。 在触控呈现下,该行为适用于手指和笔;鼠标按下行为如 FR1 所述。在跟踪期间,组在其元素上保持一个 pointerdown 监听器,在成员需要处可取消;仅在按下期间添加文档监听器,并在释放时移除它们;还可以在释放后到该手势的点击发生前,装备一个文档级点击吞掉器;除此之外没有其他空闲监听器(spec:AST-094 FR19, FR24)。44 px 目标仅为每个成员在粗指针下的命中扩展。键盘和辅助技术行为不变。

允许的组件变体

  • 操作在激活时做什么,以及成员如何显示其高亮,都由成员自行决定。
  • 菜单保留自身的打开与交接(spec:AST-094 FR29)、在所有指针类型下的按下与拖拽,以及其滚动规则;FR1 的触控范围和 FR5 不改变它们。
  • Selector 和 MultiSelector 的选项保留菜单按下模型在所有指针类型下的按下与拖拽(component:Selector FR7);FR1 的触控范围和 FR5 不改变它们。
  • 滚轮是滚动容器:拖拽使其滚动(与现在一样),点击作用于其下方的选项;只有未滚动的按下才会跟踪。

代表性矩阵

成员与状态 共享不变量 刻意变体
DropdownMenu / 在行与行之间滑动 被抬起的行生效;一次只高亮一行 打开与交接仍由菜单负责(FR29)
AlertDialog / 从 Cancel 开始滑动 被抬起的操作执行;在外部抬起不产生任何效果 操作的顺序与堆叠保持局部性
ToggleButtonGroup / 在三个 toggle 上滑动 只有被抬起的 toggle 发生变化 单选或多选仍由该组决定
Toolbar(含字段)/ 滑动 按钮被追踪;字段会被跳过 工具栏所承载的控件由局部决定

采用与例外

组件或表面 采用要求
菜单以及 Selector 和 MultiSelector 的选项 通过 module:DropdownMenu/useMenuPress 遵循 FR1–FR5。
TopNav、SideNavHeading、TopNavHeading、NavHeadingMenu、BreadcrumbItem 和 TabMenu 的菜单 作为菜单,通过 module:DropdownMenu/useMenuPress 遵循 FR1–FR5。
日期和时间滚轮 通过共享实现遵循 FR1–FR5。
AlertDialog 的操作 仅追踪这些操作。
ButtonGroup、ToggleButtonGroup、Toolbar 追踪兄弟按钮;其中的字段被跳过;toggle 遵循 FR4。
DateRangeInput 的预设 仅追踪预设按钮。
Banner 和 Toast 的操作行 仅追踪包含两个或更多兄弟操作的行。

这些是必须达到的结果,而非声称已全部完成采用。成员规则下列出的被排除组件并不是待批准的例外;它们本就不属于该家族。

验证映射

契约 验证方式 代表性成员与状态
FR1–FR3 共享实现测试及各成员的指针流测试 在菜单上滑动、AlertDialog 的操作、ButtonGroup;在外部抬起
FR4 ToggleButtonGroup 指针流测试 在三个 toggle 上滑动;只有被抬起的 toggle 发生切换
FR5 使用鼠标、笔、手指、键盘和屏幕阅读器进行的成员测试 仅在粗指针下为 44 px 目标;键盘和屏幕阅读器路径保持不变
  • spec:AST-094/DEC-17 — 每个兄弟操作组都以相同方式追踪被按住的指针。

DEC-1 — 跨操作滑动仅限触屏

决策者: cixzhang,2026-11-03

滑动式按下仅在触摸呈现下生效。桌面鼠标按下时的行为与原生按钮一致:只有被按下的操作会激活,不会在其他操作上拖动。

已否决:所有指针。

未决问题

无。

内容边界

本文件负责操作组成员关系以及共享的按下、滑动和抬起行为。它不重复组件属性表、各操作的功能、菜单打开方式或共享实现的阈值。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx