fusions-ui 1.2.7 → 1.2.8

package/utils/common.ts

@@ -0,0 +1,609 @@
+import { getCurrentInstance, type ComponentInternalInstance } from 'vue';
+import check from './check'
+import digit from './digit'
+
+/**
+ * @description 获取父组件实例
+ * 
+ * @param {string} componentName 父组件名称
+ * @description 获取父组件实例，如果没有找到则返回null
+ * @example $parent('components') // => 父组件实例
+ * @example $parent() // => 直接父组件实例
+ */
+const $parent = (componentName?: string, instance?: ComponentInternalInstance) => {
+	const componentInstance: ComponentInternalInstance = instance || getCurrentInstance();
+	if (!componentInstance) return null;
+	let parent = componentInstance.parent;
+	if (!componentName) return parent;
+	while (parent) {
+		if (
+			(parent.type && parent.type.name === componentName) ||
+			(parent.type && parent.type.__name === componentName)
+		) {
+			return parent;
+		}
+		parent = parent.parent;
+	}
+	return null;
+};
+
+/**
+ * @description 样式转换, 对象转字符串, 或者字符串转对象
+ * 
+ * @param {string|object} customStyle 需要转换的目标
+ * @param {string} target 转换的目的，object-转为对象，string-转为字符串
+ * @returns {object|string}
+ * @example addStyle('font-size: 14px; color: red;') // => {fontSize: '14px', color: 'red'}
+ * @example addStyle('font-size: 14px; color: red;', 'string') // => 'font-size: 14px; color: red;'
+ */
+function addStyle(customStyle : string | object, target : 'object' | 'string' = 'object') : string | object {
+	// 字符串转字符串，对象转对象情形，直接返回
+	if (check.isNull(customStyle) || typeof (customStyle) === 'object' && target === 'object' || target === 'string' && typeof (customStyle) === 'string') {
+		return customStyle
+	}
+	// 字符串转对象
+	if (target === 'object') {
+		if (typeof customStyle !== 'string') {
+			return customStyle; // 如果不是字符串，直接返回
+		}
+		// 去除字符串样式中的两端空格(中间的空格不能去掉，比如padding: 14px 0如果去掉了就错了)，空格是无用的
+		customStyle = trim(customStyle);
+		// 根据";"将字符串转为数组形式
+		const styleArray = customStyle.split(';');
+		const style = {};
+		// 历遍数组，拼接成对象
+		for (let i = 0; i < styleArray.length; i++) {
+			// 'font-size:14px;color:red;'，如此最后字符串有";"的话，会导致styleArray最后一个元素为空字符串，这里需要过滤
+			if (styleArray[i]) {
+				const item = styleArray[i].split(':')
+				style[trim(item[0])] = trim(item[1])
+			}
+		}
+		return style
+	}
+	// 这里为对象转字符串形式
+	let string = '';
+	if (customStyle && typeof customStyle === 'object') {
+		for (const i in customStyle) {
+			// 驼峰转为中划线的形式，否则css内联样式，无法识别驼峰样式属性名
+			const key = i.replace(/([A-Z])/g, '-$1').toLowerCase()
+			string += `${key}:${customStyle[i]};`
+		}
+		// 去除两端空格
+		return trim(string);
+	}
+	return ''
+}
+
+/**
+ * @description 添加单位，如果有rpx，upx，%，px等单位结尾或者值为auto，直接返回，否则加上px单位结尾
+ * 
+ * @param {string|number} value 需要添加单位的值
+ * @param {string} unit 添加的单位名 比如px
+ * @example addUnit(14) // => '14px'
+ * @example addUnit(14, 'upx') // => '14upx'
+ */
+function addUnit(value : string | number = 'auto', unit : string = uni.$fu.config.unit || 'px') {
+	value = String(value)
+	// 用Fusions内置验证规则中的checkNumber判断是否为数值
+	return check.checkNumber(value) ? `${value}${unit}` : value
+}
+
+/**
+ * @description 深度克隆
+ * 
+ * @param {object} obj 需要深度克隆的对象
+ * @param cache 缓存
+ * @returns {*} 克隆后的对象或者原值（不是对象）
+ */
+function deepClone<T>(obj : T, cache = new WeakMap()) : T {
+	if (obj === null || typeof obj !== 'object') return obj;
+	if (cache.has(obj)) return cache.get(obj);
+	if (obj instanceof Date) return new Date(obj.getTime()) as unknown as T;
+	if (obj instanceof RegExp) return new RegExp(obj) as unknown as T;
+	if (obj instanceof Map) {
+		const clone = new Map();
+		cache.set(obj, clone);
+		obj.forEach((value, key) => {
+			clone.set(deepClone(key, cache), deepClone(value, cache));
+		});
+		return clone as unknown as T;
+	}
+	if (obj instanceof Set) {
+		const clone = new Set();
+		cache.set(obj, clone);
+		obj.forEach(value => {
+			clone.add(deepClone(value, cache));
+		});
+		return clone as unknown as T;
+	}
+	if (obj instanceof Symbol) return Object(Symbol.prototype.valueOf.call(obj)) as unknown as T;
+	if (obj instanceof Function) return obj;
+
+	if (Array.isArray(obj)) {
+		const clone = [] as unknown as T;
+		cache.set(obj, clone);
+		obj.forEach((value, index) => {
+			(clone as unknown as any[])[index] = deepClone(value, cache);
+		});
+		return clone;
+	}
+
+	if (Object.prototype.toString.call(obj) === '[object Object]') {
+		const clone = Object.create(Object.getPrototypeOf(obj));
+		cache.set(obj, clone);
+		Object.keys(obj).forEach(key => {
+			(clone as any)[key] = deepClone((obj as any)[key], cache);
+		});
+		return clone;
+	}
+
+	const clone = Object.assign({}, obj);
+	cache.set(obj, clone);
+	return clone;
+}
+
+/**
+ * @description 深度合并对象
+ * 
+ * @param {object} target 需要拷贝的对象
+ * @param {object} source 拷贝的来源对象
+ * @returns {object|boolean} 深度合并后的对象或者false（入参有不是对象）
+ */
+function deepMerge<T extends object, S extends object>(target : T = {} as T, source : S = {} as S) : object | boolean {
+	target = deepClone(target);
+	if (
+		typeof target !== 'object' || target === null || typeof source !== 'object' || source === null
+	)
+		return target;
+	const merged : any = Array.isArray(target) ? target.slice() : Object.assign({}, target);
+	for (const prop in source) {
+		if (!Object.prototype.hasOwnProperty.call(source, prop)) continue;
+		const sourceValue = (source as any)[prop];
+		const targetValue = merged[prop];
+
+		if (sourceValue instanceof Date) {
+			merged[prop] = new Date(sourceValue);
+		} else if (sourceValue instanceof RegExp) {
+			merged[prop] = new RegExp(sourceValue);
+		} else if (sourceValue instanceof Map) {
+			merged[prop] = new Map(sourceValue);
+		} else if (sourceValue instanceof Set) {
+			merged[prop] = new Set(sourceValue);
+		} else if (typeof sourceValue === 'object' && sourceValue !== null) {
+			merged[prop] = deepMerge(targetValue, sourceValue);
+		} else {
+			merged[prop] = sourceValue;
+		}
+	}
+	return merged;
+}
+
+/**
+ * @description 全局唯一标识符
+ * 
+ * @param {Number} len uuid的长度
+ * @param {Boolean} firstFu 将返回的首字母置为"Fu"
+ * @param {Nubmer} radix 生成uuid的基数(意味着返回的字符串都是这个基数),2-二进制,8-八进制,10-十进制,16-十六进制
+ */
+function uuid(len : number = 32, firstFu : boolean = true, radix : number | null = null) {
+	const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('');
+	const uuid = [];
+	radix = radix || chars.length;
+	if (len) {
+		// 如果指定uuid长度,只是取随机的字符,0|x为位运算,能去掉x的小数位,返回整数位
+		for (let i = 0; i < len; i++) uuid[i] = chars[0 | Math.random() * radix]
+	} else {
+		let r : number;
+		// rfc4122标准要求返回的uuid中,某些位为固定的字符
+		uuid[8] = uuid[13] = uuid[18] = uuid[23] = '-';
+		uuid[14] = '4';
+		for (let i = 0; i < 36; i++) {
+			if (!uuid[i]) {
+				r = 0 | Math.random() * 16;
+				uuid[i] = chars[(i == 19) ? (r & 0x3) | 0x8 : r];
+			}
+		}
+	}
+	// 移除第一个字符,并用fu替代,因为第一个字符为数值时,该guid不能用作id或者class
+	if (firstFu) {
+		uuid.shift()
+		return `fu${uuid.join('')}`
+	}
+	return uuid.join('')
+}
+
+/**
+ * @description error提示
+ * 
+ * @param {*} err 错误内容
+ */
+function error(err : string) {
+	// 开发环境才提示，生产环境不会提示
+	if (process.env.NODE_ENV === 'development') {
+		console.error(`Fusions提示：${err}`)
+	}
+}
+
+/**
+ * @description 返回一个在[min, max]范围内的随机整数
+ * 
+ * @param {number} min 最小值
+ * @param {number} max 最大值
+ */
+function random(min : number, max : number) {
+	if (min >= 0 && max > 0 && max >= min) {
+		const gab = max - min + 1
+		return Math.floor(Math.random() * gab + min)
+	}
+	return 0
+}
+
+/**
+ * @description 打乱数组
+ * 
+ * @param {array} array 需要打乱的数组
+ * @returns {array} 打乱后返回的数组
+ */
+function randomArray(array : any[]) : Array<any> {
+	// 原理是sort排序,Math.random()产生0<= x < 1之间的数,会导致x-0.05大于或者小于0
+	return array.sort(() => Math.random() - 0.5)
+}
+
+/**
+ * @description 如果value小于min，取min；如果value大于max，取max
+ * 
+ * @param {number} min 
+ * @param {number} max 
+ * @param {number} value
+ */
+function range(min : number, max : number, value : number) {
+	return Math.max(min, Math.min(max, Number(value)))
+}
+
+/**
+ * @description 数字格式化
+ * @param {string|number} number 要格式化的数字
+ * @param {number} decimals 保留几位小数
+ * @param {string} decimalPoint 小数点符号
+ * @param {string} thousandsSeparator 千分位符号
+ * @returns {string} 格式化后的数字
+ */
+function priceFormat(number : string | number, decimals : number = 0, decimalPoint : string = '.', thousandsSeparator : string = ',') : string {
+	number = (`${number}`).replace(/[^0-9+-Ee.]/g, '')
+	const n = !isFinite(+number) ? 0 : +number
+	const prec = !isFinite(+decimals) ? 0 : Math.abs(decimals)
+	const sep = (typeof thousandsSeparator === 'undefined') ? ',' : thousandsSeparator
+	const dec = (typeof decimalPoint === 'undefined') ? '.' : decimalPoint
+	let s : string[] = [];
+
+	s = (prec ? digit.round(n, prec) + '' : `${Math.round(n)}`).split('.')
+	const re = /(-?\d+)(\d{3})/
+	while (re.test(s[0])) {
+		s[0] = s[0].replace(re, `$1${sep}$2`)
+	}
+
+	if ((s[1] || '').length < prec) {
+		s[1] = s[1] || ''
+		s[1] += new Array(prec - s[1].length + 1).join('0')
+	}
+	return s.join(dec)
+}
+
+/**
+ * @description 年月日 时分秒转时间戳
+ * 
+ * @param {string} value 日期
+ * @returns 毫秒
+ */
+function formatTimestamp(value : string) {
+	const time = new Date(value);
+	const timestamp = time.getTime();
+	return timestamp
+}
+
+/**
+ * @param {string|number} value：数据转化
+ */
+function formatNumber(value : string | number) {
+	value = value.toString()
+
+	return value[1] ? value : '0' + value
+}
+
+/**
+ * @description 时间戳转化为年 月 日 时 分 秒
+ * 
+ * @param {string|number} value 传入时间戳（秒/毫秒）
+ * @param {String} format 返回格式，支持自定义，但参数必须与formateArr里保持一致
+ * @returns {string} 返回格式化后的字符串
+ * @example formatTime(时间戳, 'Y-M-D h:m:s')
+ */
+function formatTime(value ?: Date | string | number, format : string = 'Y-M-D h:m:s') : string {
+	var formateArr = ['Y', 'M', 'D', 'h', 'm', 's'];
+	var date : Date;
+	// 判断传入的时间为假值，则取当前时间
+	if (!value) {
+		date = new Date()
+	}
+	// 若为unit秒时间戳，则转为毫秒时间戳
+	else if (/^\d{10}$/.test(value?.toString().trim())) {
+		date = new Date(Number(value) * 1000);
+	}
+	// 若用户传入字符串格式时间戳，new Date无法解析
+	else if (typeof value === 'string' && /^\d+$/.test(value.trim())) {
+		date = new Date(Number(value));
+	}
+	// 处理平台性差异，在Safari/Webkit中，new Date仅支持/作为分割符的字符串时间
+	// 处理 '2025-12-15 05:15:25'，跳过 '2025-12-15T05:15:25'
+	else if (typeof value === 'string' && value.includes('-') && !value.includes('T')) {
+		date = new Date(value.replace(/-/g, '/'))
+	}
+	// 其他都认为符合 RFC 2822 规范
+	else {
+		date = new Date(value)
+	}
+
+	const returnArr = [
+		date.getFullYear().toString(),
+		formatNumber(date.getMonth() + 1),
+		formatNumber(date.getDate()),
+		formatNumber(date.getHours()),
+		formatNumber(date.getMinutes()),
+		formatNumber(date.getSeconds())
+	];
+
+	for (var i in returnArr) {
+		format = format.replace(formateArr[i], returnArr[i]);
+	}
+
+	return format;
+}
+
+/**
+ * @description 时间戳转为多久之前
+ * @param {string|number} value 时间戳
+ * @param {string|boolean} format
+ * 格式化规则如果为时间格式字符串，超出一定时间范围，返回固定的时间格式；
+ * 如果为布尔值false，无论什么时间，都返回多久以前的格式
+ * @returns {string} 转化后的内容
+ * @example timeAgo(时间戳, format)
+ */
+function timeAgo(value : string | number | Date, format : string | false = 'Y-M-D') : string {
+	// 获取时间戳
+	const timestamp = new Date(value).getTime();
+	if (isNaN(timestamp)) return '无效日期';
+
+	// 处理秒级时间戳
+	const ms = timestamp.toString().length === 10 ? timestamp * 1000 : timestamp;
+
+	// 计算时间差（秒）
+	const diff = Math.floor((Date.now() - ms) / 1000);
+
+	// 时间单位
+	const units = [
+		[60, '刚刚', 5], // 5分钟内
+		[3600, '分钟前', 60],
+		[86400, '小时前', 3600],
+		[2592000, '天前', 86400],
+		[31536000, '个月前', 2592000],
+		[Infinity, '年前', 31536000]
+	] as const;
+
+	for (const [limit, text, divisor] of units) {
+		if (diff < limit) {
+			return divisor === 5 ? text : `${Math.floor(diff / divisor)}${text}`;
+		}
+	}
+
+	// 超过1年且format为false时显示年前
+	if (format === false) {
+		return `${Math.floor(diff / 31536000)}年前`;
+	}
+
+	return formatTime(new Date(ms), format as string);
+}
+
+/**
+ * @description 去除空格
+ * @param {string} value 需要去除空格的字符串
+ * @param {string} pos both(左右)|left|right|all 默认both
+ */
+function trim(value : string, pos : 'both' | 'left' | 'right' | 'all' = 'both') : string {
+	value = String(value)
+	if (pos == 'both') {
+		return value.replace(/^\s+|\s+$/g, '')
+	}
+	if (pos == 'left') {
+		return value.replace(/^\s*/, '')
+	}
+	if (pos == 'right') {
+		return value.replace(/(\s*$)/g, '')
+	}
+	if (pos == 'all') {
+		return value.replace(/\s+/g, '')
+	}
+	return value
+}
+
+/**
+ * @description 用于获取用户传递值的px值  如果用户传递了"xxpx"或者"xxrpx"，取出其数值部分，如果是"xxxrpx"还需要用过uni.upx2px进行转换
+ * @param {number|string} value 用户传递值的px值
+ * @param {boolean} unit 
+ * @returns {number|string}
+ */
+function getPx(value : string | number, unit : boolean = false) : number | string {
+	if (check.checkNumber(value)) {
+		return unit ? `${value}px` : Number(value)
+	}
+	// 如果带有rpx，先取出其数值部分，再转为px值
+	if (/(rpx|upx)$/.test(value.toString())) {
+		return unit ? `${uni.upx2px(parseInt(value.toString()))}px` : Number(uni.upx2px(parseInt(value.toString())))
+	}
+	return unit ? `${parseInt(value.toString())}px` : parseInt(value.toString())
+}
+
+/**
+ * @description 进行延时，以达到可以简写代码的目的
+ * @param {number} value 堵塞时间 单位ms 毫秒
+ * @example await sleep(2000);
+ @example sleep(2000).then(() => { console.log('延迟执行'); });
+ */
+function sleep(value : number = 30) {
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			resolve(true)
+		}, value)
+	})
+}
+
+/**
+ * @description 日期的月或日补零操作
+ * @param {string} value 需要补零的值
+ */
+function padZero(value : string) {
+	return `00${value}`.slice(-2)
+}
+
+/**
+ * @description 获取系统信息同步接口
+ * @link 获取系统信息同步接口 https://uniapp.dcloud.io/api/system/info?id=getsysteminfosync 
+ */
+function sys() {
+	return uni.getSystemInfoSync()
+}
+
+/**
+ * @description 获取操作系统类型
+ * @returns {string} 返回操作系统类型，例如：'android', 'ios', 'windows'等(小写) 
+ * @link 运行期判断平台 https://uniapp.dcloud.io/frame?id=判断平台
+ * @example os() // => 'android'
+ */
+function os() : string {
+	// #ifdef APP || H5 || MP-WEIXIN
+	return uni.getDeviceInfo().platform.toLowerCase();
+	// #endif
+	// 微信小程序 从基础库 2.20.1 开始，本接口停止维护
+	// #ifndef APP || H5 || MP-WEIXIN
+	return uni.getSystemInfoSync().platform.toLowerCase();
+	// #endif
+}
+
+/**
+ * @description 获取某个对象下的属性，用于通过类似'a.b.c'的形式去获取一个对象的的属性的形式
+ * @param {object} obj 对象
+ * @param {string} key 需要获取的属性字段
+ * @returns {*}
+ */
+function getProperty(obj : Record<string, any>, key : string) : any {
+	if (!obj) {
+		return
+	}
+	if (typeof key !== 'string' || key === '') {
+		return ''
+	}
+	if (key.indexOf('.') !== -1) {
+		const keys = key.split('.')
+		let firstObj = obj[keys[0]] || {}
+
+		for (let i = 1; i < keys.length; i++) {
+			if (firstObj) {
+				firstObj = firstObj[keys[i]]
+			}
+		}
+		return firstObj
+	}
+	return obj[key]
+}
+
+/**
+ * @description 设置对象的属性值，如果'a.b.c'的形式进行设置
+ * @param {object} obj 对象
+ * @param {string} key 需要设置的属性
+ * @param {string} value 设置的值
+ */
+function setProperty(obj : Record<string, any>, key : string, value : any) {
+	if (!obj) {
+		return
+	}
+	// 递归赋值
+	const inFn = function (_obj : Record<string, any>, keys : string[], v : any) {
+		// 最后一个属性key
+		if (keys.length === 1) {
+			_obj[keys[0]] = v
+			return
+		}
+		// 0~length-1个key
+		while (keys.length > 1) {
+			const k = keys[0]
+			if (!_obj[k] || (typeof _obj[k] !== 'object')) {
+				_obj[k] = {}
+			}
+			// 自调用判断是否存在属性，不存在则自动创建对象
+			inFn(_obj[k], keys, v)
+		}
+	}
+
+	if (typeof key !== 'string' || key === '') {
+
+	} else if (key.indexOf('.') !== -1) { // 支持多层级赋值操作
+		const keys = key.split('.')
+		inFn(obj, keys, value)
+	} else {
+		obj[key] = value
+	}
+}
+
+/**
+ * 公共类型声明
+ */
+export type Common = {
+	[key : string] : any;
+	$parent : typeof $parent;
+	addStyle : typeof addStyle;
+	addUnit : typeof addUnit;
+	deepClone : typeof deepClone;
+	deepMerge : typeof deepMerge;
+	uuid : typeof uuid;
+	error : typeof error;
+	random : typeof random;
+	randomArray : typeof randomArray;
+	range : typeof range;
+	priceFormat : typeof priceFormat;
+	formatTimestamp : typeof formatTimestamp;
+	formatTime : typeof formatTime;
+	timeAgo : typeof timeAgo;
+	trim : typeof trim;
+	getPx : typeof getPx;
+	sleep : typeof sleep;
+	padZero : typeof padZero;
+	sys : typeof sys;
+	os : typeof os;
+	getProperty : typeof getProperty;
+	setProperty : typeof setProperty;
+}
+
+export {
+	$parent,
+	addStyle,
+	addUnit,
+	deepClone,
+	deepMerge,
+	uuid,
+	error,
+	random,
+	randomArray,
+	range,
+	priceFormat,
+	formatTimestamp,
+	formatTime,
+	timeAgo,
+	trim,
+	getPx,
+	sleep,
+	padZero,
+	sys,
+	os,
+	getProperty,
+	setProperty
+}