跳转至

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