@10yun/cv-mobile-ui 0.5.26 → 0.5.29

package/uview-plus/libs/function/index.js

@@ -1,23 +1,28 @@
-import test from './test.js'
+import {
+	number as testNumber,
+	array as testArray,
+	empty as testEmpty
+} from './test'
 import { round } from './digit.js'
+import config from '../config/config';
 /**
  * @description 如果value小于min，取min；如果value大于max，取max
  * @param {number} min 
  * @param {number} max 
  * @param {number} value
  */
-function range(min = 0, max = 0, value = 0) {
+export function range(min = 0, max = 0, value = 0) {
 	return Math.max(min, Math.min(max, Number(value)))
 }
 
 /**
- * @description 用于获取用户传递值的px值  如果用户传递了"xxpx"或者"xxrpx"，取出其数值部分，如果是"xxxrpx"还需要用过uni.upx2px进行转换
+ * @description 用于获取用户传递值的px值  如果用户传递了"xxpx"或者"xxrpx"，取出其数值部分，如果是"xxxrpx"还需要用过uni.rpx2px进行转换
  * @param {number|string} value 用户传递值的px值
  * @param {boolean} unit 
  * @returns {number|string}
  */
-function getPx(value, unit = false) {
-	if (test.number(value)) {
+export function getPx(value, unit = false) {
+	if (testNumber(value)) {
 		return unit ? `${value}px` : Number(value)
 	}
 	// 如果带有rpx，先取出其数值部分，再转为px值
@@ -32,7 +37,7 @@ function getPx(value, unit = false) {
  * @param {number} value 堵塞时间 单位ms 毫秒
  * @returns {Promise} 返回promise
  */
-function sleep(value = 30) {
+export function sleep(value = 30) {
 	return new Promise((resolve) => {
 		setTimeout(() => {
 			resolve()
@@ -44,23 +49,48 @@ function sleep(value = 30) {
  * @returns {string} 返回所在平台(小写) 
  * @link 运行期判断平台 https://uniapp.dcloud.io/frame?id=判断平台
  */
-function os() {
+export function os() {
+	// #ifdef APP || H5 || MP-WEIXIN
+	return uni.getDeviceInfo().platform.toLowerCase()
+	// #endif
+	// #ifndef APP || H5 || MP-WEIXIN
 	return uni.getSystemInfoSync().platform.toLowerCase()
+	// #endif
 }
 /**
  * @description 获取系统信息同步接口
  * @link 获取系统信息同步接口 https://uniapp.dcloud.io/api/system/info?id=getsysteminfosync 
  */
-function sys() {
+export function sys() {
 	return uni.getSystemInfoSync()
 }
+export function getWindowInfo() {
+	let ret = {}
+	// #ifdef APP || H5 || MP-WEIXIN
+	ret = uni.getWindowInfo()
+	// #endif
+	// #ifndef APP || H5 || MP-WEIXIN
+	ret = sys()
+	// #endif
+	return ret
+}
+export function getDeviceInfo() {
+	let ret = {}
+	// #ifdef APP || H5 || MP-WEIXIN
+	ret = uni.getDeviceInfo()
+	// #endif
+	// #ifndef APP || H5 || MP-WEIXIN
+	ret = sys()
+	// #endif
+	return ret
+}
 
 /**
  * @description 取一个区间数
  * @param {Number} min 最小值
  * @param {Number} max 最大值
  */
-function random(min, max) {
+export function random(min, max) {
 	if (min >= 0 && max > 0 && max >= min) {
 		const gab = max - min + 1
 		return Math.floor(Math.random() * gab + min)
@@ -73,7 +103,7 @@ function random(min, max) {
  * @param {Boolean} firstU 将返回的首字母置为"u"
  * @param {Nubmer} radix 生成uuid的基数(意味着返回的字符串都是这个基数),2-二进制,8-八进制,10-十进制,16-十六进制
  */
-function guid(len = 32, firstU = true, radix = null) {
+export function guid(len = 32, firstU = true, radix = null) {
 	const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('')
 	const uuid = []
 	radix = radix || chars.length
@@ -109,11 +139,12 @@ function guid(len = 32, firstU = true, radix = null) {
    值(默认为undefined)，就是查找最顶层的$parent
 *  @param {string|undefined} name 父组件的参数名
 */
-function $parent(name = undefined) {
+export function $parent(name = undefined) {
 	let parent = this.$parent
 	// 通过while历遍，这里主要是为了H5需要多层解析的问题
 	while (parent) {
 		// 父组件
+        name = name.replace(/up-([a-zA-Z0-9-_]+)/g, 'u-$1')        
 		if (parent.$options && parent.$options.name !== name) {
 			// 如果组件的name不相等，继续上一级寻找
 			parent = parent.$parent
@@ -131,9 +162,9 @@ function $parent(name = undefined) {
  * @param {String} target 转换的目的，object-转为对象，string-转为字符串
  * @returns {object|string}
  */
-function addStyle(customStyle, target = 'object') {
+export function addStyle(customStyle, target = 'object') {
 	// 字符串转字符串，对象转对象情形，直接返回
-	if (test.empty(customStyle) || typeof(customStyle) === 'object' && target === 'object' || target === 'string' &&
+	if (testEmpty(customStyle) || typeof(customStyle) === 'object' && target === 'object' || target === 'string' &&
 		typeof(customStyle) === 'string') {
 		return customStyle
 	}
@@ -156,10 +187,12 @@ function addStyle(customStyle, target = 'object') {
 	}
 	// 这里为对象转字符串形式
 	let string = ''
-	for (const i in customStyle) {
-		// 驼峰转为中划线的形式，否则css内联样式，无法识别驼峰样式属性名
-		const key = i.replace(/([A-Z])/g, '-$1').toLowerCase()
-		string += `${key}:${customStyle[i]};`
+	if (typeof customStyle === 'object') {
+		customStyle.forEach((val, i) => {
+			// 驼峰转为中划线的形式，否则css内联样式，无法识别驼峰样式属性名
+			const key = i.replace(/([A-Z])/g, '-$1').toLowerCase()
+			string += `${key}:${val};`
+		})
 	}
 	// 去除两端空格
 	return trim(string)
@@ -170,13 +203,16 @@ function addStyle(customStyle, target = 'object') {
  * @param {string|number} value 需要添加单位的值
  * @param {string} unit 添加的单位名 比如px
  */
-function addUnit(value = 'auto', unit = '') {
-	if (!unit) {
-		unit = uni.$u.config.unit || 'px'
+export function addUnit(value = 'auto', unit = '') {
+	if (!unit) {
+		unit = config.unit || 'px'
+	}
+	if (unit == 'rpx' && testNumber(String(value))) {
+		value = value * 2
 	}
 	value = String(value)
-	// 用uView内置验证规则中的number判断是否为数值
-	return test.number(value) ? `${value}${unit}` : value
+	// 用内置验证规则中的number判断是否为数值
+	return testNumber(value) ? `${value}${unit}` : value
 }
 
 /**
@@ -184,14 +220,14 @@ function addUnit(value = 'auto', unit = '') {
  * @param {object} obj 需要深度克隆的对象
  * @returns {*} 克隆后的对象或者原值（不是对象）
  */
-function deepClone(obj) {
+export function deepClone(obj) {
 	// 对常见的“非”值，直接返回原来值
 	if ([null, undefined, NaN, false].includes(obj)) return obj
 	if (typeof obj !== 'object' && typeof obj !== 'function') {
 		// 原始类型直接返回
 		return obj
 	}
-	const o = test.array(obj) ? [] : {}
+	const o = testArray(obj) ? [] : {}
 	for (const i in obj) {
 		if (obj.hasOwnProperty(i)) {
 			o[i] = typeof obj[i] === 'object' ? deepClone(obj[i]) : obj[i]
@@ -206,13 +242,15 @@ function deepClone(obj) {
  * @param {object} source 拷贝的来源对象
  * @returns {object|boolean} 深度合并后的对象或者false（入参有不是对象）
  */
-function deepMerge(target = {}, source = {}) {
-	target = deepClone(target)
+export function deepMerge(targetOrigin = {}, source = {}) {
+	let target = deepClone(targetOrigin)
 	if (typeof target !== 'object' || typeof source !== 'object') return false
 	for (const prop in source) {
 		if (!source.hasOwnProperty(prop)) continue
 		if (prop in target) {
-			if (typeof target[prop] !== 'object') {
+			if (source[prop] == null) {
+				target[prop] = source[prop]
+			}else if (typeof target[prop] !== 'object') {
 				target[prop] = source[prop]
 			} else if (typeof source[prop] !== 'object') {
 				target[prop] = source[prop]
@@ -227,12 +265,40 @@ function deepMerge(target = {}, source = {}) {
 	}
 	return target
 }
+/**
+ * @description JS对象深度合并
+ * @param {object} target 需要拷贝的对象
+ * @param {object} source 拷贝的来源对象
+ * @returns {object|boolean} 深度合并后的对象或者false（入参有不是对象）
+ */
+export function shallowMerge(target, source = {}) {
+	if (typeof target !== 'object' || typeof source !== 'object') return false
+	for (const prop in source) {
+		if (!source.hasOwnProperty(prop)) continue
+		if (prop in target) {
+			if (source[prop] == null) {
+				target[prop] = source[prop]
+			}else if (typeof target[prop] !== 'object') {
+				target[prop] = source[prop]
+			} else if (typeof source[prop] !== 'object') {
+				target[prop] = source[prop]
+			} else if (target[prop].concat && source[prop].concat) {
+				target[prop] = target[prop].concat(source[prop])
+			} else {
+				target[prop] = shallowMerge(target[prop], source[prop])
+			}
+		} else {
+			target[prop] = source[prop]
+		}
+	}
+	return target
+}
 
 /**
  * @description error提示
  * @param {*} err 错误内容
  */
-function error(err) {
+export function error(err) {
 	// 开发环境才提示，生产环境不会提示
 	if (process.env.NODE_ENV === 'development') {
 		console.error(`uView提示：${err}`)
@@ -244,7 +310,7 @@ function error(err) {
  * @param {array} array 需要打乱的数组
  * @returns {array} 打乱后的数组
  */
-function randomArray(array = []) {
+export function randomArray(array = []) {
 	// 原理是sort排序,Math.random()产生0<= x < 1之间的数,会导致x-0.05大于或者小于0
 	return array.sort(() => Math.random() - 0.5)
 }
@@ -281,7 +347,7 @@ if (!String.prototype.padStart) {
  * @param {String} fmt 格式化规则 yyyy:mm:dd|yyyy:mm|yyyy年mm月dd日|yyyy年mm月dd日 hh时MM分等,可自定义组合 默认yyyy-mm-dd
  * @returns {string} 返回格式化后的字符串
  */
- function timeFormat(dateTime = null, formatStr = 'yyyy-mm-dd') {
+export function timeFormat(dateTime = null, formatStr = 'yyyy-mm-dd') {
   let date
 	// 若传入时间为假值，则取当前时间
   if (!dateTime) {
@@ -335,7 +401,7 @@ if (!String.prototype.padStart) {
  * 如果为布尔值false，无论什么时间，都返回多久以前的格式
  * @returns {string} 转化后的内容
  */
-function timeFrom(timestamp = null, format = 'yyyy-mm-dd') {
+export function timeFrom(timestamp = null, format = 'yyyy-mm-dd') {
 	if (timestamp == null) timestamp = Number(new Date())
 	timestamp = parseInt(timestamp)
 	// 判断用户输入的时间戳是秒还是毫秒,一般前端js获取的时间戳是毫秒(13位),后端传过来的为秒(10位)
@@ -377,7 +443,7 @@ function timeFrom(timestamp = null, format = 'yyyy-mm-dd') {
  * @param String str 需要去除空格的字符串
  * @param String pos both(左右)|left|right|all 默认both
  */
-function trim(str, pos = 'both') {
+export function trim(str, pos = 'both') {
 	str = String(str)
 	if (pos == 'both') {
 		return str.replace(/^\s+|\s+$/g, '')
@@ -400,7 +466,7 @@ function trim(str, pos = 'both') {
  * @param {Boolean} isPrefix,是否自动加上"?"
  * @param {string} arrayFormat 规则 indices|brackets|repeat|comma
  */
-function queryParams(data = {}, isPrefix = true, arrayFormat = 'brackets') {
+export function queryParams(data = {}, isPrefix = true, arrayFormat = 'brackets') {
 	const prefix = isPrefix ? '?' : ''
 	const _result = []
 	if (['indices', 'brackets', 'repeat', 'comma'].indexOf(arrayFormat) == -1) arrayFormat = 'brackets'
@@ -457,7 +523,7 @@ function queryParams(data = {}, isPrefix = true, arrayFormat = 'brackets') {
  * @param {String} title 提示的内容，长度与 icon 取值有关。
  * @param {Number} duration 提示的延迟时间，单位毫秒，默认：2000
  */
-function toast(title, duration = 2000) {
+export function toast(title, duration = 2000) {
 	uni.showToast({
 		title: String(title),
 		icon: 'none',
@@ -470,7 +536,7 @@ function toast(title, duration = 2000) {
  * @param {String} type 主题名称,primary|info|error|warning|success
  * @param {boolean} fill 是否使用fill填充实体的图标
  */
-function type2icon(type = 'success', fill = false) {
+export function type2icon(type = 'success', fill = false) {
 	// 如果非预置值,默认为success
 	if (['primary', 'info', 'error', 'warning', 'success'].indexOf(type) == -1) type = 'success'
 	let iconName = ''
@@ -507,7 +573,7 @@ function type2icon(type = 'success', fill = false) {
  * @param {string} thousandsSeparator 千分位符号
  * @returns {string} 格式化后的数字
  */
-function priceFormat(number, decimals = 0, decimalPoint = '.', thousandsSeparator = ',') {
+export function priceFormat(number, decimals = 0, decimalPoint = '.', thousandsSeparator = ',') {
 	number = (`${number}`).replace(/[^0-9+-Ee.]/g, '')
 	const n = !isFinite(+number) ? 0 : +number
 	const prec = !isFinite(+decimals) ? 0 : Math.abs(decimals)
@@ -536,7 +602,7 @@ function priceFormat(number, decimals = 0, decimalPoint = '.', thousandsSeparato
  * @param {boolean} unit  提示: 如果是false 默认返回number
  * @return {string|number} 
  */
-function getDuration(value, unit = true) {
+export function getDuration(value, unit = true) {
 	const valueNum = parseInt(value)
 	if (unit) {
 		if (/s$/.test(value)) return value
@@ -551,7 +617,7 @@ function getDuration(value, unit = true) {
  * @description 日期的月或日补零操作
  * @param {String} value 需要补零的值
  */
-function padZero(value) {
+export function padZero(value) {
 	return `00${value}`.slice(-2)
 }
 
@@ -560,9 +626,9 @@ function padZero(value) {
  * @param {*} instance
  * @param {*} event
  */
-function formValidate(instance, event) {
-	const formItem = uni.$u.$parent.call(instance, 'u-form-item')
-	const form = uni.$u.$parent.call(instance, 'u-form')
+export function formValidate(instance, event) {
+	const formItem = $parent.call(instance, 'u-form-item')
+	const form = $parent.call(instance, 'u-form')
 	// 如果发生变化的input或者textarea等，其父组件中有u-form-item或者u-form等，就执行form的validate方法
 	// 同时将form-item的pros传递给form，让其进行精确对象验证
 	if (formItem && form) {
@@ -576,10 +642,10 @@ function formValidate(instance, event) {
  * @param {string} key 需要获取的属性字段
  * @returns {*}
  */
-function getProperty(obj, key) {
-	if (!obj) {
-		return
-	}
+export function getProperty(obj, key) {
+	if (typeof obj !== 'object' || null == obj) {
+        return ''
+    }
 	if (typeof key !== 'string' || key === '') {
 		return ''
 	}
@@ -603,8 +669,8 @@ function getProperty(obj, key) {
  * @param {string} key 需要设置的属性
  * @param {string} value 设置的值
  */
-function setProperty(obj, key, value) {
-	if (!obj) {
+export function setProperty(obj, key, value) {
+	if (typeof obj !== 'object' || null == obj) {
 		return
 	}
 	// 递归赋值
@@ -639,7 +705,7 @@ function setProperty(obj, key, value) {
 /**
  * @description 获取当前页面路径
  */
-function page() {
+export function page() {
 	const pages = getCurrentPages()
 	// 某些特殊情况下(比如页面进行redirectTo时的一些时机)，pages可能为空数组
 	return `/${pages[pages.length - 1].route || ''}`
@@ -648,31 +714,107 @@ function page() {
 /**
  * @description 获取当前路由栈实例数组
  */
-function pages() {
+export function pages() {
 	const pages = getCurrentPages()
 	return pages
 }
 
+export function getValueByPath(obj, path) {
+    // 将路径字符串按 '.' 分割成数组
+    const pathArr = path.split('.');
+    // 使用 reduce 方法从 obj 开始，逐级访问嵌套属性
+    return pathArr.reduce((acc, curr) => {
+        // 如果当前累加器（acc）是对象且包含当前键（curr），则返回该键对应的值
+        // 否则返回 undefined（表示路径不存在）
+        return acc && acc[curr] !== undefined ? acc[curr] : undefined;
+    }, obj);
+}
+
 /**
- * @description 修改uView内置属性值
- * @param {object} props 修改内置props属性
- * @param {object} config 修改内置config属性
- * @param {object} color 修改内置color属性
- * @param {object} zIndex 修改内置zIndex属性
+ * 生成同色系浅色背景色
+ * @param {string} textColor - 支持 #RGB、#RRGGBB、rgb()、rgba() 格式
+ * @param {number} [lightness=85] - 目标亮度百分比（默认85%）
+ * @returns {string} 十六进制颜色值
  */
-function setConfig({
-	props = {},
-	config = {},
-	color = {},
-	zIndex = {}
-}) {
-	const {
-		deepMerge,
-	} = uni.$u
-	uni.$u.config = deepMerge(uni.$u.config, config)
-	uni.$u.props = deepMerge(uni.$u.props, props)
-	uni.$u.color = deepMerge(uni.$u.color, color)
-	uni.$u.zIndex = deepMerge(uni.$u.zIndex, zIndex)
+export function genLightColor(textColor, lightness = 95) {
+	// 手动解析颜色值（避免使用document）
+	const rgb = parseColorWithoutDOM(textColor);
+	
+	// RGB转HSL色域
+	const hsl = rgbToHsl(rgb.r, rgb.g, rgb.b);
+	
+	// 生成浅色背景
+	const bgHsl = {
+	  h: hsl.h,
+	  s: hsl.s,
+	  l: Math.min(lightness, 95)
+	};
+	
+	return hslToHex(bgHsl.h, bgHsl.s, bgHsl.l);
+  }
+  
+  /* 手动解析颜色字符串（兼容uni-app环境） */
+  function parseColorWithoutDOM(colorStr) {
+	// 统一转小写处理
+	const str = colorStr.toLowerCase().trim();
+	
+	// 处理十六进制格式
+	if (str.startsWith('#')) {
+	  const hex = str.replace('#', '');
+	  const fullHex = hex.length === 3 ? 
+		hex.split('').map(c => c + c).join('') : hex;
+		
+	  return {
+		r: parseInt(fullHex.substring(0,2), 16),
+		g: parseInt(fullHex.substring(2,4), 16),
+		b: parseInt(fullHex.substring(4,6), 16)
+	  };
+	}
+	
+	// 处理rgb/rgba格式
+	const rgbMatch = str.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);
+	if (rgbMatch) {
+	  return {
+		r: +rgbMatch[1],
+		g: +rgbMatch[2],
+		b: +rgbMatch[3]
+	  };
+	}
+	
+	throw new Error('Invalid color format');
+  }
+
+// 辅助函数：RGB 转 HSL（色相、饱和度、亮度）
+function rgbToHsl(r, g, b) {
+ r /= 255, g /= 255, b /= 255;
+ const max = Math.max(r, g, b), min = Math.min(r, g, b);
+ let h, s, l = (max + min) / 2;
+
+ if (max === min) {
+   h = s = 0; // achromatic
+ } else {
+   const d = max - min;
+   s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+   switch (max) {
+	 case r: h = (g - b) / d + (g < b ? 6 : 0); break;
+	 case g: h = (b - r) / d + 2; break;
+	 case b: h = (r - g) / d + 4; break;
+   }
+   h = (h * 60).toFixed(1);
+ }
+ return { h: +h, s: +(s * 100).toFixed(1), l: +(l * 100).toFixed(1) };
+}
+
+// 辅助函数：HSL 转十六进制
+function hslToHex(h, s, l) {
+ l /= 100;
+ const a = s * Math.min(l, 1 - l) / 100;
+ const f = n => {
+   const k = (n + h / 30) % 12;
+   const color = l - a * Math.max(Math.min(k - 3, 9 - k, 1), -1);
+   return Math.round(255 * color).toString(16).padStart(2, '0');
+ };
+ return `#${f(0)}${f(8)}${f(4)}`;
 }
 
 export default {
@@ -681,6 +823,7 @@ export default {
 	sleep,
 	os,
 	sys,
+	getWindowInfo,
 	random,
 	guid,
 	$parent,
@@ -688,6 +831,7 @@ export default {
 	addUnit,
 	deepClone,
 	deepMerge,
+    shallowMerge,
 	error,
 	randomArray,
 	timeFormat,
@@ -704,5 +848,6 @@ export default {
 	setProperty,
 	page,
 	pages,
-	setConfig
+	getValueByPath,
+	genLightColor
 }