工具方法
介绍
组件库中的公共方法,均挂载在$baseMethod对象下,调用方法如下: 如果是在vue文件中,需要通过this.$baseMethod.xxx形式调用:
<!-- 格式化时间戳 -->
this.$baseMethod.formatData(Date.now());
如果是在js文件,需要通过$vuex.$baseMethod.xxx形式调用,如:
// utils.js
$vuex.$baseMethod.formatData(Date.now());
formatData
WARNING
请直接使用 dayjs 替代
formatData (time, format = 'yyyy-MM-dd hh:mm:ss')
描述:格式化时间戳
参数: @param time 时间戳
@param format 定义返回时间格式
@returns string
getBeforeDay
WARNING
请直接使用 dayjs 替代
getBeforeDay (n = 0, format = 'yyyy-MM-dd hh:mm:ss')
描述:获取 n 天以前或以后的时间
参数: @param n 负数表示n天以前,正数表示 n 天以后日期
@param format 定义返回时间格式
@returns string
getTodayToAny
WARNING
请直接使用 dayjs 替代
getTodayToAny(n = 1, format = 'yyyy-MM-dd hh:mm:ss')
描述:获取今天开始到 n 天以后日期
参数: @param n 负数表示 n 天以前,正数表示 n 天以后日期
@param format 定义返回时间格式
@returns
getNowMonthDate
WARNING
请直接使用 dayjs 替代
getNowMonthDate(n = 0, flg = false)
描述:获取当前月份第一天 and 最后一天
参数: @param n 负数表示 n 个月前,正数表示 n 个月以后日期
@param flg 表示忘记干嘛用了
@returns
exportFile
exportFile(data, name, type = 'text/csv;charset=utf-8')
描述:导出下载文件文件
参数: @param data 二进制流数据
@param name 下载文件名
@param type 下载文件类型
exportFileByUrl
exportFileByUrl(url, name)
描述:通过 url 导出文件
参数: @param url 文件地址
@param name 下载文件名
regYuanToFen
regYuanToFen(m)
描述:人民币单位转换 元 => 分
参数: @param m 需要转换的值 @returns number
regFenToYuan
regFenToYuan(m, float = true)
描述:人民币单位转换 分 => 元
参数: @param m 需要转换的值
@param float 为 true 则保留两位小数,不足两位则补0;false 则没有小数位或不足两位,不补0
@returns number
regRiceToKm
regRiceToKm(m, float = true)
描述:距离长度单位转换 米 => 公里
参数: @param m 需要转换的值
@param float 为 true 则保留两位小数,不足两位则补0;false 则没有小数位或不足两位,不补0
@returns string|any
regKmToRice
regKmToRice(m)
描述:距离长度单位转换 公里 => 米
参数: @param m 需要转换的值
@returns number
regMinuteToSecond
regMinuteToSecond(m)
描述:时间单位转换 分 => 秒
参数: @param m 需要转换的值
@returns number
regSecondToMinute
regSecondToMinute(m)
描述:时间单位转换 秒 => 分
参数: @param m 需要转换的值
@returns string
debounce
debounce(fn, wait = 300 ,defer = false)
描述:防抖函数,在事件被触发wait秒后再执行回调,如果在这wait秒内又被触发,则重新计时。
参数: @param fn 回调函数
@param wait 时间间隔
@param defer true: 反向防抖,即触发事件会先行执行回调,后续 n 秒内重复重触发,不再执行回调
@returns Function
throttle
throttle(fun, wait = 300)
描述:节流函数,规定在一个单位时间内,只能触发一次函数。如果这个单位时间内触发多次函数,只有一次生效。单位时间内循环执行
参数: @param fn 回调函数
@param wait 时间间隔
@returns Function
deepClone
deepClone(obj)
描述:深度拷贝对象和数组
参数: @param obj 需要拷贝对象或数组
@returns []|{}
delEmptyObject
delEmptyObject(obj)
描述:删除对象和数组空属性
参数: @param obj 需要处理的对象或数组
scrollBackTop
scrollBackTop(type = false , scrollX = false)
描述:页面回到顶部
参数: @param type 返回顶部是否需要平滑动画
@param scrollX 是否水平滚动条也回到 0 位置
copyCommand
copyCommand(str)
描述:复制文字到粘贴板
参数: @param str 待复制字符串
hasClass
hasClass(el, cls)
描述:原生js判断dom节点是否包含class
参数: @param el dom节点
@param cls class类名
@returns boolean
addClass
addClass(el, cls)
描述:原生js给dom节点添加class
参数: @param el dom节点
@param cls class类名
removeClass
removeClass(el, cls)
描述:原生js删除dom节点class
参数: @param el dom节点
@param cls class类名
toggleClass
toggleClass(el, cls)
描述:原生js切换dom节点class,即el包含cls类名则删除,无则添加
参数: @param el dom节点
@param cls class类名
moveArray
moveArray(arr, index, tindex)
描述:移动数组元素位置
参数: @param arr 原始数组
@param index 需要移动元素的下标index
@param tindex 需要移动到的指定下标位置
@returns array
tradeArray - 废弃
DANGER
2.11.2 废弃
tradeArray(arr, index, tindex)
描述:移动数组元素位置
参数: @param arr 原始数组
@param index 需要交换位置的开始下标
@param tindex 需要交换位置的结束下标
@returns array
addHandler
addHandler(element, type, handler)
描述:添加事件绑定
参数: @param element 需要绑定事件的节点元素
@param type 绑定事件名(keyup,click)
@param handler 绑定事件回调函数
removeHandler
removeHandler(element, type, handler)
描述:添加事件绑定
参数: @param element 需要解除绑定事件的节点元素
@param type 解除绑定事件名(keyup,click)
@param handler 解除绑定事件回调函数
randomNum
randomNum(minNum, maxNum)
描述:生成[n,m]的随机整数
参数: @param minNum 范围开始值
@param maxNum 范围结束值
@returns number
isElementInViewport
isElementInViewport(el)
描述:判断元素是否在垂直可视区域
参数: @param el 元素节点
@returns boolean
mapToObject
mapToObject(map)
描述:map转Object
参数: @param map 需要转换的map对象
@returns object
objectToMap
objectToMap(obj)
描述:对象转map
参数: @param obj 需要转换的对象
@returns map
typeOf
typeOf(obj)
描述:判断对象类型
参数: @param obj 需要判断的对象
@returns string: ['boolean','number','string','function','array','date','regExp','undefined','null',object','map','set',]
cachedFn
cachedFn(fn)
描述:缓存执行结果
参数: @param fn 需要缓存执行的函数
@returns fn
disableBodyScroll
disableBodyScroll()
描述:禁止浏览器页面滚动
enableBodyScroll
enableBodyScroll()
描述:允许浏览器页面滚动
getScrollbarWidth
getScrollbarWidth()
描述:获取浏览器滚动条宽度
参数: @returns int
getHashParams
getHashParams()
描述:获取URL的hash参数
参数: @returns object
getQueryParams
getQueryParams()
描述:获取URL的query参数
参数: @returns object
getCookies
getCookies(name)
描述:获取cookeie
参数: @param name cookeie名称
@returns object
setStore
setStore(name, content)
描述:存储sessionStorage
参数: @param name sessionStorage name
@param content sessionStorage value
getStore
getStore(name)
描述:获取sessionStorage
参数: @param name sessionStorage name
@returns object
removeStore
removeStore(name)
描述:删除sessionStorage
参数: @param name sessionStorage name
getDeviceOSType
getDeviceOSType()
描述:获取设备系统类型,主要区分ios与android
参数: @return string
judgeBrowserType - 废弃
DANGER
2.11.2 废弃
judgeBrowserType()
描述:判断浏览器类型和版本号
参数: @return object