发现于 #4917 (span 废弃提示对齐 div)的实施过程中,不在该 PR 处理 —— 那一单的验收面只是废弃提示的触发条件与去重。
现象 kind:'html' 页面里写一个 span 标签,编译出的节点渲染成一个空元素 ,作者写的文字消失,无提示、无诊断。
实测(packages/components 测试环境,origin/main @ e71c854ce)。源码:
< div className="outer" >< span className="inner" >hello html tier< /span >< p >page rendered< /p >< /div >
渲染结果:
< div class="outer" data-obj-type="div" >< span class="inner" data-obj-type="span" >< /span >< p data-obj-type="p" >page rendered< /p >< /div >
hello html tier 不见了;同一页里 p 标签的文字正常渲染,所以不是整页编译失败。
原因 packages/sdui-parser/src/parse.ts:95 产出的节点把子节点放在 childrenif (children && children.length) node.children = children;packages/components/src/renderers/basic/span.tsx 只读 bodyrenderChildren(schema.body)对照 div.tsx 读的是 schema.children || schema.body,所以 div 在 html tier 正常,span 不正常。 三个声明面同时不一致(#4631 的家族形态):TextSpanSchema(packages/types/src/layout.ts:36-46)声明 value? 与 children?,没有 body;registry meta 只声明 className;渲染器读 body。也就是说按类型规范拼写 children 渲染不出来,而渲染器唯一读得到的 body 不在类型里 —— JSON 作者面同样中招,只是仓内既有测试(packages/components/src/__tests__/basic-renderers.test.tsx:127)写的正好是 body,把这一面盖住了。
影响面 html tier 作者:span 标签的文字全部丢失(parser 的 validateTree 不检查子节点键,所以也没有 diagnostic)。 JSON 作者面:照 TextSpanSchema 写 children 的页面渲染出空 span。 examples/schema-catalog 内 "type": "span" 命中 0 ,仓内 JSON 元数据命中 0,所以今天没有 catalog 层面的可见回归。#4917 改的是 warn 分支;本条是渲染路径的键读取,是独立缺陷。而且它需要单独裁定「span 的规范子节点键是 children 还是 body」—— 按 Commandment #0.1 contract-first,这该在类型/规范侧定,不该由渲染器顺手加一个宽容的 || 糊掉(即便 div.tsx 今天就是那么写的,那本身可能是同一笔债)。
连带说明:#4917 的 provenance 测试因此没有 照抄 div 那条 textContent 对照断言(span 的文字压根不渲染,照抄会红且会诱使把本条一起改掉),改用同页 p 标签的文字 + span 元素本身存在来做「页面确实渲染了、节点确实落到了 span 渲染器」的对照;两条断言在本条修好之后依然成立。
建议裁定 规范键定为 children(与 TextSpanSchema、parser、div.tsx 一致),body 的旧读法处置按 A component type has THREE declared surfaces that disagree (TS schema type / registry meta inputs / renderer prop reads), and nothing reconciles or enforces them #4631 或反过来把 body 补进 TextSpanSchema 并让 parser 也发 body —— 但那会让 span 与其余所有容器分叉。 推荐 1。
关联:#4631 (三个声明面互不一致的系统性问题,pm:on-hold)、#4917 (发现场景)、#4797 (list 从不渲染 children 的同族)
发现于 #4917(span 废弃提示对齐 div)的实施过程中,不在该 PR 处理 —— 那一单的验收面只是废弃提示的触发条件与去重。
现象
kind:'html'页面里写一个 span 标签,编译出的节点渲染成一个空元素,作者写的文字消失,无提示、无诊断。实测(
packages/components测试环境,origin/main@e71c854ce)。源码:渲染结果:
hello html tier不见了;同一页里 p 标签的文字正常渲染,所以不是整页编译失败。原因
packages/sdui-parser/src/parse.ts:95产出的节点把子节点放在children:if (children && children.length) node.children = children;packages/components/src/renderers/basic/span.tsx只读body:renderChildren(schema.body)div.tsx读的是schema.children || schema.body,所以 div 在 html tier 正常,span 不正常。三个声明面同时不一致(#4631 的家族形态):
TextSpanSchema(packages/types/src/layout.ts:36-46)声明value?与children?,没有body;registry meta 只声明className;渲染器读body。也就是说按类型规范拼写children渲染不出来,而渲染器唯一读得到的body不在类型里 —— JSON 作者面同样中招,只是仓内既有测试(packages/components/src/__tests__/basic-renderers.test.tsx:127)写的正好是body,把这一面盖住了。影响面
validateTree不检查子节点键,所以也没有 diagnostic)。TextSpanSchema写children的页面渲染出空 span。examples/schema-catalog内"type": "span"命中 0,仓内 JSON 元数据命中 0,所以今天没有 catalog 层面的可见回归。为什么不在 #4917 里修
#4917 改的是 warn 分支;本条是渲染路径的键读取,是独立缺陷。而且它需要单独裁定「span 的规范子节点键是
children还是body」—— 按 Commandment #0.1 contract-first,这该在类型/规范侧定,不该由渲染器顺手加一个宽容的||糊掉(即便div.tsx今天就是那么写的,那本身可能是同一笔债)。连带说明:#4917 的 provenance 测试因此没有照抄 div 那条
textContent对照断言(span 的文字压根不渲染,照抄会红且会诱使把本条一起改掉),改用同页 p 标签的文字 + span 元素本身存在来做「页面确实渲染了、节点确实落到了 span 渲染器」的对照;两条断言在本条修好之后依然成立。建议裁定
children(与TextSpanSchema、parser、div.tsx一致),body的旧读法处置按 A component type has THREE declared surfaces that disagree (TS schema type / registry meta inputs / renderer prop reads), and nothing reconciles or enforces them #4631 / ADR-0049 enforce-or-remove 走;body补进TextSpanSchema并让 parser 也发body—— 但那会让 span 与其余所有容器分叉。推荐 1。
关联:#4631(三个声明面互不一致的系统性问题,pm:on-hold)、#4917(发现场景)、#4797(
list从不渲染children的同族)