状态:全篇为建议,可调整,未经实现验收;层级焦点所用的 cells-only treegrid 键盘模型是候选。业务案例是建议验证场景,不是已确认产品规则;§10 夹具是任务契约夹具,不批准预算算法、授权继承或事务方案;交付测试及实际键盘、读屏、触控验证均未执行。 更新:2026-10-18 所属章节:复杂数据工作模式
矩阵是任务模式,是否使用普通表、交互网格或树形网格由行为决定。组件焦点基线见数据表与交互网格契约。
1. 用途与不适用场景
矩阵将两组维度放在行列轴上,在交叉处表达值或状态。适合项目×月份预算、角色×能力查看、资产×指标比较。若各格没有同一可解释关系,或主要是长文逐项阅读,普通列表/详情更合适。
“角色×能力”只表达授权结果和操作入口,权限继承、拒绝优先级和授予规则由产品定义。预算矩阵只表达值、来源和校验,不计算或决定估值公式。色块热图不能替代精确数值与状态文字。
2. 结构与数据契约
必需:矩阵标题、行维度、列维度、交叉值定义、单位/期间/版本、必要的层级与汇总说明。可选:维度切换、转置、固定标题、钻取、编辑与范围选择。每个维度成员有稳定 ID,交叉值以维度组合和版本定位,不能只用屏幕坐标。
示例:行“项目”、列“2026 年 1–12 月”,单元格“该项目该月已批准预算,人民币万元”。总计是否可加、缺失值如何影响汇总、比例是否可平均均由产品给出。相同显示格式不代表相同业务口径。
行列标题包含单位作用域:整张表一致可统一说明;指标单位不同时,标在对应列或指标组;币种按行变化时,逐行标明。固定标题不能盖住这些信息。转置只改变显示轴,不改变记录身份、计算和权限。
3. 阅读、定位与比较
密集矩阵先保留身份与单位,再考虑冻结首行首列。当前格可通过行列联合高亮帮助定位,但焦点、选择和数据异常有不同表达;色彩之外有边界或文字提示。
对多层表头,明确每格对应的完整标题链;视觉合并格不能让读屏无法知道月份属于哪年。内容结构应避免无必要的合并单元格,尤其可编辑区域。窄空间可以选择少数列、期间窗口或分步查看,但比较所需关键列要能同时访问。
缺失、未加载、不可访问、不适用、计算失败和 0 各自表示。因为权限少了一部分数据时,不把可见子集汇总当完整总计。不能用汇总的差额反推并泄露被隐藏成员;产品须决定可披露聚合范围。
4. 矩阵状态与行为
分离维度准备状态、值加载状态、当前范围、编辑草稿和汇总刷新。维度已加载而某个期间失败时,只对受影响区域标记并重试;不要整张表变空,也不要把未返回值补 0。
切换期间、维度或转置前处理未提交更改。返回结果必须绑定原查询与维度版本;读取旧响应不得覆盖当前矩阵。写操作则保留自身任务结果,不因用户切换了视图就丢弃回执。
范围选择表示具体格集合;是否包含隐藏列、收起成员和汇总格必须明确。默认不把不可见成员悄悄纳入填值范围。全行/全列动作展示实际维度成员、期间与可操作数量。
5. 编辑与汇总校验
可编辑格、派生格、只读格和受限格应有可辨的表达,不能都表现为灰色文本。进入编辑后显示完整精度和单位;退出编辑时,展示格式可以简化,但不得无声改变提交数值。
修改一个月可能使年度总额、分摊比例或跨项目约束失效;产品提供规则,界面展示受影响范围。校验可发生在格、行、列或整张矩阵,错误摘要必须定位到具体约束及相关格。
建议复杂跨格约束采用暂存更改+明确提交,提供更改数、原值、新值与影响预览。按格自动保存只在每格能独立合法、失败可恢复的场景评估,不能把业务上必须原子提交的矩阵拆成几十次不受控写入。
粘贴/填充按数据表与交互网格契约预览映射;跳过汇总格、只读格及受限格时给出实际结果。撤销仅覆盖明确支持的本地草稿或后端可回滚动作,不能把撤销键当跨事务恢复保证。
6. 层级、树形表与树形网格
树形场景以稳定节点和父子关系为基础。显示层级、展开状态、当前可见子项及未加载分支;父行汇总是节点自身值、子树合计还是二者组合需明确。展开不意味着选择全部子项。
只读层级表可以使用适当表结构与独立展开按钮;当任务需要复合单元格导航及层级操作时再考虑 treegrid。APG 将 treegrid 定义为带层级的交互表格结构,具有额外的展开、焦点与选择约定,不能仅加角色替代实现。APG Treegrid
采用 cells-only treegrid 候选时,完整模型接续数据表与交互网格契约「B1-TREE:树与树表」的 B1-TREE-KEY;其他模型须完整另审,不将本模型套给普通选择树或层级 table。左右键只横移,首层级格 Enter 承担本行披露/收起,不能同一按键同时改变列与树结构。折叠含焦点或编辑宿主的分支前,先按 B1-TREE-VIRTUAL 处理子层、输入法及未提交草稿仲裁;未获准退出时不折叠,获准后才将仍由本次操作拥有的焦点迁到可见祖先层级格;焦点已合法外移时不抢回。
父节点批量操作须说明作用于自身、当前后代还是动态整个子树;未知后代不能通过本地勾选推算。选择契约见选择组件:值、范围与层级,远程执行范围见查询、选择范围与批量执行。
7. 键盘与辅助技术验收
只读矩阵可按表头关联阅读;交互矩阵采用网格导航及编辑模式,见数据表与交互网格契约。进入单元格时能理解行身份、列身份、值、单位、是否可编辑与异常。固定或虚拟区域不得产生重复朗读和错列关联。
框选、拖拽填充和调宽同时有键盘路径及无需拖拽的单指针路径,例如点选起止范围、点击填充命令、点击调宽按钮;分别验证权限、范围、校验及结果一致。转置与展开也提供清楚的可访问入口。存在大量列时提供范围定位、搜索或跳转支持,但快捷路径不能成为唯一可达路径。长名称、文本缩放和减少动态效果必须保持身份可辨。
8. 业务案例
以下案例是建议验证场景,不是已确认产品规则。
年度预算
项目 A×3 月显示“120 万元,草稿”;用户把 3 月改为 130、4 月改为 110,年度合计不变。服务端发现 4 月已封账,不能只提交 3 月后仍宣称整体平衡;按产品事务规则整体拒绝或明确部分成功和剩余不平衡,保留草稿。
资产指标
资产行、指标列分别为出租率、收入和面积,各自单位不同。出租率缺少分母时标“无法计算”,不能补 0%;总计出租率依据产品定义的分母汇总,不由通用矩阵做简单平均。
权限查看
角色行、权限列显示继承来源、显式授予、拒绝或未知;勾选展示不等于用户有权授权。提交前由产品重新校验可授予范围,高影响变更展示影响对象和确认。
9. 交付与失败测试
以下测试均未执行:多层标题、同名不同 ID、转置保持身份、隐藏列范围、某期间加载失败、父子节点部分加载、聚合权限、跨格约束、并发封账、粘贴错误、取消与未知写结果、读屏逻辑坐标、字体放大及恢复布局。
需记录目标矩阵规模、最大层级、真实单元格内容及性能环境。没有证明可访问与编辑可靠前,不能以“支持海量数据”作为完成声明。来源核查:2026-10-18。矩阵业务示例为建议验证场景,不是已确认产品规则。
10. 矩阵操作的确定性夹具
规则 YUDS-090200-01(坐标与范围)
矩阵沿用 YUDS-090100-01~03 的输入、虚拟化与非网格替代要求。格身份由行成员 ID+列成员 ID+版本确定;转置只转换展示坐标。提交预览列出实际目标成员,隐藏列、收起后代、汇总格不会因视觉框选自动进入更改集。选区变化先处理未提交草稿,不把它转写到新坐标。
规则 YUDS-090200-02(层级焦点)
层级列提供明确展开控件,cells-only 键盘以数据表与交互网格契约 B1-TREE-KEY 为准,各列左右键只横移,首层级格 Enter 披露。按 B1-TREE-VIRTUAL 完成子层与草稿仲裁并获准折叠后,含焦点分支才将仍由本操作拥有的焦点移到可见祖先层级格,已合法外移则不抢回,折叠本身保留按稳定身份持有的选择;成员删除/失权另按选择与授权契约处理并通告,不因折叠自动选中或取消后代。普通表替代用可展开行及项目详情表单,必须保留跨格更改清单与统一校验。
夹具
| 规则 | 输入与动作 | 可验预期 | 反例 |
|---|---|---|---|
| YUDS-090200-01 | A×3 月草稿 130、A×4 月 110;转置后核对提交 | 更改仍为 A 的两个月,汇总只采用产品规则;4 月封账按事务规则拒绝整体或明确部分结果 | 转置后写入 B;漏掉 4 月却称整体平衡 |
| YUDS-090200-02 | 子项 C 获焦点;点父项 P 的收起;再用非网格路径编辑 C | 焦点到 P;C 选择状态按明确策略反馈;获准后可重新定位 C,输入与结果一致 | 焦点留在隐藏项;父项自动代表未知全部后代 |
这些是任务契约夹具,不批准预算算法、授权继承或事务方案。实际键盘、读屏和触控验证均未执行。