utils-uniapp 1.0.10 → 1.1.0

package/lib/aliPay/index.d.ts

@@ -0,0 +1,29 @@
+// alipaySubmit.d.ts
+
+/**
+ * 生成input表单项
+ * @param key 表单name
+ * @param data 表单数据源对象
+ * @param form 挂载form表单
+ */
+declare function createFormInputNode(key: string, data: Record<string, any>, form: HTMLFormElement): void;
+
+interface AlipaySubmitOptions {
+  /** pay | charge | string，pay模式过滤 sn、id，默认 pay */
+  type?: 'pay' | 'charge' | string;
+  /** 支付宝网关地址，默认 https://mapi.alipay.com/gateway.do */
+  alipayGateway?: string;
+}
+
+/**
+ * 【纯支付执行函数】只接收后端返回数据，不发起网络请求，仅H5环境
+ * @param data 后端返回的data对象
+ * @param options 配置项
+ */
+export declare function alipaySubmit(data: Record<string, any>, options?: AlipaySubmitOptions): void;
+
+declare const _default: {
+  alipaySubmit: typeof alipaySubmit;
+};
+
+export default _default;

package/lib/aliPay/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function m(e,o,a){let t=document.createElement("input");t.name=e,t.value=o[e],a.append(t)}function r(e){let o=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{};if(typeof document>"u"){console.warn("alipaySubmit：仅支持H5环境");return}if(!e||typeof e!="object"){console.error("alipaySubmit：入参data必须为对象");return}const{type:a="pay",alipayGateway:t="https://mapi.alipay.com/gateway.do"}=o,n=document.createElement("form");n.action=t;const u=a==="pay"?["sn","id"]:[];Object.keys(e).forEach(i=>{u.includes(i)||m(i,e,n)}),document.getElementsByTagName("body")[0].append(n),n.submit(),setTimeout(()=>{n.remove()},100)}exports.alipaySubmit=r;

package/lib/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./array/index.js"),n=require("./date/index.js"),t=require("./fs/index.js"),s=require("./getLocation/index.js"),r=require("./http/index.js"),e=require("./index-b81565a7.js"),i=require("./object/index.js"),o=require("./validate/index.js"),c=require("./index-9456b3d9.js"),d=require("./lodash");Object.assign(exports,d);exports.exchangeArrP=a.exchangeArrP;exports.filterTree=a.filterTree;exports.findTreeItem=a.findTreeItem;exports.flatWithKey=a.flatWithKey;exports.getTreePath=a.getTreePath;exports.groupBy=a.groupBy;exports.reverseForEach=a.reverseForEach;exports.treeItemSetParent=a.treeItemSetParent;exports.dateFormat=n.dateFormat;exports.getDate=n.getDate;exports.$fs=t.$fs;exports.chooseImg=t.chooseImg;exports.getArraybufferTempPath=t.getArraybufferTempPath;exports.getImgBase64Prefix=t.getImgBase64Prefix;exports.readFile=t.readFile;exports.saveImageToPhotosAlbum=t.saveImageToPhotosAlbum;exports.writeFile=t.writeFile;exports.getLocation=s.getLocation;exports.openLocation=s.openLocation;exports.CONTENT_TYPES=r.CONTENT_TYPES;exports.CancelToken=r.CancelToken;exports.createDownloadFile=r.createDownloadFile;exports.createRequest=r.createRequest;exports.createUploadFile=r.createUploadFile;exports.endLoading=r.endLoading;exports.promisifyRequest=r.promisifyRequest;exports.startLoading=r.startLoading;exports.compareVersion=e.compareVersion;exports.compose=e.compose;exports.composeAsync=e.composeAsync;exports.debounce=e.debounce;exports.debouncePromise=e.debouncePromise;exports.decodeURIParams=e.decodeURIParams;exports.encodeURIParams=e.encodeURIParams;exports.getCache=e.getCache;exports.getOnLoadParams=e.getOnLoadParams;exports.getPascalCase=e.getPascalCase;exports.getQueryParams=e.getQueryParams;exports.getQueryParamsFromHash=e.getQueryParamsFromHash;exports.getQueryParamsFromSearch=e.getQueryParamsFromSearch;exports.getRandom=e.getRandom;exports.getRandomStr=e.getRandomStr;exports.pipe=e.pipe;exports.pipeAsync=e.pipeAsync;exports.randomColor=e.randomColor;exports.removeCache=e.removeCache;exports.renewCache=e.renewCache;exports.setCache=e.setCache;exports.throttle=e.throttle;exports.toQueryString=e.toQueryString;exports.cloneDeepWithDescriptors=i.cloneDeepWithDescriptors;exports.getRawType=i.getRawType;exports.hasOwnProperty=i.hasOwnProperty;exports.isExternal=o.isExternal;exports.validDate=o.validDate;exports.validIDCard=o.validIDCard;exports.validPhone=o.validPhone;exports.validPostalCode=o.validPostalCode;exports.validURL=o.validURL;exports.wx=c.index;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./aliPay/index.js"),a=require("./array/index.js"),n=require("./date/index.js"),t=require("./fs/index.js"),s=require("./getLocation/index.js"),r=require("./http/index.js"),e=require("./index-b81565a7.js"),i=require("./object/index.js"),o=require("./validate/index.js"),d=require("./index-9456b3d9.js"),m=require("./lodash");Object.assign(exports,m);exports.alipaySubmit=c.alipaySubmit;exports.exchangeArrP=a.exchangeArrP;exports.filterTree=a.filterTree;exports.findTreeItem=a.findTreeItem;exports.flatWithKey=a.flatWithKey;exports.getTreePath=a.getTreePath;exports.groupBy=a.groupBy;exports.reverseForEach=a.reverseForEach;exports.treeItemSetParent=a.treeItemSetParent;exports.dateFormat=n.dateFormat;exports.getDate=n.getDate;exports.$fs=t.$fs;exports.chooseImg=t.chooseImg;exports.getArraybufferTempPath=t.getArraybufferTempPath;exports.getImgBase64Prefix=t.getImgBase64Prefix;exports.readFile=t.readFile;exports.saveImageToPhotosAlbum=t.saveImageToPhotosAlbum;exports.writeFile=t.writeFile;exports.getLocation=s.getLocation;exports.openLocation=s.openLocation;exports.CONTENT_TYPES=r.CONTENT_TYPES;exports.CancelToken=r.CancelToken;exports.createDownloadFile=r.createDownloadFile;exports.createRequest=r.createRequest;exports.createUploadFile=r.createUploadFile;exports.endLoading=r.endLoading;exports.promisifyRequest=r.promisifyRequest;exports.startLoading=r.startLoading;exports.compareVersion=e.compareVersion;exports.compose=e.compose;exports.composeAsync=e.composeAsync;exports.debounce=e.debounce;exports.debouncePromise=e.debouncePromise;exports.decodeURIParams=e.decodeURIParams;exports.encodeURIParams=e.encodeURIParams;exports.getCache=e.getCache;exports.getOnLoadParams=e.getOnLoadParams;exports.getPascalCase=e.getPascalCase;exports.getQueryParams=e.getQueryParams;exports.getQueryParamsFromHash=e.getQueryParamsFromHash;exports.getQueryParamsFromSearch=e.getQueryParamsFromSearch;exports.getRandom=e.getRandom;exports.getRandomStr=e.getRandomStr;exports.pipe=e.pipe;exports.pipeAsync=e.pipeAsync;exports.randomColor=e.randomColor;exports.removeCache=e.removeCache;exports.renewCache=e.renewCache;exports.setCache=e.setCache;exports.throttle=e.throttle;exports.toQueryString=e.toQueryString;exports.cloneDeepWithDescriptors=i.cloneDeepWithDescriptors;exports.getRawType=i.getRawType;exports.hasOwnProperty=i.hasOwnProperty;exports.isExternal=o.isExternal;exports.validDate=o.validDate;exports.validIDCard=o.validIDCard;exports.validPhone=o.validPhone;exports.validPostalCode=o.validPostalCode;exports.validURL=o.validURL;exports.wx=d.index;

package/lib/mixins/backGuard/index.d.ts

@@ -0,0 +1,134 @@
+import Vue from 'vue';
+
+/**
+ * 返回守卫弹窗配置项
+ * @property title 弹窗标题
+ * @property content 弹窗主体提示文案
+ * @property confirmText 确认按钮文字
+ * @property cancelText 取消按钮文字
+ */
+export interface BackGuardOptions {
+  title: string;
+  content: string;
+  confirmText: string;
+  cancelText: string;
+}
+
+/**
+ * Mixin注入的响应式状态
+ * @property backGuard 控制 page‑container 组件 show 显示/隐藏
+ * @property guardActive 业务内部标记：是否真正开启返回防护；业务禁止直接修改，统一调用 enableBackGuard / disableBackGuard
+ * @property backGuardOptions 返回确认弹窗配置对象；运行时通过 setBackGuardOptions 更新文案
+ */
+export interface BackGuardMixinState {
+  backGuard: boolean;
+  guardActive: boolean;
+  backGuardOptions: BackGuardOptions;
+}
+
+/**
+ * Mixin注入的实例方法
+ */
+export interface BackGuardMixinMethods {
+  /**
+   * page‑container @before‑leave 绑定事件回调
+   * 小程序点击左上角返回 / 物理返回键触发此事件
+   * - 未开启防护直接放行；开启防护弹出确认框
+   * - 确认离开执行 uni.navigateBack；取消则维持页面不跳转
+   */
+  onBeforeLeave(): Promise<void>;
+
+  /**
+   * 封装 uni.showModal，转为Promise调用
+   * @param options 弹窗配置，支持部分字段
+   * @returns Promise<boolean> true=确认离开，false=取消
+   */
+  handleBackGuardConfirm(options: Partial<BackGuardOptions>): Promise<boolean>;
+
+  /**
+   * 运行时更新挽留弹窗配置，浅合并对象，支持只传部分字段
+   * @example
+   * this.setBackGuardOptions({ content: '问诊会话未结束，确定离开吗？' })
+   * @param customOpts 自定义弹窗配置
+   */
+  setBackGuardOptions(customOpts: Partial<BackGuardOptions>): void;
+
+  /**
+   * 【业务API】开启返回挽留防护；表单编辑、会话进行中调用
+   * @example
+   * this.enableBackGuard()
+   */
+  enableBackGuard(): void;
+
+  /**
+   * 【业务API】关闭返回挽留防护；保存成功、会话结束调用
+   * @example
+   * this.disableBackGuard()
+   */
+  disableBackGuard(): void;
+}
+
+/**
+ * 返回守卫 Mixin（微信小程序 page‑container 实现返回拦截）
+ *
+ * ## 说明
+ * 1. mixin 内部自动注入 onShow / onUnload 生命周期，页面无需处理
+ * 2. 仅微信小程序有效；H5/App不支持该组件能力
+ *
+ * ## 模板使用（页面template必须引入该组件）
+ * ```html
+ * <page-container
+ *   :show="backGuard"
+ *   overlay="false"
+ *   duration="0"
+ *   @beforeleave="onBeforeLeave"
+ * />
+ * ```
+ *
+ * ## 业务代码调用示例（和截图保持一致）
+ * ```js
+ * // 会话开始，开启防护 + 修改弹窗提示文案
+ * this.enableBackGuard()
+ * this.setBackGuardOptions({
+ *   content: '问诊会话未结束，确定离开吗？'
+ * })
+ *
+ * // 会话结束/保存成功，关闭防护
+ * this.disableBackGuard()
+ * ```
+ */
+declare const backGuardMixin: Vue.ComponentOptions<Vue> & {
+  /** mixin内部data函数，返回响应式状态 */
+  data(): BackGuardMixinState;
+  /** mixin内部方法集合 */
+  methods: BackGuardMixinMethods;
+};
+
+export default backGuardMixin;
+
+/**
+ * 【可选全局Vue实例扩展】
+ * 开启后，所有页面 this.xxx 自动获得类型提示；
+ * ⚠️风险：全局污染，多个mixin会出现字段冲突；不需要请注释
+ */
+// declare module 'vue/types/vue' {
+//   interface Vue extends BackGuardMixinState, BackGuardMixinMethods {}
+// }
+
+/**
+ * 不开启全局扩展时，页面手动标注this类型示例
+ * ```ts
+ * import Vue from 'vue'
+ * import backGuardMixin, { BackGuardMixinState, BackGuardMixinMethods } from '@/common/mixins/backGuard.mixin'
+ *
+ * type PageThis = Vue & BackGuardMixinState & BackGuardMixinMethods;
+ * export default {
+ *   mixins: [backGuardMixin],
+ *   methods: {
+ *     demo(this: PageThis) {
+ *       this.enableBackGuard()
+ *     }
+ *   }
+ * }
+ * ```
+ */

package/lib/mixins/backGuard/index.js

@@ -0,0 +1,65 @@
+export default {
+  data() {
+    return {
+      backGuard: false,
+      // 内部源状态：是否需要开启返回防护，业务不直接修改
+      guardActive: false,
+      backGuardOptions: {
+        title: '提示',
+        content: '内容尚未保存，确定放弃编辑？',
+        confirmText: '确定离开',
+        cancelText: '取消'
+      }
+    };
+  },
+  onShow() {
+    this.backGuard = this.guardActive;
+  },
+  onUnload() {
+    this.backGuard = false;
+  },
+  methods: {
+    async onBeforeLeave() {
+      // 容器由代码关闭（disableBackGuard 置 show=false）时直接放行，不弹确认框
+      if (!this.guardActive) return;
+      this.backGuard = false;
+      const shouldLeave = await this.handleBackGuardConfirm(this.backGuardOptions);
+      if (shouldLeave === true) {
+        uni.navigateBack();
+      } else {
+        this.$nextTick(() => {
+          this.backGuard = this.guardActive;
+        });
+      }
+    },
+
+    async handleBackGuardConfirm(options) {
+      return new Promise(resolve => {
+        uni.showModal({
+          title: options.title,
+          content: options.content,
+          confirmText: options.confirmText,
+          cancelText: options.cancelText,
+          success: res => resolve(res.confirm)
+        });
+      });
+    },
+
+    setBackGuardOptions(customOpts) {
+      this.backGuardOptions = {
+        ...this.backGuardOptions,
+        ...customOpts
+      };
+    },
+
+    // ========== 对外API，业务只调用这两个 ==========
+    enableBackGuard() {
+      this.guardActive = true;
+      this.backGuard = true;
+    },
+    disableBackGuard() {
+      this.guardActive = false;
+      this.backGuard = false;
+    }
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utils-uniapp",
-  "version": "1.0.10",
+  "version": "1.1.0",
   "description": "aubyn's utils for uniapp",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",