如何在 JsRender 模板中正确向自定义 Helper 函数传递数组参数

jsrender 支持将数组作为参数传入自定义 helper 函数，但需注意模板作用域层级——在 `{{for}}` 迭代中直接引用父级数据（如 `plantlist`）会导致 `undefined`，必须通过上下文参数（如 `~plantlist=plantlist`）显式传递。

在 jsRender 中，数组完全可以作为参数传递给 helper 函数，问题不在于 JsRender 的限制，而在于模板中数据作用域（view context）的层级关系。当你在 {{for selectedplants}} 内部调用 ~plantNameFromCode(~plant, plantlist) 时，plantlist 并非当前子视图（child view）的数据属性，因此解析为 undefined —— 这是 JsRender 视图继承机制的正常行为。

✅ 正确做法：使用上下文参数（Contextual Parameters）

通过 ~paramName=expression 语法，在 {{for}} 标签中显式将父级数据绑定为当前迭代作用域下的上下文变量：

? 提示：#data 表示当前迭代项（即 selectedplants 数组中的每个字符串），无需额外声明 itemVar=”~plant”，更简洁安全。

? Helper 函数优化建议

原始 helper 存在潜在运行时错误（如 find() 返回 undefined 时访问 .PlantName 会抛错）。推荐增强健壮性：

function plantNameFromCode(code, plantArray) {   if (!plantArray || !Array.isArray(plantArray)) {     return code; // 或返回空字符串、占位符等   }    const matched = plantArray.find(p =>      p.PlantCode && p.PlantCode.toUpperCase() === code.toUpperCase()   );    return matched ? matched.PlantName : code; }  $.views.helpers({   plantNameFromCode: plantNameFromCode });

⚠️ 注意事项总结

• ❌ 错误写法：{{:~plantNameFromCode(~plant, plantlist)}} → plantlist 在子视图中未定义
• ✅ 正确写法：{{for selectedplants ~plantlist=plantlist}} + {{:~plantNameFromCode(#data, ~plantlist)}}
• ✅ 上下文参数支持任意表达式，如 ~plantlist=prop.nested.plantlist 或 ~plantlist=$root.plantlist（$root 指最外层数据）
• ✅ 可传递对象、数组、函数、原始值等任意 JS 值，无类型限制
• ?️ 务必对 find() 结果做存在性检查，避免 Cannot read Property ‘PlantName’ of undefined

通过合理利用 JsRender 的上下文参数机制，你不仅能安全传递数组，还能构建更灵活、可复用的模板逻辑，真正发挥 helper 函数的价值。