uview-pro 0.0.1

package/libs/function/test.ts

@@ -0,0 +1,229 @@
+/**
+ * 验证电子邮箱格式
+ */
+function email(value: string): boolean {
+    return /[\w!#$%&'*+/=?^_`{|}~-]+(?:\.[\w!#$%&'*+/=?^_`{|}~-]+)*@(?:[\w](?:[\w-]*[\w])?\.)+[\w](?:[\w-]*[\w])?/.test(value);
+}
+
+/**
+ * 验证手机格式
+ */
+function mobile(value: string): boolean {
+    return /^1[3-9]\d{9}$/.test(value);
+}
+
+/**
+ * 验证URL格式
+ */
+function url(value: string): boolean {
+    return /http(s)?:\/\/([\w-]+\.)+[\w-]+(\/[\w-.\/?%&=]*)?/.test(value);
+}
+
+/**
+ * 验证日期格式
+ */
+function date(value: string): boolean {
+    return !/Invalid|NaN/.test(new Date(value).toString());
+}
+
+/**
+ * 验证ISO类型的日期格式
+ */
+function dateISO(value: string): boolean {
+    return /^\d{4}[\/\-](0?[1-9]|1[012])[\/\-](0?[1-9]|[12][0-9]|3[01])$/.test(value);
+}
+
+/**
+ * 验证十进制数字
+ */
+function number(value: string): boolean {
+    return /^[\+-]?(\d+\.?\d*|\.\d+|\d\.\d+e\+\d+)$/.test(value);
+}
+
+/**
+ * 验证整数
+ */
+function digits(value: string): boolean {
+    return /^\d+$/.test(value);
+}
+
+/**
+ * 验证身份证号码
+ */
+function idCard(value: string): boolean {
+    return /^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}([0-9]|X)$/.test(value);
+}
+
+/**
+ * 是否车牌号
+ */
+function carNo(value: string): boolean {
+    // 新能源车牌
+    const xreg = /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}(([0-9]{5}[DF]$)|([DF][A-HJ-NP-Z0-9][0-9]{4}$))/;
+    // 旧车牌
+    const creg = /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}[A-HJ-NP-Z0-9]{4}[A-HJ-NP-Z0-9挂学警港澳]{1}$/;
+    if (value.length === 7) {
+        return creg.test(value);
+    } else if (value.length === 8) {
+        return xreg.test(value);
+    } else {
+        return false;
+    }
+}
+
+/**
+ * 金额,只允许2位小数
+ */
+function amount(value: string): boolean {
+    //金额，只允许保留两位小数
+    return /^[1-9]\d*(,\d{3})*(\.\d{1,2})?$|^0\.\d{1,2}$/.test(value);
+}
+
+/**
+ * 中文
+ */
+function chinese(value: string): boolean {
+    let reg = /^[\u4e00-\u9fa5]+$/gi;
+    return reg.test(value);
+}
+
+/**
+ * 只能输入字母
+ */
+function letter(value: string): boolean {
+    return /^[a-zA-Z]*$/.test(value);
+}
+
+/**
+ * 只能是字母或者数字
+ */
+function enOrNum(value: string): boolean {
+    //英文或者数字
+    let reg = /^[0-9a-zA-Z]*$/g;
+    return reg.test(value);
+}
+
+/**
+ * 验证是否包含某个值
+ */
+function contains(value: string, param: string): boolean {
+    return value.indexOf(param) >= 0;
+}
+
+/**
+ * 验证一个值范围[min, max]
+ */
+function range(value: number, param: [number, number]): boolean {
+    return value >= param[0] && value <= param[1];
+}
+
+/**
+ * 验证一个长度范围[min, max]
+ */
+function rangeLength(value: string, param: [number, number]): boolean {
+    return value.length >= param[0] && value.length <= param[1];
+}
+
+/**
+ * 是否固定电话
+ */
+function landline(value: string): boolean {
+    let reg = /^\d{3,4}-\d{7,8}(-\d{3,4})?$/;
+    return reg.test(value);
+}
+
+/**
+ * 判断是否为空
+ */
+function empty(value: any): boolean {
+    switch (typeof value) {
+        case 'undefined':
+            return true;
+        case 'string':
+            if (value.replace(/(^[ \t\n\r]*)|([ \t\n\r]*$)/g, '').length == 0) return true;
+            break;
+        case 'boolean':
+            if (!value) return true;
+            break;
+        case 'number':
+            if (0 === value || isNaN(value)) return true;
+            break;
+        case 'object':
+            if (null === value || value.length === 0) return true;
+            for (var i in value) {
+                return false;
+            }
+            return true;
+    }
+    return false;
+}
+
+/**
+ * 是否json字符串
+ */
+function jsonString(value: string): boolean {
+    if (typeof value == 'string') {
+        try {
+            var obj = JSON.parse(value);
+            if (typeof obj == 'object' && obj) {
+                return true;
+            } else {
+                return false;
+            }
+        } catch (e) {
+            return false;
+        }
+    }
+    return false;
+}
+
+/**
+ * 是否数组
+ */
+function array(value: any): boolean {
+    if (typeof Array.isArray === 'function') {
+        return Array.isArray(value);
+    } else {
+        return Object.prototype.toString.call(value) === '[object Array]';
+    }
+}
+
+/**
+ * 是否对象
+ */
+function object(value: any): boolean {
+    return Object.prototype.toString.call(value) === '[object Object]';
+}
+
+/**
+ * 是否短信验证码
+ */
+function code(value: string, len: number = 6): boolean {
+    return new RegExp(`^\\d{${len}}$`).test(value);
+}
+
+export default {
+    email,
+    mobile,
+    url,
+    date,
+    dateISO,
+    number,
+    digits,
+    idCard,
+    carNo,
+    amount,
+    chinese,
+    letter,
+    enOrNum,
+    contains,
+    range,
+    rangeLength,
+    empty,
+    isEmpty: empty,
+    jsonString,
+    landline,
+    object,
+    array,
+    code
+};

package/libs/function/throttle.ts

@@ -0,0 +1,31 @@
+let timer: ReturnType<typeof setTimeout> | undefined;
+let flag: boolean | undefined;
+/**
+ * 节流原理：在一定时间内，只能触发一次
+ * @param func 要执行的回调函数
+ * @param wait 延时的时间，单位ms，默认500
+ * @param immediate 是否立即执行，默认true
+ * @returns void
+ */
+function throttle(func: () => void, wait: number = 500, immediate: boolean = true): void {
+    if (immediate) {
+        if (!flag) {
+            flag = true;
+            // 如果是立即执行，则在wait毫秒内开始时执行
+            typeof func === 'function' && func();
+            timer = setTimeout(() => {
+                flag = false;
+            }, wait);
+        }
+    } else {
+        if (!flag) {
+            flag = true;
+            // 如果是非立即执行，则在wait毫秒内的结束处执行
+            timer = setTimeout(() => {
+                flag = false;
+                typeof func === 'function' && func();
+            }, wait);
+        }
+    }
+}
+export default throttle;

package/libs/function/timeFormat.ts

@@ -0,0 +1,54 @@
+// padStart 的 polyfill，因为某些机型或情况，还无法支持es7的padStart，比如电脑版的微信小程序
+// 所以这里做一个兼容polyfill的兼容处理
+if (!String.prototype.padStart) {
+    // 为了方便表示这里 fillString 用了ES6 的默认参数，不影响理解
+    String.prototype.padStart = function (this: string, maxLength: number, fillString: string = ' '): string {
+        if (Object.prototype.toString.call(fillString) !== '[object String]') throw new TypeError('fillString must be String');
+        let str = this;
+        if (str.length >= maxLength) return String(str);
+        let fillLength = maxLength - str.length,
+            times = Math.ceil(fillLength / fillString.length);
+        while ((times >>= 1)) {
+            fillString += fillString;
+            if (times === 1) {
+                fillString += fillString;
+            }
+        }
+        return fillString.slice(0, fillLength) + str;
+    };
+}
+
+/**
+ * 时间格式化
+ * @param dateTime 时间戳、Date对象或null，默认当前时间
+ * @param fmt 格式化字符串，默认 'yyyy-mm-dd'
+ * @returns 格式化后的时间字符串
+ */
+function timeFormat(dateTime: number | string | Date | null = null, fmt: string = 'yyyy-mm-dd'): string {
+    // 如果为null,则格式化当前时间
+    if (!dateTime) dateTime = Number(new Date());
+    // 如果dateTime长度为10或者13，则为秒和毫秒的时间戳，如果超过13位，则为其他的时间格式
+    if (typeof dateTime === 'number' || typeof dateTime === 'string') {
+        if (dateTime.toString().length == 10) dateTime = Number(dateTime) * 1000;
+    }
+    const date = new Date(dateTime);
+    let ret: RegExpExecArray | null;
+    const opt: Record<string, string> = {
+        'y+': date.getFullYear().toString(), // 年
+        'm+': (date.getMonth() + 1).toString(), // 月
+        'd+': date.getDate().toString(), // 日
+        'h+': date.getHours().toString(), // 时
+        'M+': date.getMinutes().toString(), // 分
+        's+': date.getSeconds().toString() // 秒
+        // 有其他格式化字符需求可以继续添加，必须转化成字符串
+    };
+    for (const k in opt) {
+        ret = new RegExp('(' + k + ')').exec(fmt);
+        if (ret) {
+            fmt = fmt.replace(ret[1], ret[1].length == 1 ? opt[k] : opt[k].padStart(ret[1].length, '0'));
+        }
+    }
+    return fmt;
+}
+
+export default timeFormat;

package/libs/function/timeFrom.ts

@@ -0,0 +1,48 @@
+import timeFormat from './timeFormat';
+
+/**
+ * 时间戳转为多久之前
+ * @param dateTime 时间戳、Date对象或null，默认当前时间
+ * @param format 时间格式字符串或false，超出范围时返回指定格式，否则返回多久以前
+ * @returns 格式化后的时间字符串
+ */
+function timeFrom(dateTime: number | string | Date | null = null, format: string | false = 'yyyy-mm-dd'): string {
+    // 如果为null,则格式化当前时间
+    if (!dateTime) dateTime = Number(new Date());
+    // 如果dateTime长度为10或者13，则为秒和毫秒的时间戳，如果超过13位，则为其他的时间格式
+    if (typeof dateTime === 'number' || typeof dateTime === 'string') {
+        if (dateTime.toString().length == 10) dateTime = Number(dateTime) * 1000;
+    }
+    const timestamp = +new Date(Number(dateTime));
+    const timer = (Number(new Date()) - timestamp) / 1000;
+    // 如果小于5分钟,则返回"刚刚",其他以此类推
+    let tips = '';
+    switch (true) {
+        case timer < 300:
+            tips = '刚刚';
+            break;
+        case timer >= 300 && timer < 3600:
+            tips = parseInt(String(timer / 60)) + '分钟前';
+            break;
+        case timer >= 3600 && timer < 86400:
+            tips = parseInt(String(timer / 3600)) + '小时前';
+            break;
+        case timer >= 86400 && timer < 2592000:
+            tips = parseInt(String(timer / 86400)) + '天前';
+            break;
+        default:
+            // 如果format为false，则无论什么时间戳，都显示xx之前
+            if (format === false) {
+                if (timer >= 2592000 && timer < 365 * 86400) {
+                    tips = parseInt(String(timer / (86400 * 30))) + '个月前';
+                } else {
+                    tips = parseInt(String(timer / (86400 * 365))) + '年前';
+                }
+            } else {
+                tips = timeFormat(timestamp, format as string);
+            }
+    }
+    return tips;
+}
+
+export default timeFrom;

package/libs/function/toast.ts

@@ -0,0 +1,14 @@
+/**
+ * 显示无图标的 Toast 提示
+ * @param title 提示文本
+ * @param duration 显示时长（毫秒），默认1500
+ */
+function toast(title: string, duration: number = 1500): void {
+    uni.showToast({
+        title: title,
+        icon: 'none',
+        duration: duration
+    });
+}
+
+export default toast;

package/libs/function/trim.ts

@@ -0,0 +1,21 @@
+/**
+ * 去除字符串空格
+ * @param str 输入字符串
+ * @param pos 去除位置，'both' | 'left' | 'right' | 'all'，默认'both'
+ * @returns 去除空格后的字符串
+ */
+function trim(str: string, pos: 'both' | 'left' | 'right' | 'all' = 'both'): string {
+    if (pos === 'both') {
+        return str.replace(/^\s+|\s+$/g, '');
+    } else if (pos === 'left') {
+        return str.replace(/^\s*/, '');
+    } else if (pos === 'right') {
+        return str.replace(/(\s*$)/g, '');
+    } else if (pos === 'all') {
+        return str.replace(/\s+/g, '');
+    } else {
+        return str;
+    }
+}
+
+export default trim;

package/libs/function/type2icon.ts

@@ -0,0 +1,36 @@
+/**
+ * 根据主题type值,获取对应的图标
+ * @param type 主题名称, primary|info|error|warning|success，默认success
+ * @param fill 是否使用fill填充实体的图标，默认false
+ * @returns 图标名称字符串
+ */
+function type2icon(type: 'primary' | 'info' | 'error' | 'warning' | 'success' = 'success', fill: boolean = false): string {
+    // 如果非预置值,默认为success
+    if (!['primary', 'info', 'error', 'warning', 'success'].includes(type)) type = 'success';
+    let iconName = '';
+    // 目前(2019-12-12),info和primary使用同一个图标
+    switch (type) {
+        case 'primary':
+            iconName = 'info-circle';
+            break;
+        case 'info':
+            iconName = 'info-circle';
+            break;
+        case 'error':
+            iconName = 'close-circle';
+            break;
+        case 'warning':
+            iconName = 'error-circle';
+            break;
+        case 'success':
+            iconName = 'checkmark-circle';
+            break;
+        default:
+            iconName = 'checkmark-circle';
+    }
+    // 是否是实体类型,加上-fill,在icon组件库中,实体的类名是后面加-fill的
+    if (fill) iconName += '-fill';
+    return iconName;
+}
+
+export default type2icon;

package/libs/hooks/useEmitter.ts

@@ -0,0 +1,77 @@
+import { type ComponentInternalInstance, getCurrentInstance } from 'vue';
+
+/**
+ * 将事件名转换为驼峰格式
+ * @param str 需要转换的字符串
+ * @description 例如：on-form-change -> onFormChange
+ * @returns
+ */
+function formatToCamelCase(str: string): string {
+    return str.replace(/-([a-z])/g, function (g) {
+        return g[1].toUpperCase();
+    });
+}
+
+export function useEmitter(name: string) {
+    const instance: ComponentInternalInstance | null | undefined = getCurrentInstance();
+
+    /** * 向上查找父组件并派发事件
+     * @param instance 当前组件实例（setup中可用getCurrentInstance()）
+     * @param componentName 目标组件名
+     * @param eventName 事件名
+     * @param params 参数
+     */
+    function dispatch(componentName: string, eventName: string, ...params: any[]) {
+        let parent = instance && (instance.parent as ComponentInternalInstance | null | undefined);
+        while (parent) {
+            const name = (parent.type as any)?.name as string | undefined;
+            if (name === componentName) {
+                // 找到目标组件，派发事件
+                // Vue3未解决，目标组件事件监听失效，待优化，暂时使用下面的方式解决，如果你有好的方式也可以告诉我或者提PR
+                parent.emit && parent.emit(eventName, ...params);
+                // 如果有对应的方法，执行方法
+                // 这里可以考虑将 eventName 转换为驼峰格式
+                // 例如：on-form-change -> onFormChange
+                parent.exposed?.[formatToCamelCase(eventName)] && parent.exposed[formatToCamelCase(eventName)](...params);
+                break;
+            }
+            parent = parent.parent;
+        }
+    }
+
+    /**
+     * 向下递归查找子组件并广播事件
+     * @param instance 当前组件实例（setup中可用getCurrentInstance()）
+     * @param componentName 目标组件名
+     * @param eventName 事件名
+     * @param params 参数
+     */
+    function broadcast(componentName: string, eventName: string, ...params: any[]) {
+        if (!instance) return;
+        const subTree = (instance.subTree as any)?.children || [];
+        const children = Array.isArray(subTree) ? subTree : [subTree];
+        children.forEach((vnode: any) => {
+            const child = vnode.component as ComponentInternalInstance | undefined;
+
+            if (child) {
+                const name = (child.type as any)?.name as string | undefined;
+                if (name === componentName) {
+                    // 找到目标组件，广播事件
+                    // Vue3未解决，目标组件事件监听失效，待优化，暂时使用下面的方式解决，如果你有好的方式也可以告诉我或者提PR
+                    child.emit && child.emit(eventName, ...params);
+                    // 如果有对应的方法，执行方法
+                    // 这里可以考虑将 eventName 转换为驼峰格式
+                    // 例如：on-form-change -> onFormChange
+                    child.exposed?.[formatToCamelCase(eventName)] && child.exposed[formatToCamelCase(eventName)](...params);
+                } else {
+                    broadcast.call(child, componentName, eventName, ...params);
+                }
+            }
+        });
+    }
+
+    return {
+        dispatch,
+        broadcast
+    };
+}

package/libs/hooks/useParent.ts

@@ -0,0 +1,29 @@
+import { type ComponentInternalInstance, getCurrentInstance } from 'vue'
+
+export function useParent(name: string) {
+  const instance: ComponentInternalInstance | null | undefined = getCurrentInstance()
+
+  function getParent(componentName?: string) {
+    componentName = componentName || name
+    let parent = instance && (instance.parent as ComponentInternalInstance | null | undefined)
+
+    while (parent) {
+      const name = (parent.type as any)?.name as string | undefined
+      if (name === componentName) {
+        return parent
+      }
+      parent = parent.parent
+    }
+    return null
+  }
+  function getParentData(componentName?: string) {
+    componentName = componentName || name
+    const parent = getParent(componentName)
+    return parent ? parent.exposed : null
+  }
+
+  return {
+    getParent,
+    getParentData
+  }
+}