@luck-design-biz/luckda 1.0.1 → 1.0.2-10

package/lib/lowcode/engine/meta/table.props.json

@@ -168,7 +168,7 @@
             "default": {
               "todoList": []
             },
-            "defaultCode": "function onBatchOperationsClick(key, selectedRows) {\n\n}",
+            "defaultCode": "function onBatchOperationsClick(key, selectedRows, cb) {\n\n}",
             "suppressDisplay": true,
             "suppressMax": true,
             "suppressMore": true,
@@ -182,7 +182,6 @@
             "name": "默认选中行",
             "type": "_JSEditor",
             "defaultCode": "function getRowDefaultSelected(data, node) { \n return false; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -193,7 +192,6 @@
             "name": "行是否可选",
             "type": "_JSEditor",
             "defaultCode": "function getRowSelectable(data, node) { \n return true; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -322,7 +320,6 @@
             "name": "格式化数据",
             "type": "_JSEditor",
             "defaultCode": "function formatDataSource(list, detail) { \n return []; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -333,7 +330,6 @@
             "name": "构建树层级",
             "type": "_JSEditor",
             "defaultCode": "function getDataPath(data) { \n return []; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -345,7 +341,6 @@
             "desc": "自定义某些表格列",
             "type": "_JSEditor",
             "defaultCode": "function columnsRewrite(columns) { \n return columns; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -357,7 +352,6 @@
             "desc": "完全自定义所有表格列，优先级大于columnsRewrite",
             "type": "_JSEditor",
             "defaultCode": "function columnsReset(columns) { \n return columns; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -368,7 +362,6 @@
             "name": "model参数",
             "type": "_JSEditor",
             "defaultCode": "function getModelParams() { \n return {}; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true

package/lib/lowcode/engine/meta/tabs.props.default.json

@@ -12,7 +12,7 @@
       "id": "tab_lvwdncx1",
       "name": "标签项",
       "active": true,
-      "destory": false,
+      "destory": true,
       "serial": null,
       "serialEffect": "hidden"
     }

package/lib/lowcode/engine/meta/tabs.props.json

@@ -23,7 +23,7 @@
           "id": "tab_lvwdncx1",
           "name": "标签项",
           "active": true,
-          "destory": false,
+          "destory": true,
           "serial": null,
           "serialEffect": "hidden"
         }
@@ -84,7 +84,7 @@
       "name": "tab bar 上额外的元素",
       "type": "_JSEditor",
       "defaultCode": "function Component() { \n return <div>extra</div>; \n}",
-      "mustConfirm": true,
+      "isjsx": true,
       "wrapper": "collapse",
       "wrapperProps": {
         "suppressIcon": true

package/lib/lowcode/engine/meta/tree.props.json

@@ -9,7 +9,7 @@
   "props": [
     {
       "key": "id",
-      "desc": "唯一标识",
+      "name": "唯一标识",
       "type": "string",
       "disabled": true
     },
@@ -194,7 +194,7 @@
       "props": [
         {
           "key": "cancelSelect",
-          "name": "取消选中",
+          "name": "允许取消选中",
           "desc": "是否可以取消选中",
           "type": "switch",
           "default": true
@@ -205,7 +205,6 @@
           "desc": "返回默认选中的数据主键",
           "type": "_JSEditor",
           "defaultCode": "function defaultSelect(treeData) { \n return null; \n}",
-          "mustConfirm": true,
           "wrapper": "collapse",
           "wrapperProps": {
             "suppressIcon": true
@@ -268,7 +267,6 @@
             "name": "节点是否有复选框",
             "type": "_JSEditor",
             "defaultCode": "function treeNodeCheckable(item) { \n return true; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -279,7 +277,6 @@
             "name": "节点复选框是否禁用",
             "type": "_JSEditor",
             "defaultCode": "function treeNodeDisableCheckbox(item) { \n return false; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -290,7 +287,6 @@
             "name": "节点是否禁用",
             "type": "_JSEditor",
             "defaultCode": "function treeNodeDisable(item) { \n return false; \n}",
-            "mustConfirm": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true
@@ -301,7 +297,7 @@
             "name": "节点定制渲染",
             "type": "_JSEditor",
             "defaultCode": "function onTreeNodeRender(title, item) { \n return title; \n}",
-            "mustConfirm": true,
+            "isjsx": true,
             "wrapper": "collapse",
             "wrapperProps": {
               "suppressIcon": true

package/lib/lowcode/engine/provider/ContextProvider/index.js

@@ -75,11 +75,15 @@ var _default = exports.default = function _default(_ref) {
     _componentList.current.push([id, component]);
   });
   var _unregister = (0, _ahooks.useMemoizedFn)(function (id) {
-    _componentList.current = _componentList.current.filter(function (_ref2) {
+    var index = _componentList.current.findIndex(function (_ref2) {
       var _ref3 = (0, _slicedToArray2.default)(_ref2, 1),
         _id = _ref3[0];
-      return _id !== id;
+      return _id === id;
     });
+    if (index !== -1) {
+      _componentList.current.splice(index, 1);
+    }
+    ;
   });
   var _initRemoteApiMap = (0, _ahooks.useMemoizedFn)(function (_apiMap) {
     _remoteApiMap.current = _apiMap;
@@ -120,76 +124,76 @@ var _default = exports.default = function _default(_ref) {
     _register: _register,
     _unregister: _unregister,
     _initRemoteApiMap: _initRemoteApiMap,
-    /**
-     * @property {boolean} loading - loading状态
+    /**
+     * @property {boolean} loading - loading状态
      */
     loading: loading,
-    /**
-     * @property {object} topics - 内置的事件话题
+    /**
+     * @property {object} topics - 内置的事件话题
      */
     topics: topics,
-    /**
-     * @property {object} topics - service api前缀
+    /**
+     * @property {object} topics - service api前缀
      */
     API_PREFIX: _ApiConfig.default,
-    /**
-     * @property {string} PRIMARY_KEY - 主键key
+    /**
+     * @property {string} PRIMARY_KEY - 主键key
      */
     PRIMARY_KEY: window.appConfig.constraintKeys.PRIMARY,
-    /**
-     * @property {string} PARENT_KEY - 树组件主键key
+    /**
+     * @property {string} PARENT_KEY - 树组件主键key
      */
     PARENT_KEY: window.appConfig.constraintKeys.PARENT,
-    /**
-     * @method - 根据组件ID获取实例
-     * @param {string} compId - 组件ID
-     * @return {object} target - 组件实例
+    /**
+     * @method - 根据组件ID获取实例
+     * @param {string} compId - 组件ID
+     * @return {object} target - 组件实例
      */
     $: getElementById,
-    /**
-     * @method - 根据组件ID获取父组件实例
-     * @param {string} compId - 组件ID
-     * @return {object} target - 父组件实例
+    /**
+     * @method - 根据组件ID获取父组件实例
+     * @param {string} compId - 组件ID
+     * @return {object} target - 父组件实例
      */
     $$: getParentElementById,
-    /**
-     * @method - 执行行为池
-     * @param {object} actionPool - 行为池
-     * @param {object} args - 参数
+    /**
+     * @method - 执行行为池
+     * @param {object} actionPool - 行为池
+     * @param {object} args - 参数
      */
     doAction: function doAction(actionPool, args) {
       return todo(this, actionPool, args);
     },
-    /**
-     * @method - 是否有权限
-     * @return {string} wanted - 期望的资源串
+    /**
+     * @method - 是否有权限
+     * @return {string} wanted - 期望的资源串
      */
     want: want,
-    /**
-     * @method - 获取执行行为请求的接口URL
-     * @return {string} BEHAVIOR_URL - 执行行为请求的接口URL
+    /**
+     * @method - 获取执行行为请求的接口URL
+     * @return {string} BEHAVIOR_URL - 执行行为请求的接口URL
      */
     getBehaviorUrl: _apiUrl.getBehaviorUrl,
-    /**
-     * @typedef {Object} Utils
-     * @property {function(type, props): void} dialog - 弹出对话框
-     * @property {function({ moduleCode, datasetCode, behaviorKey }, params, data): Promise} callBehavior - 执行行为
-     * @property {function(type, value, formatOrSeparator): string} formatter - 常用的 formatter 函数用于进行事件、金额、手机号等 format
-     * @property {function(when, type): string} getDateTimeRange - 获取当前或指定日期的开始结束区间时间戳
+    /**
+     * @typedef {Object} Utils
+     * @property {function(type, props): void} dialog - 弹出对话框
+     * @property {function({ moduleCode, datasetCode, behaviorKey }, params, data): Promise} callBehavior - 执行行为
+     * @property {function(type, value, formatOrSeparator): string} formatter - 常用的 formatter 函数用于进行事件、金额、手机号等 format
+     * @property {function(when, type): string} getDateTimeRange - 获取当前或指定日期的开始结束区间时间戳
      */
-    /**
-     * @property {Utils} 工具类
+    /**
+     * @property {Utils} 工具类
      */
     utils: utils,
-    /**
-     * @typedef {Object} Router
-     * @property {function(path, params): void} push - 跳转
-     * @property {function(path, state): void} replace - 替换
-     * @property {function{}: object} getQuery - 获取URL参数
-     * @property {function(params): string} stringifyQuery - 序列化 URL 参数
+    /**
+     * @typedef {Object} Router
+     * @property {function(path, params): void} push - 跳转
+     * @property {function(path, state): void} replace - 替换
+     * @property {function{}: object} getQuery - 获取URL参数
+     * @property {function(params): string} stringifyQuery - 序列化 URL 参数
      */
-    /**
-     * @property {Router} router - 路由
+    /**
+     * @property {Router} router - 路由
      */
     router: router
   }, eventBus), {

package/lib/lowcode/engine/provider/ContextProvider/router.js

@@ -1,5 +1,6 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -13,8 +14,14 @@ Object.defineProperty(exports, "history", {
 exports.push = push;
 exports.replace = replace;
 exports.stringifyQuery = stringifyQuery;
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _umi = require("umi");
 var _lodash = require("lodash");
+var _qs = require("qs");
+var _excluded = ["title", "subTitle"],
+  _excluded2 = ["title", "subTitle"];
 function push(path, params) {
   var type = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'push';
   var blank = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
@@ -27,7 +34,21 @@ function push(path, params) {
       method: 'replace'
     });
   } else if (type === 'layer') {
-    window.openUrl("layer:".concat(path), params);
+    var _path$split = path.split('?'),
+      _path$split2 = (0, _slicedToArray2.default)(_path$split, 2),
+      _path = _path$split2[0],
+      argsStr = _path$split2[1];
+    var title = params.title,
+      subTitle = params.subTitle,
+      _params = (0, _objectWithoutProperties2.default)(params, _excluded);
+    var _parse = (0, _qs.parse)(argsStr),
+      _title = _parse.title,
+      _subTitle = _parse.subTitle,
+      args = (0, _objectWithoutProperties2.default)(_parse, _excluded2);
+    window.openUrl("layer:".concat(_path, "?").concat((0, _qs.stringify)((0, _objectSpread2.default)({
+      title: title || _title,
+      subTitle: subTitle || _subTitle
+    }, args))), _params);
   } else if (type === 'iframe') {
     window.openUrl("iframe:".concat(path));
   } else if (type === 'sso') {

package/lib/lowcode/engine/provider/ContextProvider/usePageDataStore.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useTemporalStore = exports.useTask = exports.useGet = exports.setNeedPrompt = exports.resetPageData = exports.modifyNode = exports.getSelfAndParent = exports.getNeedPrompt = exports.getModuleData = exports.getLevelNodes = exports.deleteNode = exports.default = exports.clearChildren = exports.addNode = void 0;
+exports.useTemporalStore = exports.useTask = exports.useGet = exports.setNeedPrompt = exports.resetPageData = exports.moveNode = exports.modifyNode = exports.getSelfAndParent = exports.getNeedPrompt = exports.getModuleData = exports.getLevelNodes = exports.deleteNode = exports.default = exports.clearChildren = exports.addNode = void 0;
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _react = require("react");
@@ -264,13 +264,93 @@ var modifyNode = exports.modifyNode = function modifyNode(id, data) {
     });
   });
 };
+
+/**
+ * 移动页面中的一个节点到另一个位置。
+ * 
+ * @param {string} sid - 源节点的ID。
+ * @param {string} tid - 目标节点的ID。
+ * @param {string} action - 移动类型，可以是 'inside', 'left', 'right' 中的一个。
+ * @param {string} newid - 新节点的ID，仅在创建新节点时使用。
+ * @param {Object} json - 新节点的初始属性，仅在创建新节点时使用。
+ * 
+ * @description
+ * 此函数会更新页面数据状态，根据提供的动作类型（`action`），将源节点（`sourceNode`）移动到目标节点（`targetNode`）的相应位置。
+ * - 'inside': 将源节点作为目标节点的子节点。
+ * - 'left': 将源节点放在目标节点的左边（同一父节点下）。
+ * - 'right': 将源节点放在目标节点的右边（同一父节点下）。
+ * 如果 `sid` 是空但提供了 `newid`，则函数会创建一个新的节点。
+ * 
+ */
+var moveNode = exports.moveNode = function moveNode(sid, tid, action, newid, json) {
+  usePageDataStore.setState(function (state) {
+    var sourceNode;
+    var sourceParent;
+    if (sid) {
+      var sourceData = findNode(state.pageData, sid) || {};
+      sourceNode = sourceData === null || sourceData === void 0 ? void 0 : sourceData.target;
+      sourceParent = sourceData === null || sourceData === void 0 ? void 0 : sourceData.parent;
+    } else if (newid) {
+      sid = newid;
+      sourceNode = {
+        props: (0, _objectSpread2.default)((0, _objectSpread2.default)({}, json), {}, {
+          id: newid
+        })
+      };
+    }
+    var _ref4 = findNode(state.pageData, tid) || {},
+      targetNode = _ref4.target,
+      targetParent = _ref4.parent;
+    if (!sourceNode || !targetNode) {
+      console.error('Source or target node does not exist.');
+      return;
+    }
+    if (sourceParent) {
+      sourceParent.children.splice(sourceParent.children.indexOf(sid), 1);
+      if (sourceParent.children.length === 0) {
+        delete sourceParent['children'];
+      }
+      delete sourceParent[sid];
+    }
+    switch (action) {
+      case 'inside':
+        if (!targetNode.hasOwnProperty('children')) {
+          targetNode.children = [];
+        }
+        targetNode.children.push(sid);
+        sourceNode.props.parentId = tid;
+        targetNode[sid] = sourceNode;
+        break;
+      case 'left':
+      case 'right':
+        if (!targetParent) {
+          console.error('Target node must have a parent for left or right operations.');
+          return;
+        }
+        var idx = targetParent.children.indexOf(tid);
+        if (idx === -1) {
+          console.error("Target node is not found in its parent's children list.");
+          return;
+        }
+        if (action === 'right') {
+          idx++;
+        }
+        targetParent.children.splice(idx, 0, sid);
+        sourceNode.props.parentId = targetParent.props.id;
+        targetParent[sid] = sourceNode;
+        break;
+      default:
+        break;
+    }
+  });
+};
 var clearChildren = exports.clearChildren = function clearChildren(id) {
   usePageDataStore.setState(function (state) {
     if (id === _constants.LC_BUILDIN_UNIT_KEY.PAGE_ROOT) {
       return;
     }
-    var _ref4 = findNode(state.pageData, id) || {},
-      target = _ref4.target;
+    var _ref5 = findNode(state.pageData, id) || {},
+      target = _ref5.target;
     if (!target) return;
     (0, _lodash.forEach)(target.children, function (c) {
       delete target[c];

package/lib/lowcode/engine/tools/dataProcess.js

@@ -20,10 +20,10 @@ var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var LZString = _interopRequireWildcard(require("lz-string"));
 var _constants = require("../../constants");
-/**
- * 数据压缩
- * @param {JSON} data
- * @returns 加密后的字符串
+/**
+ * 数据压缩
+ * @param {JSON} data
+ * @returns 加密后的字符串
  */
 function compress(data) {
   // 将对象转换为JSON字符串
@@ -32,10 +32,10 @@ function compress(data) {
   return LZString.compressToBase64(jsonString);
 }
 
-/**
- * 数据解压
- * @param {string} compressedData
- * @returns {json}
+/**
+ * 数据解压
+ * @param {string} compressedData
+ * @returns {json}
  */
 function decompress(compressedData) {
   // 使用LZ-String解压数据
@@ -44,13 +44,13 @@ function decompress(compressedData) {
   return JSON.parse(jsonString);
 }
 
-/**
- * 查找指定ID的节点及其父节点。
- *
- * @param {string} id - 要查找的节点ID。
- * @param {Object} current - 当前遍历的JSON对象。
- * @param {Object|null} parent - 当前节点的父节点。
- * @returns {{node: Object|null, parent: Object|null}} 查找结果，包含节点和其父节点。
+/**
+ * 查找指定ID的节点及其父节点。
+ *
+ * @param {string} id - 要查找的节点ID。
+ * @param {Object} current - 当前遍历的JSON对象。
+ * @param {Object|null} parent - 当前节点的父节点。
+ * @returns {{node: Object|null, parent: Object|null}} 查找结果，包含节点和其父节点。
  */
 function findNodeAndParent(id, current) {
   var parent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
@@ -84,13 +84,13 @@ function findNodeAndParent(id, current) {
   };
 }
 
-/**
- * 对指定的JSON结构进行节点的添加、修改或删除操作。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string|null} path - 要操作的节点路径，使用'/'分隔。
- * @param {string} id - 操作节点的唯一标识符。
- * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
+/**
+ * 对指定的JSON结构进行节点的添加、修改或删除操作。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string|null} path - 要操作的节点路径，使用'/'分隔。
+ * @param {string} id - 操作节点的唯一标识符。
+ * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
  */
 function process(json, path, id, data) {
   if (!json) {
@@ -156,25 +156,25 @@ function process(json, path, id, data) {
   }
 }
 
-/**
- * 对指定的JSON结构进行节点的添加操作。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string} parentId - 父节点的唯一标识符。
- * @param {string} id - 操作节点的唯一标识符。
- * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
+/**
+ * 对指定的JSON结构进行节点的添加操作。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string} parentId - 父节点的唯一标识符。
+ * @param {string} id - 操作节点的唯一标识符。
+ * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
  */
 function add(json, parentId, id, data) {
   process(json, getPathById(json, parentId), id, data);
 }
 
-/**
- * 移动指定的节点到另一个节点的指定位置。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string} sid - 被移动的节点id
- * @param {string} tid - 目标节点id
- * @param {string} action - 'left': 往节点前面插入，'right'：往节点后面插，'inside'：往节点子节点插
+/**
+ * 移动指定的节点到另一个节点的指定位置。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string} sid - 被移动的节点id
+ * @param {string} tid - 目标节点id
+ * @param {string} action - 'left': 往节点前面插入，'right'：往节点后面插，'inside'：往节点子节点插
  */
 function move(json, sid, tid, action) {
   // 验证节点存在性
@@ -230,34 +230,34 @@ function move(json, sid, tid, action) {
   }
 }
 
-/**
- * 对指定的JSON结构进行节点的修改操作。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string} id - 操作节点的唯一标识符。
- * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
+/**
+ * 对指定的JSON结构进行节点的修改操作。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string} id - 操作节点的唯一标识符。
+ * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
  */
 function modifyById(json, id, data) {
   process(json, null, id, data);
 }
 
-/**
- * 删除指定id的节点。
- *
- * @param {Object} json - JSON对象。
- * @param {string} id - 要删除的节点ID。
+/**
+ * 删除指定id的节点。
+ *
+ * @param {Object} json - JSON对象。
+ * @param {string} id - 要删除的节点ID。
  */
 function deleteById(json, id) {
   process(json, null, id);
 }
 
-/**
- * 根据ID在给定的JSON结构中查找节点的路径。
- *
- * @param {Object} json - 要搜索的JSON对象。
- * @param {string} id - 要查找的节点ID。
- * @param {string} currentPath - 当前递归到的路径，用于构建返回的路径字符串。
- * @returns {string|null} 如果找到节点，返回节点的路径；否则返回null。
+/**
+ * 根据ID在给定的JSON结构中查找节点的路径。
+ *
+ * @param {Object} json - 要搜索的JSON对象。
+ * @param {string} id - 要查找的节点ID。
+ * @param {string} currentPath - 当前递归到的路径，用于构建返回的路径字符串。
+ * @returns {string|null} 如果找到节点，返回节点的路径；否则返回null。
  */
 function getPathById(json, id) {
   var currentPath = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
@@ -277,28 +277,28 @@ function getPathById(json, id) {
   return null;
 }
 
-/**
- * 在给定的JSON结构中搜索具有特定id的节点，并返回包含该节点及其所有父节点的props属性的路径数组。
- *
- * @param {Object} data - 待搜索的JSON对象，它代表了一个复杂的树状结构，每个节点都可能有props和children属性。
- * @param {string} targetId - 需要找到的目标节点的id。
- * @returns {Array<Object>} 一个包含目标节点及其所有父节点的props属性的数组。如果未找到目标节点，则返回空数组。
- *
- * @example
- * const data = {
- *   props: {
- *     id: 'page_root',
- *     type: 'Page',
- *     name: '页面',
- *     hasHeder: true,
- *     hasFooter: true,
- *   },
- *   // ...其他节点
- * };
- *
- * const path = getPathNodesById(data, 'form_jknbjkun');
- * console.log(path);
- * // 输出目标节点及其所有父节点的props属性的数组
+/**
+ * 在给定的JSON结构中搜索具有特定id的节点，并返回包含该节点及其所有父节点的props属性的路径数组。
+ *
+ * @param {Object} data - 待搜索的JSON对象，它代表了一个复杂的树状结构，每个节点都可能有props和children属性。
+ * @param {string} targetId - 需要找到的目标节点的id。
+ * @returns {Array<Object>} 一个包含目标节点及其所有父节点的props属性的数组。如果未找到目标节点，则返回空数组。
+ *
+ * @example
+ * const data = {
+ *   props: {
+ *     id: 'page_root',
+ *     type: 'Page',
+ *     name: '页面',
+ *     hasHeder: true,
+ *     hasFooter: true,
+ *   },
+ *   // ...其他节点
+ * };
+ *
+ * const path = getPathNodesById(data, 'form_jknbjkun');
+ * console.log(path);
+ * // 输出目标节点及其所有父节点的props属性的数组
  */
 function getPathNodesById(data, targetId) {
   // 初始化结果数组