控件参数要在下游被消费

更新于 2026-06-09

**控件能调、值也确实传下去了，不代表会生效 —— 参数必须在消费方被真正消费，否则表现为「调整了没反应」，而且不报错。排查动作是逐条对照「上游传了什么」与「下游消费了什么」，再决定改哪一层。**

一次实例

  • 现象：调「标题间距」控件没有反应，怀疑是表单/HTML 的问题。
  • 根因：渲染器确实收到了 --heading-gap，但当前模板（红调封面）的 CSS 里完全没有这个变量 —— 参数传进去了，没人消费。所以这不是表单问题，是当前模板 CSS/HTML 的问题，只需更新这一个模板。

为什么容易查错方向

「没反应」天然像是交互层的问题（控件没绑定、状态没更新）。但只要值已经到达渲染器，问题就已经转移到下游。判断依据是值有没有到，不是界面像不像坏了。

同一类静默失效还有：表单字段有、模板没写对应 slot → 用户填了也永远不显示（见 简历模板的三层渲染协议与迁移 的逐字段清单）。

相关