ContextMenuItem 组件契约
ContextMenuItem 组件契约¶
契约概览¶
| 领域 | 契约 |
|---|---|
| 公共契约 | ContextMenuItem 是从 ContextMenu 入口点以该名称导出的 DropdownMenuItem,包含其 props 类型。 |
| 行为 | 与 ContextMenu 复合 menuContent 中的 component:DropdownMenuItem 相同。 |
| 最终用户影响 | 上下文菜单行在外观和行为上与下拉菜单行完全一致。 |
| 构建者影响 | 构建者无需从 DropdownMenu 导入即可组合 ContextMenu 行。 |
| 兼容性/就绪状态 | 记录已发布的行为;无 API、默认值或 DOM 变更。 |
| 审查检查 | 拒绝与 DropdownMenuItem 不一致的 ContextMenuItem,或该名称背后独立的实现。 |
| 治理规则 | component:DropdownMenuItem;architecture:public-component-api。 |
此表为审查投影;以下正文具有权威性。
意图¶
为 ContextMenu 调用方提供一个以 ContextMenu 命名的行,而无需第二种行实现。
兼容性与迁移¶
- 已发布的默认值保持不变:是。
- 兼容性类别:记录已发布的行为;无公共 prop、默认值、导出或 DOM 变更。
- 受控/非受控行为:不适用。
- 迁移决策:无。
消费者迁移说明属于消费者文档和发布说明。
所有权边界¶
拥有
ContextMenuItem导出名称及其ContextMenuItemProps类型名称。
不拥有 / 非目标
- 所有行行为、语义和目标——由
component:DropdownMenuItem拥有。 - 其周围的菜单——由
component:ContextMenu拥有。
公共概念¶
| 概念 | 封闭值或状态 | 含义 | 可用性 | 默认值 | 所有者 | 稳定性 | 无效值行为 |
|---|---|---|---|---|---|---|---|
| 别名 | ContextMenuItem |
ContextMenu 名称下的 DropdownMenuItem。 | 复合模式 | — | component:ContextMenuItem |
稳定 | 不适用。 |
行为与布局契约¶
| ID | 不变量 | 依据 |
|---|---|---|
| FR1 | ContextMenuItem 与 DropdownMenuItem 是同一个组件,且 ContextMenuItemProps 即 DropdownMenuItemProps;该行遵循 component:DropdownMenuItem。 |
当前源代码 |
允许的变体¶
- AV1 — 无。 该别名自身不添加任何内容。
代表性状态¶
| 状态 | 必需不变量 | 允许的变体 |
|---|---|---|
| 复合行 | 在 ContextMenu 内渲染为 DropdownMenuItem 行。 | 行内容。 |
转换与优先级顺序¶
- ORD1 — 无。 该别名自身没有优先级。
性能与资源¶
- PR1 — 自身无。 资源属于 DropdownMenuItem。
无障碍契约¶
- AR1 — 同一行。 语义和键盘行为属于
component:DropdownMenuItem。
设计关系¶
| 解剖结构或状态 | 设计要求 | 表示权威 | 层级角色 | 组件契约 |
|---|---|---|---|---|
| 行 | 与下拉菜单行相同。 | component:DropdownMenuItem |
突出 | FR1 |
component:DropdownMenuItem 拥有行的目标,component:ContextMenu 在其主题解剖结构中映射指针操作行,因此本记录不包含解剖结构-主题映射。
家族与系统关系¶
component:DropdownMenuItem拥有行契约。component:ContextMenu拥有菜单。
验证映射¶
| 契约 | 验证 | 代表性状态 | 变更或失败预期 | 审计部分 |
|---|---|---|---|---|
| FR1、AR1 | ContextMenu.test.tsx 复合用例("renders menuContent as menu items"、"renders ContextMenuItem endContent"、"calls onClick when compound item is clicked") |
复合行 | 不渲染或不像菜单行那样工作的 ContextMenuItem 将失败。证据缺口:没有测试断言该导出与 DropdownMenuItem 是同一个组件。 | audit:ContextMenuItem/api |
决策日志¶
无组件级决策。
未解决的问题¶
无。
内容边界¶
本文件不重复使用者的 prop 表格/示例或行契约(row contract),而是链接到其所属文档。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx