xctc-utils 1.6.36 → 1.6.38

package/README.md

@@ -25,6 +25,38 @@ all:boolean 为true时删除调用方法的所有缓存，否则只删除当前
 删除永久缓存： useUtils.removeLocalStorage(key,all)
 ```
 
+### iframe
+#### 父级页面方法调用
+
+```
+id string iframe子页面对应的id属性
+keys string 微信分享链接携带的state本地缓存值，非必传
+useUtils.iframe.initParentDataToIframe(id:string,keys?:string)
+```
+##### 父级页面获取到子页面触发的数据
+```
+cb回调函数，返回子页面传递的数据
+useUtils.iframe.updateIframeReceiveData( cb:any  )
+```
+##### 父页面发送数据到 子页面
+```
+id iframe子页面对应的id属性
+data 传递的数据，函数内对data进行序列化处理
+useUtils.iframe.sendParentMessage( id:string,data:any )
+```
+#### 子页面方法调用
+##### 子页面获取到 主页面 传递的数据
+```
+cb回调函数，返回父页面传递的数据
+useUtils.iframe.updateParentReceiveData(cb)
+```
+##### 子页面 发送数据到 主页面 
+```
+data 发送的数据
+url 父页面地址
+useUtils.iframe.sendIframeParentData(data:any,url:string)
+```
+
 ### 地址栏参数处理 
 #### 设置参数
 ```

package/dist/iframe/index.d.ts

@@ -1,7 +1,33 @@
 export declare const $iframe: (id: string) => any;
+/**
+ *
+ * @param id
+ * @param keys
+ * @returns
+ */
 export declare const initParentDataToIframe: (id: string, keys?: string) => void;
+/**
+ * 主应用 获取到 子应用Iframe传递的数据
+ * @param cb
+ */
 export declare const updateIframeReceiveData: (cb: any) => void;
+/**
+ * 子应用 获取到 主应用 传递的数据
+ * @param cb
+ */
 export declare const updateParentReceiveData: (cb: any) => void;
+/**
+ * 子应用frame 发送数据 到主应用
+ * @param sendData
+ * @param url
+ * @returns
+ */
 export declare const sendIframeParentData: (sendData: any, url: string) => void;
 export declare const updateWeiXinShareReady: () => void;
-export declare const sendParentMessage: (data: any, url: string) => void;
+/**
+ * 主应用 发送数据到 子应用Iframe
+ * @param id
+ * @param data
+ * @param url
+ */
+export declare const sendParentMessage: (id: string, data: any) => void;

package/dist/iframe/index.js

@@ -26,6 +26,13 @@ var $iframe = function (id) {
     return;
 };
 exports.$iframe = $iframe;
+// 主应用内初始化iframe子应用，并传递对应的参数到子应用
+/**
+ *
+ * @param id
+ * @param keys
+ * @returns
+ */
 var initParentDataToIframe = function (id, keys) {
     var _a;
     if (!id) {
@@ -48,6 +55,10 @@ var initParentDataToIframe = function (id, keys) {
     });
 };
 exports.initParentDataToIframe = initParentDataToIframe;
+/**
+ * 主应用 获取到 子应用Iframe传递的数据
+ * @param cb
+ */
 var updateIframeReceiveData = function (cb) {
     win.addEventListener('message', function (event) {
         var data = (event === null || event === void 0 ? void 0 : event.data) || {};
@@ -58,6 +69,10 @@ var updateIframeReceiveData = function (cb) {
     });
 };
 exports.updateIframeReceiveData = updateIframeReceiveData;
+/**
+ * 子应用 获取到 主应用 传递的数据
+ * @param cb
+ */
 var updateParentReceiveData = function (cb) {
     win.addEventListener('message', function (event) {
         var data = event.data;
@@ -68,6 +83,12 @@ var updateParentReceiveData = function (cb) {
     }, false);
 };
 exports.updateParentReceiveData = updateParentReceiveData;
+/**
+ * 子应用frame 发送数据 到主应用
+ * @param sendData
+ * @param url
+ * @returns
+ */
 var sendIframeParentData = function (sendData, url) {
     if (!url) {
         console.error("必须传入父页面的地址！");
@@ -91,12 +112,30 @@ var updateWeiXinShareReady = function () {
     });
 };
 exports.updateWeiXinShareReady = updateWeiXinShareReady;
-var sendParentMessage = function (data, url) {
-    if (!url) {
-        url = "*";
+/**
+ * 主应用 发送数据到 子应用Iframe
+ * @param id
+ * @param data
+ * @param url
+ */
+var sendParentMessage = function (id, data) {
+    if (!id) {
+        console.error("请传入iframe元素的id属性值");
     }
-    if ((0, is_1.isObject)(data)) {
-        win.parent.postMessage(JSON.stringify(data), url);
+    var iframe = (0, exports.$iframe)(id);
+    if (iframe) {
+        if ((0, is_1.isObject)(data)) {
+            iframe.addEventListener('load', function () {
+                // iFrame加载完成后的操作
+                iframe.contentWindow.postMessage(JSON.stringify(data), iframe.src);
+            });
+        }
+        else {
+            console.error("传递的数据仅支持对象格式！");
+        }
+    }
+    else {
+        console.error("未查询到iframe标签，请检查id属性值是否正确！");
     }
 };
 exports.sendParentMessage = sendParentMessage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xctc-utils",
-  "version": "1.6.36",
+  "version": "1.6.38",
   "description": "localStorage存储\r ```\r sessionStorage存储\r ```\r crypto-js加密、解密\r ```\r 微信授权登录、微信分享\r ```\r 设备环境获取\r ```\r 是否是微信浏览器\r ```\r 时间戳转时间，字符串转时间戳",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",