Adaptive Cards Templating在Composer的.lg文件中能否正常生效?
问题场景
希望在Adaptive Card中实现动态生成按钮的效果,初始写法的结构为:
"actions": [ { "$data": "${collection}", "type": "Action.Submit", "title": "${prop1}", "data": { "value": "${prop2}" } } ]
这段结构在Adaptive Cards官方独立设计器中可正常运行,但放到Bot Framework Composer的.lg文件中完全无法达成预期效果。
已完成的排查与验证
- 按照Adaptive Cards模板的规则,移除
${collection}两侧的引号,确保$data配置能被正确识别为数组绑定关系 - 梳理的预期逻辑:按照Adaptive Cards模板的设计规则,当元素的
$data字段绑定数组时,元素应自动按数组长度重复渲染,绑定的属性值自动取自数组内对应元素 - 实际异常表现:移除引号后,循环渲染逻辑依然没有生效,动态属性值完全无法正常展示
问题原因与解决方向
核心原因:Bot Framework Composer 没有内置启用 Adaptive Cards 自带的 Templating 运行时能力。你在官方设计器里看到的
$data循环、相对属性绑定效果,是设计器内置的实时模板引擎跑出来的,不会在 Composer 加载.lg文件的时候自动帮你解析这些标记。
- 放弃在
.lg文件中使用$data做数组循环绑定的写法,改用LG自身的语法完成值替换与数组映射 - 通过LG的数组展开语法,逐元素遍历目标数组,手动生成对应结构的Action.Submit按钮定义,将每个元素的
prop1、prop2值直接填充到按钮标题和提交数据字段中 - 如果需要复用Adaptive Cards原生模板能力,需要在Composer的自定义渲染层显式引入Adaptive Cards Templating扩展,在将卡片返回给客户端之前手动完成模板的编译、数据绑定流程,不能直接将带
$data标记的原始JSON放入.lg模板等待自动解析
内容的提问来源于stack exchange,提问作者Martín La Rosa
相关产品推荐
相关产品推荐

