y-admin-ui 6.1.7 → 6.1.8

package/lib/utils/core.ts

@@ -4,23 +4,46 @@
  * @param callback 回调
  * @param childrenField children字段名
  */
-export function eachTreeData(
-    data: any[],
-    callback: Function,
-    childrenField = 'children',
-    parent: any = ''
-  ) {
-    if (data) {
-      data.forEach((d, i) => {
-        if (
-          callback &&
-          callback(d, i, parent) !== false &&
-          d[childrenField]?.length
-        ) {
-          eachTreeData(d[childrenField], callback, childrenField, d);
-        }
-      });
-    }
+export function eachTreeData(data: any[], callback: Function, childrenField = 'children', parent: any = '') {
+	if (data) {
+		data.forEach((d, i) => {
+			if (callback && callback(d, i, parent) !== false && d[childrenField]?.length) {
+				eachTreeData(d[childrenField], callback, childrenField, d);
+			}
+		});
+	}
+}
+
+/**
+ * 遍历每一项，并可修改节点
+ * @param data 数据数组
+ * @param callback 回调，可修改节点
+ * @param options 配置选项
+ *   - childrenField: children 字段名，默认 'children'
+ *   - mutate: 是否直接修改原始对象，默认 false
+ * @returns 返回处理后的数组（根据 mutate 决定是原对象还是新对象）
+ */
+export function eachTreeItemData(data: any[], callback: (node: any) => void, options: { childrenField?: string; mutate?: boolean } = {}) {
+	const { childrenField = 'children', mutate = false } = options;
+
+	const result: any[] = [];
+
+	data.forEach((item) => {
+		// 决定是克隆还是直接修改原始对象
+		const node = mutate ? item : { ...item };
+
+		// 执行回调，可修改 node
+		callback(node);
+
+		// 如果有 children，递归处理
+		if (node[childrenField]?.length) {
+			node[childrenField] = eachTreeItemData(node[childrenField], callback, options);
+		}
+
+		result.push(node);
+	});
+
+	return result;
 }
 
 /**
@@ -29,17 +52,17 @@ export function eachTreeData(
  * @param radix 基数
  */
 export function uuid(length = 32, radix: any) {
-    const num = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
-    let result = '';
-    for (let i = 0; i < length; i++) {
-      result += num.charAt(Math.floor(Math.random() * (radix || num.length)));
-    }
-    return result;
+	const num = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+	let result = '';
+	for (let i = 0; i < length; i++) {
+		result += num.charAt(Math.floor(Math.random() * (radix || num.length)));
+	}
+	return result;
 }
 
 /**
  * 获取屏幕宽度
  */
 export function screenWidth() {
-  return document.documentElement.clientWidth || document.body.clientWidth;
-}
+	return document.documentElement.clientWidth || document.body.clientWidth;
+}

package/lib/utils/data.ts

@@ -0,0 +1,63 @@
+// 申明 数组
+declare type EmptyArrayType<T = any> = T[];
+// 申明 对象
+declare type EmptyObjectType<T = any> = {
+	[key: string]: T;
+};
+
+/**
+ * 对象深克隆
+ * @param obj 源对象
+ * @returns 克隆后的对象
+ */
+export function deepClone(obj: EmptyObjectType) {
+	let newObj: EmptyObjectType;
+	try {
+		newObj = obj.push ? [] : {};
+	} catch (error) {
+		newObj = {};
+	}
+	for (let attr in obj) {
+		if (obj[attr] && typeof obj[attr] === 'object') {
+			newObj[attr] = deepClone(obj[attr]);
+		} else {
+			newObj[attr] = obj[attr];
+		}
+	}
+	return newObj;
+}
+
+/**
+ * 判断是否是移动端
+ */
+export function isMobile() {
+	if (
+		navigator.userAgent.match(
+			/('phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone')/i
+		)
+	) {
+		return true;
+	} else {
+		return false;
+	}
+}
+
+/**
+ * 判断数组对象中所有属性是否为空，为空则删除当前行对象
+ * @param list 数组对象
+ * @returns 删除空值后的数组对象
+ */
+export function handleEmpty(list: EmptyArrayType) {
+	const arr = [];
+	for (const i in list) {
+		const d = [];
+		for (const j in list[i]) {
+			d.push(list[i][j]);
+		}
+		const leng = d.filter((item) => item === '').length;
+		if (leng !== d.length) {
+			arr.push(list[i]);
+		}
+	}
+	return arr;
+}

package/lib/utils/element/message.ts

@@ -0,0 +1,98 @@
+/**
+ * 消息提示，二次封装
+ */
+import { ElMessage, ElLoading, type MessageOptions } from 'element-plus';
+
+/**
+ * 通用消息封装
+ * 用于统一项目内消息提示风格
+ */
+type MessageType = 'primary' | 'success' | 'warning' | 'info' | 'error';
+
+/**
+ * MessageExtensionOptions 拓展消息提示参数
+ */
+export interface MessageExtensionOptions extends MessageOptions {
+	// 是否显示遮罩
+	mask: boolean;
+	// 是否显示边框-清新模式
+	border: boolean;
+	// 是否loading模式
+	loading: boolean;
+}
+
+/**
+ * 默认参数
+ * @param mask 是否显示遮罩(额外拓展)
+ * @param border 是否显示边框-清新模式(额外拓展)
+ * @param loading 是否loading模式(额外拓展)
+ * @param placement 消息放置位置(原先element就有，新增 'center' 居中)
+ */
+const defaultOptions: MessageExtensionOptions = {
+	mask: false,
+	border: false,
+	loading: false,
+	customClass: '',
+	dangerouslyUseHTMLString: false,
+	duration: 3000,
+	icon: undefined,
+	message: '这是一条提示内容',
+	onClose: undefined,
+	showClose: false,
+	type: 'primary' as MessageType,
+	plain: false,
+	offset: 16,
+	placement: 'top',
+	zIndex: 0,
+	grouping: false,
+	repeatNum: 1,
+};
+
+function message(options: MessageExtensionOptions) {
+	const merged = { ...defaultOptions, ...options };
+	/** 是否要边框风格 */
+	if (merged.border) {
+		merged.customClass = [merged.customClass, 'y-message-border'].filter(Boolean).join(' ');
+	}
+	/** 是否要loading风格 */
+	if (merged.loading) {
+		merged.customClass = [merged.customClass, 'y-message-loading'].filter(Boolean).join(' ');
+	}
+	/** 是否要遮罩层 */
+	let loadingInstance: ReturnType<typeof ElLoading.service> | null = null;
+	if (merged.mask) {
+		loadingInstance = ElLoading.service({
+			lock: true,
+			background: 'rgba(0, 0, 0, 0.3)',
+			spinner: '1', // 不显示默认加载图标
+			text: '', // 不显示文字
+		});
+	}
+	/** 位置 */
+	if ((merged.placement as string) === 'center') {
+		merged.customClass = [merged.customClass, 'y-center'].filter(Boolean).join(' ');
+	}
+	// 创建消息实例
+	const msg = ElMessage({
+		...merged,
+		onClose: () => {
+			// 先执行用户自定义的 onClose
+			merged.onClose?.();
+			// 再关闭遮罩层
+			if (loadingInstance) {
+				loadingInstance.close();
+				loadingInstance = null;
+			}
+		},
+	});
+
+	return msg;
+}
+
+export const Ymessage = Object.assign(message, {
+	primary: (options: MessageExtensionOptions) => message(options),
+	success: (options: MessageExtensionOptions) => message(options),
+	warning: (options: MessageExtensionOptions) => message(options),
+	info: (options: MessageExtensionOptions) => message(options),
+	error: (options: MessageExtensionOptions) => message(options),
+});

package/lib/utils/getStyleSheets.ts

@@ -0,0 +1,101 @@
+import { nextTick } from 'vue';
+import * as svg from '@element-plus/icons-vue';
+
+// 获取阿里字体图标
+const getAlicdnIconfont = () => {
+	return new Promise((resolve, reject) => {
+		nextTick(() => {
+			const styles: any = document.styleSheets;
+			let sheetsList = [] as any;
+			let sheetsIconList = [] as any;
+			for (let i = 0; i < styles.length; i++) {
+				if (styles[i].href && styles[i].href.indexOf('at.alicdn.com') > -1) {
+					sheetsList.push(styles[i]);
+				}
+			}
+			for (let i = 0; i < sheetsList.length; i++) {
+				for (let j = 0; j < sheetsList[i].cssRules.length; j++) {
+					if (sheetsList[i].cssRules[j].selectorText && sheetsList[i].cssRules[j].selectorText.indexOf('.icon-') > -1) {
+						sheetsIconList.push(
+							`${sheetsList[i].cssRules[j].selectorText.substring(1, sheetsList[i].cssRules[j].selectorText.length).replace(/\:\:before/gi, '')}`
+						);
+					}
+				}
+			}
+			if (sheetsIconList.length > 0) resolve(sheetsIconList);
+			else reject('未获取到值，请刷新重试');
+		});
+	});
+};
+
+// 初始化获取 css 样式，获取 element plus 自带 svg 图标，增加了 ele- 前缀，使用时：ele-Aim
+const getElementPlusIconfont = () => {
+	return new Promise((resolve, reject) => {
+		nextTick(() => {
+			const icons = svg as any;
+			const sheetsIconList = [] as any;
+			for (const i in icons) {
+				sheetsIconList.push(`ele-${icons[i].name}`);
+			}
+			if (sheetsIconList.length > 0) resolve(sheetsIconList);
+			else reject('未获取到值，请刷新重试');
+		});
+	});
+};
+
+// 初始化获取 css 样式，这里使用 fontawesome 的图标
+const getAwesomeIconfont = () => {
+	return new Promise((resolve, reject) => {
+		nextTick(() => {
+			const styles: any = document.styleSheets;
+			let sheetsList = [] as any;
+			let sheetsIconList = [] as any;
+			for (let i = 0; i < styles.length; i++) {
+				if (styles[i].href && styles[i].href.indexOf('https://cdn.jsdelivr.net') > -1) {
+					sheetsList.push(styles[i]);
+				}
+			}
+			for (let i = 0; i < sheetsList.length; i++) {
+				for (let j = 0; j < sheetsList[i].cssRules.length; j++) {
+					if (
+						sheetsList[i].cssRules[j].selectorText &&
+						sheetsList[i].cssRules[j].selectorText.indexOf('.fa-') === 0 &&
+						sheetsList[i].cssRules[j].selectorText.indexOf(',') === -1
+					) {
+						if (/::before/.test(sheetsList[i].cssRules[j].selectorText)) {
+							sheetsIconList.push(
+								`${sheetsList[i].cssRules[j].selectorText.substring(1, sheetsList[i].cssRules[j].selectorText.length).replace(/\:\:before/gi, '')}`
+							);
+						}
+					}
+				}
+			}
+			if (sheetsIconList.length > 0) resolve(sheetsIconList.reverse());
+			else reject('未获取到值，请刷新重试');
+		});
+	});
+};
+
+/**
+ * 获取字体图标 `document.styleSheets`
+ * @method ali 获取阿里字体图标 `<i class="iconfont 图标类名"></i>`
+ * @method ele 获取 element plus 自带图标 `<i class="图标类名"></i>`
+ * @method ali 获取 fontawesome 的图标 `<i class="fa 图标类名"></i>`
+ */
+const initIconfont = {
+	// iconfont
+	ali: () => {
+		return getAlicdnIconfont();
+	},
+	// element plus
+	ele: () => {
+		return getElementPlusIconfont();
+	},
+	// fontawesome
+	awe: () => {
+		return getAwesomeIconfont();
+	},
+};
+
+// 导出方法
+export default initIconfont;

package/lib/utils/other.ts

@@ -0,0 +1,32 @@
+import { defineAsyncComponent } from 'vue';
+import type { App } from 'vue';
+import * as svg from '@element-plus/icons-vue';
+
+// 引入组件
+const SvgIcon = defineAsyncComponent(() => import('./../y-svg-icon/index.vue'));
+
+/**
+ * 导出全局注册 element plus svg 图标
+ * @param app vue 实例
+ * @description 使用：https://element-plus.gitee.io/zh-CN/component/icon.html
+ */
+export function elSvg(app: App) {
+	const icons = svg as any;
+	for (const i in icons) {
+		app.component(`ele-${icons[i].name}`, icons[i]);
+	}
+	app.component('SvgIcon', SvgIcon);
+}
+
+/**
+ * 统一批量导出
+ * @method elSvg 导出全局注册 element plus svg 图标
+ */
+const other = {
+	elSvg: (app: App) => {
+		elSvg(app);
+	},
+};
+
+// 统一批量导出
+export default other;