JsRender辅助函数能否接收数组参数？传参异常求助

结论 #

JsRender辅助函数完全支持接收数组参数，问题出在模板中数组参数的作用域访问方式上。

问题原因 #

在{{for selectedplants}}循环块内部，当前上下文是selectedplants数组中的单个元素（即单个植物编码字符串），而非根数据对象。直接写plantlist会在当前元素的属性中查找，自然找不到，所以传递给辅助函数的是undefined；而字符串字面量"TEST"是直接传递的，不受上下文影响。

解决方案 #

在模板中访问根数据里的plantlist数组时，需要使用**根路径标识~root**来指定作用域，或者通过父级路径../访问（当嵌套层级明确时）。同时修正辅助函数中未声明变量的问题。

1. 修正后的辅助函数

function plantNameFromCode(code, plantArray) {
  if (plantArray) {
    if (typeof plantArray === "string") {
      return plantArray;
    }
    // 处理数组可能找不到匹配项的情况，避免报错
    const matchedPlant = plantArray.find(p => p.PlantCode.toUpperCase() === code.toUpperCase());
    return matchedPlant ? matchedPlant.PlantName : code;
  }
  return code;
}

$.views.helpers({
  plantNameFromCode: plantNameFromCode
});

补充：增加了找不到匹配项时的容错处理，避免find()返回undefined后访问PlantName导致报错；同时用const声明变量，避免全局污染。

2. 修正后的模板代码

<script id="test-plantnamefromcode-template" type="text/x-jsrender">
  {{!-- selectedplants是植物编码数组 --}}
  {{for selectedplants itemVar="~plant"}}
    Plant Code: {{:~plant}}<BR>
    Plant Test: {{:~plantNameFromCode(~plant, "TEST")}}<BR>
    Plant Name: {{:~plantNameFromCode(~plant, ~root.plantlist)}}<BR>
  {{/for}}
</script>

关键修改：将plantlist改为~root.plantlist，明确指向根数据对象中的plantlist数组。

3. 验证渲染结果

使用原数据渲染后，会正确输出：

Plant Code: PlantCode2
Plant Test: TEST
Plant Name: Plant Name 2

Plant Code: PlantCode4
Plant Test: TEST
Plant Name: Plant Name 4

其他可选写法 #

如果模板嵌套层级简单，也可以用父级路径../plantlist访问：

Plant Name: {{:~plantNameFromCode(~plant, ../plantlist)}}<BR>

但~root的方式更可靠，尤其是在多层嵌套的模板中，不会因为层级变化而失效。

内容的提问来源于stack exchange，提问作者vseavello