状态:手册组合示例,不是产品方案;所有字段、版本、权限和回执均为测试替身。设计仍暂停,本页不新增设计稿,不声明实现、运行或视觉验收通过;全部步骤为预期行为,服务、辅助技术、键盘和四端走读均未实际运行。四端呈现为本例 YUDS 默认建议,不是平台强制规则;HarmonyOS 原生组件、系统返回、辅助技术与浮层映射仍待核实。 所属章节:页面与端到端模板
定位:手册组合示例,不是产品方案
本页把组件、任务模式和页面模板连成一条可逐步核查的路径,采用 D06 的合成记录 R-001、范围 S1。所有字段、版本、权限和回执均为测试替身;没有真实共享、上传、支付、审批或生产写入。设计仍暂停;本页不新增设计稿,不声明实现、运行或视觉验收通过。
阅读顺序:先理解用户目标,再看推荐装配和逐步状态,最后把异常与四端路径交给实现。完整契约以链接主档为准,不以本例简化覆盖。
1. 任务卡:先说明做什么,不先挑组件
- 使用者目标:在 S1 的共享资料清单找到 R-001,阅读详情,修改允许修改的信息,保存后确认结果,再返回原清单。
- 合成对象:R-001,名称“资料甲”;版本 v1。名称、金额与币种、纯日期、分类选择值、备注承接 D06;金额只是输入夹具,不代表费用、付款或财务规则。
- 范围含义:“共享资料”只是中性清单标题,不表示所有人可见,也不授予分享权限。S1 是合成范围,不是真实租户。
- 执行语义:“保存资料”在本例是一次显式受控提交事件;只有与该次对象、基准及任务匹配的成功回执才能说保存成功。未承诺自动保存、草稿服务、离线写入、跨端继续或撤销服务。
- 任务边界:查询、勾选、浏览、编辑、保存是不同意图。打开详情不是选择;勾选不是编辑;字段接受不是远端保存;关闭面板不是取消已发写入。
- 不适用:行业审批、成员授权管理、批量写入、附件生命周期和真实协作锁不在本例。需要这些能力时另按相应主档接入,不从清单名称推导能力。
事实与版本主档:对象、任务与流程的衔接、权限变化、并发修改与保存冲突。原始 D06 与能力开关见端到端任务旅程与验收案例。
2. 推荐装配:一个任务,不是一屏组件展览
| 区域 | 本例选择 | 保留的责任 | 不这样拼装 |
|---|---|---|---|
| 页面身份 | 壳+标题“共享资料清单”+可披露范围 S1 | 当前范围与返回路径可辨 | 把范围藏在头像提示里,或切范围后沿用旧数据 |
| 查找 | 查询输入+分类筛选+已应用条件摘要 | 查询原稿与已应用查询分离 | 每按键就覆盖结果身份,晚结果冒充当前查询 |
| 结果 | 记录列表;确有列关系时才用普通数据表 | 稳定记录 ID、状态、可明确打开的名称 | 为企业感强上复杂网格;整行点击同时勾选和打开 |
| 选择 | 可选的独立复选入口+已选范围说明 | 集合与当前查看项分离 | 将当前详情高亮冒充“已选1项” |
| 详情 | 对象详情页;宽窗可在非模态侧区读取 | R-001 与版本身份、获准内容、编辑入口 | 在小型 popover 里承载整份长表单 |
| 编辑 | 单一表单,字段按阅读顺序分组 | 原始稿、接受值、基准、保存状态 | 每张字段卡各设“保存”主按钮,却一起提交整份对象 |
| 选择值 | 简单候选用单选;复杂查找才用值帮助 | 子选择接受只更新父草稿 | 子层“确定”直接提交父表单 |
| 保存与结果 | 唯一主操作“保存资料”+持续结果位置 | 当前请求身份、可信结果、恢复入口 | 关闭动画或绿色 toast 作为成功证据 |
| 返回 | 明确返回清单 | 重新授权后恢复仍有效查询和定位 | 回列表即重放保存,或刷新丢失原查询 |
组件入口:操作组件:按钮与动作入口、输入组件:文本、结构化编辑与专用输入、选择组件:值、范围与层级、容器组件:分组、展开与工作区组织。模板入口:页面与端到端模板。
选择能力的非适用处理
本例保留勾选分支只为核查“选中不等于查看”。若真实产品没有任何集合任务,移除复选和批量工具栏,不为了示范组件提供无意义勾选。本例不虚构“批量保存”。如需展示选中集合,仅作本地集合查看,不能暗示远端动作能力。
2.1 任务、模板与布局分别选择
| 当前问题 | 选择的页面模板 | 可换的布局 | 不改变的跨页任务 |
|---|---|---|---|
| 我要找资料 | 列表工作台 | 全宽列表/带详情侧区 | 查询→打开→返回同一查询 |
| 我要理解 R-001 | 对象详情 | 单页/主从内容区 | 阅读→进入编辑→返回详情 |
| 我要修改获准字段 | 编辑与提交页 | 单列分组/有参照的双区 | 原稿→校验→保存→确认结果 |
| 我要核查复杂依据 | 本例默认不启用;需要时选工作空间 | 并排或明确参照页 | 查看依据后返回同一编辑任务 |
布局只分配区域,页面模板组合当前任务组件,跨页旅程负责上下文与结果连续性。窄窗将双区改成顺序页面,不会把一个保存任务拆成多个任务。这里借鉴 SAP 布局与页面类型的区分,具体 R-001 组合为 YUDS 示例,不是 SAP 产品模板。
3. 正常路径:从入口到返回
以下每一步均为预期行为,实际未执行。任务标识 T1 仅作合成追踪标识。
| 步骤 | 用户所做 | 界面应表达 | 状态与事件边界 | 主要契约 |
|---|---|---|---|---|
| 1 浏览 | 进入 S1 清单 | 标题、当前范围、读取状态 | 先授权再显示;空记录与失败不同 | 权限主档、CT-LIST |
| 2 筛选 | 输入“资料”,选择分类并应用 | 已应用条件与对应结果 | 编辑查询原稿不伪称已应用;旧查询回包不覆盖新结果 | QRY-SEARCH、查询、选择范围与批量执行 |
| 3 选择 | 勾选 R-001,再打开其名称 | 选择集合与详情对象分别可辨 | 勾选集合不因打开详情被清空;打开不触发写事件 | CT-LIST、数据表与交互网格契约 |
| 4 阅读 | 查看 R-001/v1 | 获准内容、版本、编辑资格 | 阅读不表示已编辑或已保存 | 导航、深链接与上下文保留 |
| 5 编辑 | 进入表单修改名称等字段 | 当前目标与未保存状态 | 本地原始稿可含“1.”等未解析输入;不被异步刷新改写 | 字段共同契约、表单校验、草稿与提交 |
| 6 接受选择 | 打开分类选择,换值后接受 | 新值进入同一父稿 | 关闭子层不提交 T1;取消按子会话契约保护原稿与父新修订 | SEL-SINGLE/SEL-HELP、LP-G03 |
| 7 保存 | 激活“保存资料” | 正在保存、对象和任务仍可辨 | 校验成功后发一次受控 T1;重复激活不能另发同一任务 | CMP-ACTION、异步执行、结果核查与恢复 |
| 8 获知结果 | 收到匹配 T1 的确认成功 | “资料已保存”,可查当前值及新基准 | 回执才改变确认状态;toast 可补充,不能是唯一结果 | FB-BANNER/FB-TOAST |
| 9 返回 | 返回清单 | 原查询及仍有效定位;R-001 当前事实 | 先核查授权和数据;不再符合筛选则解释并提供获准查找入口 | 导航主档、权限主档 |
若采用读写分离的详情页,保存成功后可继续留在详情,不自动回列表造成用户错过结果。若实例决定成功后返回,也要在目标清单提供可持续理解的结果与对象定位;此决定必须在实例卡写明。本例默认留详情,由用户返回。
3.1 一次具体走读:改备注,再看到确实保存
这条说明性路径固定:读写权限有效且允许披露全部合成字段、R-001/v1 未被别人修改、查询结果含 R-001、所有读取完成、没有并存子层或新任务夺取焦点;T1 写入由测试替身确认成功并返回 v2。以下焦点预期只适用于这些前提,不覆盖 LP-G05 例外。
- 在清单输入“资料”并应用,按名称“资料甲”打开 R-001。Web 独立页进入可识别的详情标题/主内容起点;原生按所选导航机制使新页面标题与对象身份可获取,不硬套 Web Tab 序列。列表保存查询和原来入口的安全定位。
- 详情显示备注旧值“待补充说明”,版本 v1。选择“编辑资料”后进入编辑标题/表单起点;不自动聚焦金额并弹出键盘,也不自动提交。用户将备注改为“补充阅读顺序说明”。此时屏幕可显示“有未保存更改”,不能显示“已保存”。
- 用户打开“分类”选择器,选择合成候选“参考资料”,再按“使用此分类”。子会话接受后返回仍存在且合法的“分类”触发字段;备注仍为用户的新原稿。接受分类只改变父稿,T1 尚未发出。如果选择器取消,则恢复规则遵循 LP-G03,不清空其他父稿。
- 为演示修正,用户暂把金额写成未完成输入“1.”并按“保存资料”。本夹具明确将此最终提交值拒绝;显示“请补全金额”,关联金额字段,并在错误摘要提供定位入口。焦点到摘要或首个无效字段的选择须在实例卡固定,本例固定到错误摘要,用户激活“金额”后到该字段;不由晚到的校验反复抢焦点。未发 T1,备注原稿仍在。
- 用户把金额修正为合成合法值“1.00”,其他字段保持有效,再按“保存资料”。此时发出一次 T1,界面显示“正在保存资料甲”。无需焦点跳到进度;当前动作忙碌状态可获取,结果尚未证实。
- 匹配 T1 的成功回执到达,返回 R-001/v2,备注确认为“补充阅读顺序说明”。持续结果区显示“资料已保存”,详情采用 v2 新基准。用户没有请求导航时不因回执抢焦点;变化通过适当状态通知可感知。新基准必须来自回执/可信读取,不从按钮点击自行加版本号。
- 用户激活“返回清单”。核查仍有权限且 R-001 仍在该查询后,恢复原查询及 R-001 的合理位置。Web 本例固定将焦点回到仍有效的 R-001 名称入口;原生按导航返回机制恢复可理解的记录定位,并验证辅助技术路径。如果行不再存在、授权变化或已有新任务接管,改按导航/LP-G05 合同处理,不无条件回焦。
这次走读只有一次已发写事件。步骤 4 被拒绝的尝试不是保存失败回执,步骤 3 接受分类不是保存成功,步骤 6 的新基准不是业务审批通过。服务、辅助技术、键盘和四端走读均未实际运行。
4. 推荐与禁止:同一画面也可能是不同任务
4.1 普通编辑不是状态决定
推荐:表单中的“保存资料”使用 D03 普通主操作职责;取消或返回为次要入口。字段错误有文字与关联提示,焦点和错误同时存在。
禁止:因为预期成功而把保存永久设为 success;把只读字段染成 failure;把焦点色当业务选中状态。七角色与固定 step、浅深主题沿Token 契约、主题与状态/色彩语义与可辨状态,三文字角色各九档沿排版层级与文字可读性。本例不新增颜色、字号、间距或命中数值。
4.2 需要参照时保留上下文,不制造层层确认
推荐:简单说明在字段附近;短暂查找用独立值帮助;长资料用明确详情/参照页。手机可顺序打开后返回原稿,宽窗可侧区阅读。子任务有自己的接受/取消边界。
禁止:编辑弹窗内再弹全量详情、再弹筛选、再弹确认;用连续浮层避免页面导航。确需受控子层时继承 CMP-LAYER,而不是任意叠层。背景动作不可穿透,外点、返回手势和 Escape 都不能绕过未保存保护。
4.3 “可见”“可改”“可提交”独立判断
推荐:可读不可改时展示只读详情;仅部分字段可改时明确字段范围;可改但当前提交条件未满足时说明阻塞和真实下一步。
禁止:把只读内容全部改成不可读禁用输入;以“管理员”标签替代逐项能力;对本不允许知道存在的对象显示名称及“申请权限”。本例只在夹具明确允许时展示原因或请求路径。
5. 必备异常分支:状态不是一组颜色
| 注入条件 | 应看到与可做 | 不能做 | 核查点 |
|---|---|---|---|
| 清单确实无记录 | 创建等入口仅在真实具备时提供 | 捏造可创建权限 | FB-EMPTY |
| 筛选无结果 | 展示已应用条件,可修改/清除 | 把空结果说成读取失败 | QRY-SEARCH |
| 列表刷新失败但仍可披露旧数据 | 明示旧数据与失败范围,允许真实读取重试 | 把旧数据当最新,或混用新标题旧操作 | CT-LIST、FB-BANNER |
| 保存前字段拒绝 | 错误摘要与字段定位;保留原始稿 | 清空不完整金额,拿旧合法值提交 | DSP-MESSAGE-SUMMARY |
| 写入已发但结果未知,查询能力开 | 保持 T1 未知,只查询原任务结果 | 无条件“再保存一次” | 异步恢复主档 |
| 写入已发但结果未知,查询能力关 | 说明无法确认;保留获准任务信息及真实退出路径 | 画可用“查询任务”或承诺后台跟踪 | D06 能力开关 |
| 仅撤写权,读权仍有效 | 获准内容只读,停止新写;允许稿按政策处理 | 断言已发 T1 自动取消 | 权限主档 |
| 撤读权 | 停止披露受限值及应用可控缓存/辅助文本 | 仅盖遮罩,或建议导出受限原稿 | YUDS-120200-01 |
| v1 期间出现 v2 | 提示基准变化,获准原稿保留,按真实能力比较重填 | 静默覆盖或默认提供强制保存 | YUDS-120200-02 |
| 用户已转向 R-002,T1 迟到成功 | 按 T1 归属保存可披露结果,不夺新任务焦点 | 把 R-002 标成保存成功 | LP-G05、异步恢复主档 |
| 返回后 R-001 离开筛选 | 说明变化且维持查询;必要时给获准定位 | 偷改筛选以维持旧行,或显示旧状态 | 导航主档 |
关闭仅终止呈现。请求能否取消、结果是否可核查以及何种输入可保留,由明确服务与权限能力决定;没有能力就是限制,不用更精美的反馈补造能力。
6. 四端同任务,不同呈现
具体组件逐项选型见组件平台选型:先定任务,再定呈现;以下为本例 YUDS 默认建议,不是平台强制规则。
- Web:清单+详情路由;空间足够时可非模态侧区阅读。编辑默认独立内容页,短选择才用锚定层。真实列关系采用表格,不因可点击就变成网格。
- iOS/iPadOS:窄内容区域按清单→详情→编辑顺序;短、相关的选择任务可用 sheet,宽内容区可用锚定 popover。完整多字段编辑不塞进小 popover。原生返回与显式取消共享离开保护,不要求模仿 Web 键位。
- Android:窄窗顺序清单/详情,宽窗可列表详情双区;短选择可用模态 bottom sheet,长编辑用完整页面。系统返回先经过当前任务的关闭/离开仲裁。
- HarmonyOS:同样设计清单→详情→编辑的任务路径;首选候选为完整页面和内联表单,具体原生组件、系统返回、辅助技术与浮层映射仍待官方及目标版本核实。不能把 Android sheet 行为当已证实替代。
所有端都要覆盖长名称、最大目标文字、软键盘、RTL、替代输入与授权变化。窗口变化不得重复创建保存任务,旧浮层迟到回调不能写入新页面。布局切换属于呈现变化,不是提交或授权变化。
7. 接入交付卡:把建议变成可验证实例
交付者填写以下内容;缺项就写“待补”,不能用本例推断生产能力:
- 真实对象、范围、字段、稳定身份和并发基准;说明哪些 D06 字段在真实任务不适用。
- 读取、修改、提交、披露和输出权限来源;撤权后草稿处理规则。
- 保存是否原子、请求标识、可信回执、查询开关、取消能力;未知结果恢复路径。
- 当前查询、已选集合、详情对象、父草稿与子选择会话的独立状态所有者。
- 每个平台的布局/原生控件候选、模态性、返回/关闭、焦点恢复和不适用说明。
- 至少运行正常闭环、字段拒绝、查询开/关的未知结果、撤写/撤读、基准变化、迟到回执及增长/替代输入组合。
- 分别附文档审查、设计、实现、运行与视觉证据;尚无证据时均保留未执行/未验证,不把“已写用例”计为通过。
退出本例的条件
已能说明各状态来源、所有动作真实边界以及受限时的替代路径,方可进入下一阶段设计。这里没有宣布达到该条件;设计暂停不因文档补齐自动解除。