# OneOS V2 全局列表操作列调整设计 ## 背景 车辆资产列表当前把全部行操作收进自建“更多”菜单，不符合 OneOS V2 使用公共 `OperationActions` 的要求。现行全局规范又将“查看详情”定义为低频浏览动作，默认收入“更多”，与本次确认的“双外置”方向不一致。 本次调整同时修正规范与车辆资产页：将“查看 / 详情”定义为稳定的首要入口，与常用工作流动作共同外置；低频管理、历史与危险操作保留在“更多”菜单。 ## 目标与范围 ### 目标用户 使用 OneOS V2 台账的运营人员、业务经办人和管理员。 ### 核心任务 用户在扫描列表时，可以直接进入详情或执行最常用的工作流动作，不必先打开菜单。 ### 本次范围 - 更新 OneOS V2 全局 `OperationActions` 规范。 - 同步公共组件说明、组件行为和相关设计系统引用。 - 将车辆资产列表迁移到公共 `OperationActions`。 - 保留车辆资产页现有的查看详情、编辑和设置运维负责人能力。 ### 不在范围内 - 不修改车辆资产的信息架构、筛选、列结构和详情页。 - 不新增业务权限或后端接口。 - 不批量迁移所有历史台账；全局规则用于后续迁移和新页面。 ## 全局操作分级 操作列外置动作最多两个，固定按下列顺序显示： 1. 查看类入口：`查看`、`详情`或`查看详情`。 2. 一个常用工作流动作：`编辑`、`处理`或`处置`。 其余动作进入“更多”菜单： - 低频管理：设置或修改负责人、转交等。 - 留痕与历史：查看记录、操作记录、历史日志等。 - 高风险操作：撤回、终止、删除等。 “查看记录”表示历史或留痕查询，继续视为低频动作；它不等同于进入当前业务对象的“查看详情”。 ## 显示规则 ```text [查看/详情] [编辑/处理/处置] [⋮ 更多] 固定首位 最多一个 按需显示 ``` - 只读台账仅外置“查看 / 详情”。 - 没有查看入口时，可外置最多两个常用工作流动作。 - 没有更多动作时，不显示省略号按钮。 - 没有任何可用操作时显示 `-`。 - 权限过滤在布局分配前完成，避免空菜单或占位按钮。 - 操作列不换行，PC 建议宽度为 `148–184px`，按外置文案长度在页面级固定。 - H5 继续遵循 44×44px 最小触控热区。 ## 车辆资产页落地 车辆资产列表每行使用： - 外置一：`查看`，进入车辆详情页。 - 外置二：`编辑`，打开现有车辆编辑流程。 - 更多：`设置运维负责人`。 操作顺序在所有行保持一致。无运维管理权限时，“更多”菜单不显示；若编辑权限也不可用，则只保留“查看”。 车辆页删除自建 `ActionsMoreMenu` 及其专属菜单皮肤，改用 `src/common/OperationActions.tsx` 和 `src/common/vm-operation-actions.css`。业务回调保持不变。 ## 组件与文档同步 需要保持下列内容一致： - `src/resources/design-system/DESIGN.md` §3.16 - `src/resources/design-system/chapters/03-components.md` - `src/prototypes/vm-shared/DESIGN.md` - `src/common/operation-actions-spec.md` - `src/common/OperationActions.tsx` - `src/common/vm-operation-actions.css` 公共组件应把详情类 `view` 动作放到外侧首位，把“查看记录 / 操作记录”等历史型动作分入更多菜单。`splitOperationActions` 需区分详情入口与历史记录，不能再把两者合并为同一低频类别。 ## 交互与无障碍 - “更多”触发器使用 `MoreHorizontal` 图标，`aria-label="更多操作"`。 - 菜单支持点击外部和 `Escape` 关闭，并沿用公共组件的键盘与焦点行为。 - 外置操作具有可见的悬停和键盘焦点状态。 - 冻结操作列中的菜单不得被表格行、滚动容器或相邻单元格遮挡。 - 危险操作需要保留公共组件的危险态表达，不与普通动作混排。 ## 验收标准 - 全局主规范、章节规范、共享规范和公共组件说明不存在冲突表述。 - 公共组件默认按“查看在前、工作流动作在后、更多按需”渲染。 - 车辆资产页显示“查看、编辑、更多”，顺序和样式符合全局规范。 - 查看详情、编辑、设置运维负责人沿用原有业务行为。 - 权限受限时不显示未授权动作，也不出现空“更多”按钮。 - 操作列在桌面端不换行，菜单不被表格遮挡。 - 键盘可以聚焦并触发所有可见操作，`Escape` 可以关闭菜单。 - 相关自动化测试、类型检查和构建通过；通过浏览器检查桌面宽度及窄视口表现。 ## 测试策略 - 为公共 `OperationActions` 补充或更新渲染顺序、只读状态、无更多动作和权限过滤测试。 - 为 `splitOperationActions` 覆盖详情类与历史记录类的分类差异。 - 为车辆资产列表覆盖三个动作的存在性和回调触发。 - 运行项目现有测试、类型检查和构建。 - 在本地浏览器验证操作列宽度、冻结层级、菜单遮挡、悬停与键盘焦点。