Node-RED UI 模板中脚本内动态数据传递与管理

本文旨在解决Node-RED UI模板中，无法直接使用Mustache语法在`<script>`标签内动态注入JavaScript代码的问题。我们将阐述其根本原因，并提供两种安全有效的解决方案：一是通过`$scope.msg`直接访问传递的数据，二是通过Mustache结合`| <a style="color:#f60; text-decoration:underline;" title= "js"href="https://www.php.cn/zt/15802.html" target="_blank">json`过滤器将数据渲染为JavaScript变量。此外，文章还将探讨将UI模板封装为子流（Subflow）的实践，以实现模板的复用与集中管理。</script>

理解Node-RED UI模板中的Mustache渲染机制

在Node-RED的UI模板（ui_template）节点中，Mustache语法（例如 {{msg.payload}}）是在Node-RED服务器端进行渲染的。这意味着当Node-RED处理该节点时，它会用当前msg对象中的值替换所有的Mustache占位符，然后将生成的HTML内容（包括其中的<script>标签）发送到用户的浏览器。浏览器接收到这些内容后，才会解析并执行其中的JavaScript代码。

因此，尝试在<script>标签内部直接使用 {{msg.payload.ranges1}} 来注入一段JavaScript代码（如 high = 88; mid = 65; low = 60; size= "0.9em";）是行不通的。Mustache引擎会将其视为字符串进行替换，如果替换后的内容不符合JavaScript语法结构，或者期望它直接执行，就会导致错误或行为不符预期。Mustache主要用于数据绑定和内容替换，而非代码注入。

正确地将动态数据传递到JavaScript脚本

要将msg.payload中的动态数据传递到UI模板内的JavaScript脚本中，应遵循将数据作为变量传递，而非代码片段传递的原则。以下是两种推荐的方法：

方法一：通过 $scope.msg 直接访问数据

Node-RED UI模板的JavaScript上下文会自动将当前的msg对象绑定到 $scope.msg。因此，如果您的动态数据作为对象或特定属性存在于msg.payload中，可以直接在脚本中访问它。

示例： 假设您的 msg.payload.ranges1 是一个包含范围值的JavaScript对象，例如： msg.payload.ranges1 = { high: 88, mid: 65, low: 60, size: "0.9em" };

您可以在UI模板的脚本中这样访问：

<script>
    (function($scope) {
        // 监听Node-RED发送的msg变化
        $scope.$watch('msg', function() {
            if ($scope.msg && $scope.msg.topic === "temperature_avg") {
                // 直接从$scope.msg.payload中获取数据
                var ranges = $scope.msg.payload.ranges1;

                if (ranges) { // 确保ranges存在
                    var high = ranges.high;
                    var mid = ranges.mid;
                    var low = ranges.low;
                    var size = ranges.size;

                    // 在这里使用 high, mid, low, size 变量
                    console.log("Temperature Ranges:", { high, mid, low, size });
                    // 例如，更新UI元素
                    // document.getElementById('tempHigh').innerText = high;
                }
            }
        });
    })(scope);
</script>

这种方法是最直接和推荐的，因为它利用了Node-RED UI模板的内置数据绑定机制。

方法二：使用 Mustache 渲染为 JavaScript 变量（带 | json 过滤器）

如果需要将数据渲染到一个客户端JavaScript变量中，并且该数据是复杂的对象或数组，使用 | json Mustache过滤器可以确保数据被正确地序列化为JSON字符串，并在客户端JavaScript中解析。

Text Mark

处理文本内容的AI助手

81

查看详情

示例： 假设 msg.payload.ranges1 仍然是： msg.payload.ranges1 = { high: 88, mid: 65, low: 60, size: "0.9em" };

您可以在UI模板中这样设置：

<script>
    (function($scope) {
        // 在此处声明一个全局或局部变量，并使用Mustache渲染数据
        // {{msg.payload.ranges1 | json}} 会被替换成 {"high":88,"mid":65,"low":60,"size":"0.9em"}
        var dynamicRanges = {{msg.payload.ranges1 | json}};

        // 监听Node-RED发送的msg变化
        $scope.$watch('msg', function() {
            if ($scope.msg && $scope.msg.topic === "temperature_avg") {
                // 如果需要每次msg更新都获取最新值，可以再次从$scope.msg获取
                // 否则，dynamicRanges变量在页面加载时就已经初始化
                var currentRanges = $scope.msg.payload.ranges1 || dynamicRanges; // 优先使用最新msg，否则使用初始值

                if (currentRanges) {
                    var high = currentRanges.high;
                    var mid = currentRanges.mid;
                    var low = currentRanges.low;
                    var size = currentRanges.size;

                    console.log("Temperature Ranges (from rendered variable):", { high, mid, low, size });
                    // ... 在这里使用变量
                }
            }
        });
    })(scope);
</script>

注意事项：

• | json 过滤器至关重要，它将JavaScript对象转换为有效的JSON字符串，防止语法错误。
• dynamicRanges 变量在页面加载时初始化一次。如果msg频繁更新且您需要反映最新的数据，仍然建议在$scope.$watch('msg', ...)回调中访问$scope.msg.payload。

利用子流（Subflow）实现UI模板的复用与管理

虽然上述方法解决了动态数据传递的问题，但如果您的流程中包含多个相似的UI模板，并且希望集中管理它们的结构或默认值，将UI模板封装成子流（Subflow）是一个非常有效的架构实践。

子流的优势：

1. 复用性： 创建一个包含ui_template节点的子流后，您可以在多个不同的流程中多次实例化这个子流。
2. 集中管理： 对子流内部的任何修改（包括UI模板的HTML、CSS或JavaScript代码），都会自动应用到所有使用了该子流的实例中。这极大地简化了维护工作。
3. 参数化： 子流可以配置输入和输出端口，甚至可以定义环境变量，允许每个子流实例接收不同的配置或数据，从而增强灵活性。

如何操作：

1. 创建子流： 在Node-RED编辑器中，选择您希望封装的ui_template节点（及其可能相关的function或change节点），右键点击并选择 "创建子流"。
2. 配置子流：
   • 为子流命名并添加描述。
   • 在子流属性中，您可以定义输入端口（例如，接收msg.payload.ranges1）。
   • 可以在子流的ui_template节点内部继续使用上述方法一或方法二来处理传入的动态数据。
3. 使用子流： 创建子流后，它会出现在节点面板的 "子流" 分类下，您可以像使用普通节点一样将其拖放到任何流程中。每个子流实例都可以接收独立的msg，从而实现动态配置。

子流与数据传递的关系： 将UI模板放入子流并不能直接解决Mustache在脚本中注入代码的问题。它解决的是模板本身的复用和管理问题。每个子流实例仍然需要通过其输入端口接收msg，然后子流内部的ui_template节点再按照上述方法正确地从$scope.msg中提取动态数据。

总结

在Node-RED UI模板中，Mustache语法是用于服务器端渲染的，主要用于数据绑定和内容替换。直接在<script>标签内使用Mustache注入JavaScript代码片段是不可行的。正确的做法是将动态数据作为变量传递，并通过$scope.msg在客户端JavaScript中访问，或者使用| json过滤器将数据安全地渲染为JavaScript变量。此外，通过将UI模板封装为子流，可以有效提升模板的复用性和可维护性，实现对多个相似UI组件的集中管理。理解这些机制和实践，将有助于您构建更健壮、更易于维护的Node-RED UI应用。

以上就是Node-RED UI 模板中脚本内动态数据传递与管理的详细内容，更多请关注php中文网其它相关文章！