common-utils-kit 1.1.2 → 1.1.4

package/README.md

@@ -7,12 +7,49 @@
 ```
 # 安装
 npm i common-utils-kit
-# 引入
-import {test,format,tool} from "common-utils-kit/src/test";
-# 使用
-test //验证数据类型 例：test.number(1)
-format  // 格式化数据 例：
-tool //工具函数
-files  //文件下载
-```
 
+# 使用方式一（局部引入）
+import commonUtilsKit from "common-utils-kit";
+例：验证是否为数字 commonUtilsKit.test.number(1)
+
+# 使用方式二（全局引入）
+import commonUtilsKit from "common-utils-kit";
+Vue.prototype.$test = commonUtilsKit.test;
+例：验证是否为数字 this.$test.number(1)
+```
+### directives(指令)
+ 1. debounce(按钮或输入框防抖)
+ 2. inputDebounce(输入框防抖)
+ 3. btnDebounce(按钮防抖)
+ 4. btnThrottle(按钮节流)
+ 5. relativeTime(相对时间)
+ 6. replace(输入框字符串替换)
+ 7. elDragDialog(拖拽dialog)
+### files(文件)
+ 1. downloadBase64File(base64文件下载)
+ 2. downloadFiles(文件http地址下载)
+### format(格式化数据)
+ 1. unrepeated(数组对象去重)
+ 2. treeToFlat(树形结构拍平为一维数组)
+ 3. flatToTree(一维数组递归成为树形结构)
+ 4. recursionFunction(递归重构子集数据)
+ 5. filterData(将switch case语句转为数组对象)
+ 6. dateDiff(计算日期差值(单位：天))
+ 7. getNowDate(获取当前日期)
+ 8. setFormColumnsData(设置自定义表单列数据)
+### test(验证)
+ 1. hasValue(是否有值,可验证指定类型)
+ 2. valueType(返回数据类型)
+ 3. emai(是否为邮箱)
+ 4. mobile(是否为手机号)
+ 5. url(是否为url)
+ 6. idCard(是否为身份证号)
+ 7. carNo(是否为车牌号)
+ 8. chinese(是否为中文)
+ 9. letter(是否为字母)
+ 10. landline(是否为座机)
+ 11. code(是否为6位数短信验证码)
+### tool(工具函数)
+ 1. debounce(防抖)
+ 2. throttle(节流)
+ 3. sleep(睡眠阻塞延时)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "common-utils-kit",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "",
   "main": "index.js",
   "type": "module",

package/src/format.js

@@ -73,13 +73,13 @@ export function unrepeated(data, parameter) {
  * console.log(flatArray);
  * // 输出：[ { id: 1, label: 'parent 1' },{ id: 2, label: 'child 1' }, { id: 3, label: 'child 2' }, { id: 4, label: 'parent 2' },{ id: 5, label: 'child 3' },{ id: 6, label: 'child 4' }]
  */
-export function treeToFlat(previous, bind = 'children') {
+export function treeToFlat(previous=[], bind = 'children') {
   const result = []
   previous.forEach(item => {
     const clonedItem = { ...item };
     if (clonedItem[bind]) {
       result.push(clonedItem)
-      if (clonedItem[bind].length > 0) {
+      if (Array.isArray(previous) && clonedItem[bind].length > 0) {
         result.push(...treeToFlat(clonedItem[bind]))
       }
     } else {
@@ -159,13 +159,13 @@ export function flatToTree(flatArray, rootValue = null, bind = "pid") {
  * const processedTree = recursionFunction(treeData, processFunction);
  */
 export function recursionFunction(data, processFunction, bind = 'children') {
-  function internalRecursion(previous, initial) {
+  function internalRecursion(previous=[], initial) {
     return previous.map((element, i) => {
       const menus = initial[i] ? processFunction(initial[i]) : {};
       const children = element[bind] && Array.isArray(element[bind]) && element[bind].length > 0
         ? internalRecursion(element[bind], initial[i][bind])
         : [];
-      return { [bind]: children, ...menus };
+      return { ...menus,[bind]: children };
     });
   }
   return internalRecursion(data, data);
@@ -203,3 +203,46 @@ export function filterData(filterMethod) {
   }
   return list;
 }
+/**
+ * @description 计算时间差(单位：天)
+ * @param {Date} startDate 开始时间 默认当前时间
+ * @param {Date} endDate 结束时间 默认当前时间
+ * @returns {number} 时间差（天）
+ * @example DateDiff(开始时间,结束时间)
+ */
+export function dateDiff(startDate = new Date(), endDate = new Date()) {
+  const MS_PER_DAY = 24 * 60 * 60 * 1000; // 一天的毫秒数
+  const startTimestamp = new Date(startDate).setHours(0, 0, 0, 0);
+  const endTimestamp = new Date(endDate).setHours(0, 0, 0, 0);
+  const timeDiff = endTimestamp - startTimestamp;
+  const daysDiff = Math.floor(timeDiff / MS_PER_DAY);
+  return daysDiff;
+}
+/**
+ * @description 获取当前时间（年月日）
+ * @returns {string} 当前时间字符串，格式为 "YYYY-MM-DD"
+ * @example getNowDate()
+ */
+export function getNowDate() {
+  const timeOne = new Date();
+  const year = timeOne.getFullYear();
+  const month = String(timeOne.getMonth() + 1).padStart(2, '0');
+  const day = String(timeOne.getDate()).padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}
+
+/**
+ * @description form的下拉框  级联选择器等数据赋值
+ * @param {Array} columns - form的columns数据
+ * @param {String} targetLabel - 需要赋值的columns[i]的label
+ * @param {Array} newData - 想要赋值的数据
+ * @returns {Array} 包含data的Columns数据
+ * @example  setFormColumnsData(this.columns, '下单医生', result.data)
+ */
+export function setFormColumnsData(columns, targetLabel, newData) {
+  var targetIndex = columns.findIndex(item => item.label === targetLabel);
+  if (targetIndex !== -1) {
+    columns[targetIndex].data = newData;
+  }
+  return columns;
+}

package/src/test.js

@@ -19,17 +19,15 @@ export function hasValue(value, type) {
     case 'undefined':
       return false;
     case 'string':
-      return value.replace(/(^[ \t\n\r]*)|([ \t\n\r]*$)/g, '').length > 0;
+      return (type === 'string' || !type) && value.trim().length > 0;
     case 'boolean':
-      return !!value;
+      return (type === 'boolean' || !type) && !!value;
     case 'number':
-      return (type === 'number' || value !== 0) && !isNaN(value);
+      return (type === 'number' || !type) && ((type === 'number' || value !== 0) && !isNaN(value));
     case 'object':
-      if (value === null || value.length === 0) return false;
-      for (const i in value) {
-        return true; // 只要对象有属性就认为有值
-      }
-      return false;
+      if (value === null) return false;
+      if (Array.isArray(value)) return (type === 'array' || !type) && value.length > 0;
+      return (type === 'object' || !type) && Object.keys(value).length > 0;
   }
   return false;
 }
@@ -49,21 +47,17 @@ export function hasValue(value, type) {
  * console.log(valueType(null)); // 输出: 'null'
  */
 export function valueType(value) {
-  switch (typeof value) {
+  const type = typeof value;
+  switch (type) {
     case 'string':
-      return 'string';
     case 'number':
-      return 'number';
     case 'boolean':
-      return 'boolean';
     case 'function':
-      return 'function';
+      return type;
     case 'object':
       if (value === null) {
         return 'null';
-      } else if (typeof Array.isArray === 'function' && Array.isArray(value)) {
-        return 'array';
-      } else if (Object.prototype.toString.call(value) === '[object Array]') {
+      } else if (Array.isArray(value)) {
         return 'array';
       } else if (Object.prototype.toString.call(value) === '[object Object]') {
         return 'object';
@@ -94,44 +88,6 @@ export function url(value) {
     .test(value)
 }
 
-/**
- * 验证日期格式
- */
-export function date(value) {
-  if (!value) return false
-  // 判断是否数值或者字符串数值(意味着为时间戳)，转为数值，否则new Date无法识别字符串时间戳
-  if (number(value)) value = +value
-  return !/Invalid|NaN/.test(new Date(value).toString())
-}
-
-/**
- * 验证ISO类型的日期格式
- */
-export function dateISO(value) {
-  return /^\d{4}[\/\-](0?[1-9]|1[012])[\/\-](0?[1-9]|[12][0-9]|3[01])$/.test(value)
-}
-
-/**
- * 验证十进制数字
- */
-export function number(value) {
-  return /^[\+-]?(\d+\.?\d*|\.\d+|\d\.\d+e\+\d+)$/.test(value)
-}
-
-/**
- * 验证字符串
- */
-export function string(value) {
-  return typeof value === 'string'
-}
-
-/**
- * 验证整数
- */
-export function digits(value) {
-  return /^\d+$/.test(value)
-}
-
 /**
  * 验证身份证号码
  */
@@ -180,36 +136,6 @@ export function letter(value) {
   return /^[a-zA-Z]*$/.test(value)
 }
 
-/**
- * 只能是字母或者数字
- */
-export function enOrNum(value) {
-  // 英文或者数字
-  const reg = /^[0-9a-zA-Z]*$/g
-  return reg.test(value)
-}
-
-/**
- * 验证是否包含某个值
- */
-export function contains(value, param) {
-  return value.indexOf(param) >= 0
-}
-
-/**
- * 验证一个值范围[min, max]
- */
-export function range(value, param) {
-  return value >= param[0] && value <= param[1]
-}
-
-/**
- * 验证一个长度范围[min, max]
- */
-export function rangeLength(value, param) {
-  return value.length >= param[0] && value.length <= param[1]
-}
-
 /**
  * 是否固定电话
  */
@@ -218,68 +144,6 @@ export function landline(value) {
   return reg.test(value)
 }
 
-/**
- * 判断是否为空
- */
-export function empty(value) {
-  console.log(' ', (isNaN(value)))
-  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 (value === 0 || isNaN(value)) return true
-      break
-    case 'object':
-      if (value === null || value.length === 0) return true
-      for (const i in value) {
-        return false
-      }
-      return true
-  }
-  return false
-}
-
-/**
- * 是否json字符串
- */
-export function jsonString(value) {
-  if (typeof value === 'string') {
-    try {
-      const obj = JSON.parse(value)
-      if (typeof obj === 'object' && obj) {
-        return true
-      }
-      return false
-    } catch (e) {
-      return false
-    }
-  }
-  return false
-}
-
-/**
- * 是否数组
- */
-export function array(value) {
-  if (typeof Array.isArray === 'function') {
-    return Array.isArray(value)
-  }
-  return Object.prototype.toString.call(value) === '[object Array]'
-}
-
-/**
- * 是否对象
- */
-export function object(value) {
-  return Object.prototype.toString.call(value) === '[object Object]'
-}
-
 /**
  * 是否短信验证码
  */
@@ -287,45 +151,3 @@ export function code(value, len = 6) {
   return new RegExp(`^\\d{${len}}$`).test(value)
 }
 
-/**
- * 是否函数方法
- * @param {Object} value
- */
-export function func(value) {
-  return typeof value === 'function'
-}
-
-/**
- * 是否promise对象
- * @param {Object} value
- */
-export function promise(value) {
-  return object(value) && func(value.then) && func(value.catch)
-}
-
-/** 是否图片格式
- * @param {Object} value
- */
-export function image(value) {
-  const newValue = value.split('?')[0]
-  const IMAGE_REGEXP = /\.(jpeg|jpg|gif|png|svg|webp|jfif|bmp|dpg)/i
-  return IMAGE_REGEXP.test(newValue)
-}
-
-/**
- * 是否视频格式
- * @param {Object} value
- */
-export function video(value) {
-  const VIDEO_REGEXP = /\.(mp4|mpg|mpeg|dat|asf|avi|rm|rmvb|mov|wmv|flv|mkv|m3u8)/i
-  return VIDEO_REGEXP.test(value)
-}
-
-/**
- * 是否为正则对象
- * @param {Object}
- * @return {Boolean}
- */
-export function regExp(o) {
-  return o && Object.prototype.toString.call(o) === '[object RegExp]'
-}