@fsystem/fswt-ui-tools 0.3.3 → 0.3.4

package/dist/types/tools/Array.d.ts

@@ -1,96 +1,122 @@
-/** 数组中查找子数组
- * @param {Array} arr  数组
- * @param {Array} subarr  要查找的子数组
- * @param {Number} from_index  查找的起始位置,默认为0
- * @returns {Number} 找到的index
- */
-export function find_csa(arr: any[], subarr: any[], from_index: number): number;
-/** Fsy 20200614 对数组进行分页
- * @param {number} pageNo    第几页
- * @param {number} pageSize  分页每页的大小
- * @param {array} array 需要分页的数组
- * @returns {array} 当前页的数组
- */
-export function pagination(pageNo: number, pageSize: number, array: any): any;
-/** 对对象数组根据属性名进行去重
- * @param {Array} arr 对象数组
- * @param {Array} keyArray 属性名数组
- * @returns {Array} 去重后的数组
- */
-export function uniqueObjectByKey(arr: any[], keyArray: any[]): any[];
-/** Fsy 20220608 对数组进行排序，从小到大，支持数字、英文、中文混合字符串
- * @param {any} _a
- * @param {any} _b
- */
-export function mixSort(_a: any, _b: any): any;
-/** Fsy 20200614 根据对象数组中对象的某个属性的大小对整个数组进行排序
- * @param {array} array 对象数组
- * @param {string} key  要比较的某个对象属性
- * @param {number} type 0：升序 1：降序
- * @returns {array} 排序后的对象数组
- */
-export function sortByKey(array: any, key: string, type: number): any;
-/** Fsy 20200902 对象数组去重
- * @param {array} array
- * @returns {array} 去重后的对象数组
- */
-export function uniqueObject(array: any): any;
-/** 删除对象数组中的某一个对象
- * @param {array} array
- * @returns {object} 需要删除的对象
- */
-export function deteleObject(_arr: any, _obj: any): object;
-/**
- * 遍历一棵tree查找当前属性值所在的对象node
- * @param {Array} data 被查找对象数据
- * @param {String} findStr 查找属性名
- * @param {String} curVal 查找的属性值
- * @return {Object}
- */
-export function findNode(data: any[], findStr: string, curVal: string): Object;
-/**
- * 去重
- */
-export function unique(arr: any): any[];
-/**
- * 求两个集合的并集
- */
-export function union(a: any, b: any): any;
-/**
- * 求两个集合的交集
- */
-export function intersect(a: any, b: any): any;
-/**
- * 删除其中一个元素
- */
-export function remove(arr: any, ele: any): any;
-/**
- * 判断a数组中的值是否包含b数组中的值
- */
-export function getArrRepeat(a: any, b: any): boolean;
-/**
- * 最大值
- */
-export function max(arr: any): number;
-/**
- * 最小值
- */
-export function min(arr: any): number;
-/**
- * 求和
- */
-export function sum(arr: any): any;
-/**
- * 平均值
- */
-export function average(arr: any): number;
-/**
- * 洗牌算法随机
- * @param {*} arr
- */
-export function shuffle(arr: any): any[];
-/**
- * 整数千分位加逗号 1234567 -> 1,234,567
- * @param {number | string} num
- */
-export function toThousands(num: number | string): string;
+/** 数组中查找子数组
+ * @param {Array} arr  数组
+ * @param {Array} subarr  要查找的子数组
+ * @param {Number} from_index  查找的起始位置,默认为0
+ * @returns {Number} 找到的index
+ */
+export function find_csa(arr: any[], subarr: any[], from_index: number): number;
+/** Fsy 20200614 对数组进行分页
+ * @param {number} pageNo    第几页
+ * @param {number} pageSize  分页每页的大小
+ * @param {array} array 需要分页的数组
+ * @returns {array} 当前页的数组
+ */
+export function pagination(pageNo: number, pageSize: number, array: any): any;
+/** 对对象数组根据属性名进行去重
+ * @param {Array} arr 对象数组
+ * @param {Array} keyArray 属性名数组
+ * @returns {Array} 去重后的数组
+ */
+export function uniqueObjectByKey(arr: any[], keyArray: any[]): any[];
+/** Fsy 20220608 对数组进行排序，从小到大，支持数字、英文、中文混合字符串
+ * @param {any} _a
+ * @param {any} _b
+ */
+export function mixSort(_a: any, _b: any): any;
+/** Fsy 20200614 根据对象数组中对象的某个属性的大小对整个数组进行排序
+ * @param {array} array 对象数组
+ * @param {string} key  要比较的某个对象属性
+ * @param {number} type 0：升序 1：降序
+ * @returns {array} 排序后的对象数组
+ */
+export function sortByKey(array: any, key: string, type: number): any;
+/** Fsy 20200902 对象数组去重
+ * @param {array} array
+ * @returns {array} 去重后的对象数组
+ */
+export function uniqueObject(array: any): any;
+/** 删除对象数组中的某一个对象
+ * @param {array} array
+ * @returns {object} 需要删除的对象
+ */
+export function deteleObject(_arr: any, _obj: any): object;
+/**
+ * 遍历一棵tree查找当前属性值所在的对象node
+ * @param {Array} data 被查找对象数据
+ * @param {String} findStr 查找属性名
+ * @param {String} curVal 查找的属性值
+ * @return {Object}
+ */
+export function findNode(data: any[], findStr: string, curVal: string): Object;
+/**
+ * 去重
+ */
+export function unique(arr: any): any[];
+/**
+ * 求两个集合的并集
+ */
+export function union(a: any, b: any): any;
+/**
+ * 求两个集合的交集
+ */
+export function intersect(a: any, b: any): any;
+/**
+ * 删除其中一个元素
+ */
+export function remove(arr: any, ele: any): any;
+/**
+ * 判断a数组中的值是否包含b数组中的值
+ */
+export function getArrRepeat(a: any, b: any): boolean;
+/**
+ * 最大值
+ */
+export function max(arr: any): number;
+/**
+ * 最小值
+ */
+export function min(arr: any): number;
+/**
+ * 求和
+ */
+export function sum(arr: any): any;
+/**
+ * 平均值
+ */
+export function average(arr: any): number;
+/**
+ * 洗牌算法随机
+ * @param {*} arr
+ */
+export function shuffle(arr: any): any[];
+/**
+ * 将平铺数组数据转为树形结构，数组元素必须有tree-path属性，tree-path必须是字符串，且以treePathSplit倒序分隔
+ * @param {*} root 根节点
+ * @param {Array} data 平铺的array数据
+ * @param {{
+ *  treeNameKey: string,
+ *  childrenKey: string,
+ *  treePathKey: string,
+ *  treePathSplit: string
+ * }} opt 配置项
+ * @param {(currentName, rawNode, level, parent)=>object} createNodeFn 创建节点的回调函数
+ * @param {(node, currentName, rawNode, level, parent)=>object} setNodeFn 设置节点的回调函数
+ * @returns {object} 返回树形结构的根节点
+ */
+export function buildTree(root: any, data: any[], opt: {
+    treeNameKey: string;
+    childrenKey: string;
+    treePathKey: string;
+    treePathSplit: string;
+} | undefined, createNodeFn: (currentName: any, rawNode: any, level: any, parent: any) => object, setNodeFn: (node: any, currentName: any, rawNode: any, level: any, parent: any) => object): object;
+/**
+ * 设置对象数组内指定页范文内对象的属性项
+ * @param {Array} list 操作的数组
+ * @param {string} key 设置的属性key
+ * @param {number} start 开始页
+ * @param {number} end 结束页
+ * @param {number} pageSize 页大小
+ * @param {{(element:object, idx:number)=>any}} fn 回调函数
+ * @returns {Array} 返回设置指定属性后的数组
+ */
+export function setObejctArrayProperty(list: any[], key: string, start: number, end: number, pageSize: number, fn: (element: object, idx: number) => any): any[];

package/dist/types/tools/Color.d.ts

@@ -1,17 +1,17 @@
-/**
- * 16进制颜色转RGB\RGBA字符串
- * @param  {String} val 16进制颜色值
- * @param  {Number} opa 不透明度，取值0~1
- * @return {String}     转换后的RGB或RGBA颜色值
- */
-export function colorToRGBA(val: string, opa: number): string;
-/**
- * 获取2个16进制颜色的渐变色
- * @param  {String} startColor 16进制颜色值
- * @param  {String} endColor 16进制颜色值
- * @param  {String} step 渐变步数
- * @return {Array} 渐变16进制颜色数组
- */
-export function GetGradientColor(startColor: string, endColor: string, step: string): any[];
-export function colorRgb(sColor: any): any;
-export function colorHex(rgb: any): any;
+/**
+ * 16进制颜色转RGB\RGBA字符串
+ * @param  {String} val 16进制颜色值
+ * @param  {Number} opa 不透明度，取值0~1
+ * @return {String}     转换后的RGB或RGBA颜色值
+ */
+export function colorToRGBA(val: string, opa: number): string;
+/**
+ * 获取2个16进制颜色的渐变色
+ * @param  {String} startColor 16进制颜色值
+ * @param  {String} endColor 16进制颜色值
+ * @param  {String} step 渐变步数
+ * @return {Array} 渐变16进制颜色数组
+ */
+export function GetGradientColor(startColor: string, endColor: string, step: string): any[];
+export function colorRgb(sColor: any): any;
+export function colorHex(rgb: any): any;

package/dist/types/tools/Date.d.ts

@@ -1,85 +1,85 @@
-/**
- * 取字符日期数组中最小和最大的日期
- * @param {array} strDates 字符日期数组
- * @returns {array} [0]最小和[1]最大的日期
- */
-export function getMinMaxDate(strDates: array): array;
-/** Fsy 20200614 比较两个日期的大小
- * @param {date} dateTime1
- * @param {date} dateTime2
- * @returns {Boolean} dateTime1>dateTime2:true else:false
- */
-export function compareDate(dateTime1: date, dateTime2: date): boolean;
-/**
- * 解析时间到格式化字符串
- * parseTime('2012/1/19','{y}年{m}月{d}日 {h}时{i}分{s}秒')
- * @param {(Object|string|number)} time
- * @param {string} cFormat
- * @returns {string | null}
- */
-export function parseTime(time: (Object | string | number), cFormat: string, ...args: any[]): string | null;
-/** 格式化时间显示
- * @param {number} time
- * @param {string} option
- * @returns {string}
- */
-export function formatTime(time: number, option: string): string;
-/**
- * 判断闰年
- * @param date Date日期对象
- * @return boolean true 或false
- */
-export function isLeapYear(date: any): boolean;
-/**
- * 格式化时间 将 Date 转化为指定格式的String
- * @param {Date} date 要转换的数据
- * @param {String} fmt 指定格式 默认为 'yyyy-MM-dd hh:mm:ss'
- */
-export function formatDate(date?: Date, fmt?: string): string;
-/**
- * 把指定格式的字符串转换为日期对象yyyy-MM-dd HH:mm:ss strFormatToDate ('yyyy-MM-dd', '2002-11-20')
- *
- */
-export function strFormatToDate(formatStr: any, dateStr: any): Date;
-/**
- * 比较日期差 dtEnd 格式为日期型或者有效日期格式字符串
- * @param strInterval string  可选值 y 年 m月 d日 w星期 h时 n分 s秒
- * @param dtStart Date  可选值 y 年 m月 d日 w星期  h时 n分 s秒
- * @param dtEnd Date  可选值 y 年 m月 d日 w星期  h时 n分 s秒
- */
-export function dateDiff(strInterval: any, dtStart: any, dtEnd: any): number | undefined;
-/**
- * 日期计算
- * @param strInterval string  可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
- * @param num int
- * @param date Date 日期对象
- * @return Date 返回日期对象
- */
-export function dateAdd(strInterval: any, num: any, date: any, ...args: any[]): Date | undefined;
-/**
- * 由秒数转化成hh:mm:ss格式 超过24小时(显示00:00:00)会重置
- * @param {} seconds
- */
-export function timeTohhmmss(seconds: any): string | undefined;
-/**
- * 获取今天日期，星期几 2020年12月9日 星期三
- * @returns
- */
-export function getTodayDate(): string;
-/**
- * 取得当前日期所在月的最大天数 maxDayOfDate(new Date('2020/2/1'))
- */
-export function maxDayOfDate(date: any, ...args: any[]): number;
-/**
- * 获取一段时间中含有的周末数量
- * @param beginDate
- * @param endDate
- * @returns {number}
- */
-export function getIntervalWeekends(beginDate: any, endDate: any): number;
-/**
- * 取得日期数据信息
- * 参数 interval 表示数据类型
- * y 年 M月 d日 w星期 ww周 h时 n分 s秒
- */
-export function getDatePart(interval: any, myDate: any, ...args: any[]): string;
+/**
+ * 取字符日期数组中最小和最大的日期
+ * @param {array} strDates 字符日期数组
+ * @returns {array} [0]最小和[1]最大的日期
+ */
+export function getMinMaxDate(strDates: array): array;
+/** Fsy 20200614 比较两个日期的大小
+ * @param {date} dateTime1
+ * @param {date} dateTime2
+ * @returns {Boolean} dateTime1>dateTime2:true else:false
+ */
+export function compareDate(dateTime1: date, dateTime2: date): boolean;
+/**
+ * 解析时间到格式化字符串
+ * parseTime('2012/1/19','{y}年{m}月{d}日 {h}时{i}分{s}秒')
+ * @param {(Object|string|number)} time
+ * @param {string} cFormat
+ * @returns {string | null}
+ */
+export function parseTime(time: (Object | string | number), cFormat: string, ...args: any[]): string | null;
+/** 格式化时间显示
+ * @param {number} time
+ * @param {string} option
+ * @returns {string}
+ */
+export function formatTime(time: number, option: string): string;
+/**
+ * 判断闰年
+ * @param date Date日期对象
+ * @return boolean true 或false
+ */
+export function isLeapYear(date: any): boolean;
+/**
+ * 格式化时间 将 Date 转化为指定格式的String
+ * @param {Date} date 要转换的数据
+ * @param {String} fmt 指定格式 默认为 'yyyy-MM-dd hh:mm:ss'
+ */
+export function formatDate(date?: Date, fmt?: string): string;
+/**
+ * 把指定格式的字符串转换为日期对象yyyy-MM-dd HH:mm:ss strFormatToDate ('yyyy-MM-dd', '2002-11-20')
+ *
+ */
+export function strFormatToDate(formatStr: any, dateStr: any): Date;
+/**
+ * 比较日期差 dtEnd 格式为日期型或者有效日期格式字符串
+ * @param strInterval string  可选值 y 年 m月 d日 w星期 h时 n分 s秒
+ * @param dtStart Date  可选值 y 年 m月 d日 w星期  h时 n分 s秒
+ * @param dtEnd Date  可选值 y 年 m月 d日 w星期  h时 n分 s秒
+ */
+export function dateDiff(strInterval: any, dtStart: any, dtEnd: any): number | undefined;
+/**
+ * 日期计算
+ * @param strInterval string  可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
+ * @param num int
+ * @param date Date 日期对象
+ * @return Date 返回日期对象
+ */
+export function dateAdd(strInterval: any, num: any, date: any, ...args: any[]): Date | undefined;
+/**
+ * 由秒数转化成hh:mm:ss格式 超过24小时(显示00:00:00)会重置
+ * @param {} seconds
+ */
+export function timeTohhmmss(seconds: any): string | undefined;
+/**
+ * 获取今天日期，星期几 2020年12月9日 星期三
+ * @returns
+ */
+export function getTodayDate(): string;
+/**
+ * 取得当前日期所在月的最大天数 maxDayOfDate(new Date('2020/2/1'))
+ */
+export function maxDayOfDate(date: any, ...args: any[]): number;
+/**
+ * 获取一段时间中含有的周末数量
+ * @param beginDate
+ * @param endDate
+ * @returns {number}
+ */
+export function getIntervalWeekends(beginDate: any, endDate: any): number;
+/**
+ * 取得日期数据信息
+ * 参数 interval 表示数据类型
+ * y 年 M月 d日 w星期 ww周 h时 n分 s秒
+ */
+export function getDatePart(interval: any, myDate: any, ...args: any[]): string;

package/dist/types/tools/Element.d.ts

@@ -1,32 +1,32 @@
-/**
- * el是否包含某个class
- * @param {*} el
- * @param {*} className
- */
-export function hasClass(el: any, className: any): boolean;
-/**
- * el添加某个class
- * @param {*} el
- * @param {*} className
- */
-export function addClass(el: any, className: any): void;
-/**
- * el去除某个class
- * @param {*} el
- * @param {*} className
- */
-export function removeClass(el: any, className: any): void;
-/**
- * 获取窗口滚动的坐标
- * @param {*} el
- */
-export function getScrollPosition(el?: any): {
-    x: any;
-    y: any;
-};
-/**
- * el是否在视口范围内
- * @param {*} el
- * @param {*} partiallyVisible
- */
-export function elementIsVisibleInViewport(el: any, partiallyVisible?: any): boolean;
+/**
+ * el是否包含某个class
+ * @param {*} el
+ * @param {*} className
+ */
+export function hasClass(el: any, className: any): boolean;
+/**
+ * el添加某个class
+ * @param {*} el
+ * @param {*} className
+ */
+export function addClass(el: any, className: any): void;
+/**
+ * el去除某个class
+ * @param {*} el
+ * @param {*} className
+ */
+export function removeClass(el: any, className: any): void;
+/**
+ * 获取窗口滚动的坐标
+ * @param {*} el
+ */
+export function getScrollPosition(el?: any): {
+    x: any;
+    y: any;
+};
+/**
+ * el是否在视口范围内
+ * @param {*} el
+ * @param {*} partiallyVisible
+ */
+export function elementIsVisibleInViewport(el: any, partiallyVisible?: any): boolean;

package/dist/types/tools/Exec.d.ts

@@ -1,7 +1,7 @@
-/**
- * 安全的执行方法
- * @param {Function} func 要执行的方法
- * @param  {...any} args 参数
- * @returns {any} 成功执行的返回值
- */
-export function safeExecuteFunc(func: Function, ...args: any[]): any;
+/**
+ * 安全的执行方法
+ * @param {Function} func 要执行的方法
+ * @param  {...any} args 参数
+ * @returns {any} 成功执行的返回值
+ */
+export function safeExecuteFunc(func: Function, ...args: any[]): any;

package/dist/types/tools/Interact.d.ts

@@ -1,37 +1,37 @@
-/**
- * 滚动到顶部
- */
-export function scrollToTop(): void;
-/**
- * 劫持粘贴板
- * @param {*} value
- */
-export function copyTextToClipboard(value: any): void;
-/**
- * 切换全屏显示状态
- * @param {Boolean} bFullScreen 指定切换状态
- */
-export function toggleFullScreen(bFullScreen: boolean): boolean;
-/**
- * openWindow(url)函数：弹出窗口
- * @param {string} url 路径
- * @param {number} width 窗口宽度
- * @param {number} height 窗口高度
- * @param {string} resize yes时可调整窗口大小，no则不可调
- */
-export function openWindow(url: string, width: number, height: number, resize: string): void;
-/**
- * 打开窗口函数
- * @param {String} url 地址
- * @param {String} title 窗口标题
- * @param {number} w 窗口宽度
- * @param {number} h 窗口高度
- * @param {object} opts 窗口参数
- */
-export function popupCenter(url: string, title: string, w: number, h: number, opts: object): void;
-/**
- * @description: 弹框确认关闭当前窗口
- * @param {*} message
- * @return {*}
- */
-export function confirmClosewindow(message: any): any;
+/**
+ * 滚动到顶部
+ */
+export function scrollToTop(): void;
+/**
+ * 劫持粘贴板
+ * @param {*} value
+ */
+export function copyTextToClipboard(value: any): void;
+/**
+ * 切换全屏显示状态
+ * @param {Boolean} bFullScreen 指定切换状态
+ */
+export function toggleFullScreen(bFullScreen: boolean): boolean;
+/**
+ * openWindow(url)函数：弹出窗口
+ * @param {string} url 路径
+ * @param {number} width 窗口宽度
+ * @param {number} height 窗口高度
+ * @param {string} resize yes时可调整窗口大小，no则不可调
+ */
+export function openWindow(url: string, width: number, height: number, resize: string): void;
+/**
+ * 打开窗口函数
+ * @param {String} url 地址
+ * @param {String} title 窗口标题
+ * @param {number} w 窗口宽度
+ * @param {number} h 窗口高度
+ * @param {object} opts 窗口参数
+ */
+export function popupCenter(url: string, title: string, w: number, h: number, opts: object): void;
+/**
+ * @description: 弹框确认关闭当前窗口
+ * @param {*} message
+ * @return {*}
+ */
+export function confirmClosewindow(message: any): any;