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