提供了后台管理系统中常见的公共方法处理,包括格式化时间,格式化数据显示格式,计算时间间隔、验证表单等功能"
- 方法仍在持续更新中,如需使用最新的包, gitee 同步更新,可在gitee上下载源码
https://gitee.com/hh0416hy/tools-common.git
npm uninstall common-publics-tools
npm install common-publics-tools
npm i common-publics-tools
在vue项目中,main.js 中
import {Html, NumberFn, Times, Verify} from 'common-publics-tools'
Vue.prototype.Html = Html
this.$Html.copyText("复制")
在vue组件中 中
import {Html, NumberFn, Times, Verify} from 'common-publics-tools'
Html.copyText("复制")
操作Html相关的公共方法
用于复制文字到剪切板 业务场景:点击当前链接复制文字
Html.copyText("复制")
参数 | 是否必须 | type |
---|---|---|
str | y | String |
callback | n | Function |
- 返回result
获取当前页面url后的所有参数
业务场景:页面中需要用url传参数的时候,常常需要用url携带参数
Html.findLocationUrlQuery()
- 返回result {}
找到字符串中的数字部分
业务场景:在项目中,某些素材在提交的时候,会按照图片序列提交。此时需要得到每个素材名称中的素材序列的顺序。
Html.findNumberByStr(str)
参数 | 是否必须 | type |
---|---|---|
str | y | String |
- 返回 String
通过下载链接下载excel文件
业务场景:在项目中,后端提供一个下载链接,可通过a标签可直接下载
Html.downloadByUrl(url)
参数 | 是否必须 | type | 备注 |
---|---|---|---|
url | y | String | 接口链接 |
params | n | Object | 下载传参 |
去除字符串中的html标签
Html.removeHtmltag(str)
参数 | 是否必须 | type | 备注 |
---|---|---|---|
str | y | String |
- 返回去除了html的标签的字符串
获取当前页面url上的参数
Html.getQueryString(id)
参数 | 是否必须 | type | 备注 |
---|---|---|---|
value | y | String | 参数名称 |
- 返回匹配到的参数
动态引入js
Html.injectScript(url)
参数 | 是否必须 | type | 备注 |
---|---|---|---|
src | y | String | js文件 |
获取px 和rpx之间的比例
Html.getRpx()
- 返回比例值
时间的相关公共方法
用于计算时间早于当前时间多久 或者 晚于当前时间多久。
业务场景:计算某个任务执行于3天之前,计算某个定时任务3小时后执行。
Times.handlerUpdateTime('2022-11-15', false, false)
参数 | 是否必须 | type | 备注- |
---|---|---|---|
time | y | String | 用于计算的时间 |
isNosmallerDay | n | Boolean | 当计算结果少于一天是否需要计算,有时,小于一天的不在需要计算则返回今天,默认需要参与计算 |
isUTC | n | Boolean | 是否按照UTC的时间进行计算 |
- 返回result,字符串 '2个月前' '1天前'
用于当前日期最近7天、14天、30天,本月、上月、上周
业务场景:计算某个任务执行于3天之前,计算某个定时任务3小时后执行。
本周c-7,本月c-30, 本年c-365,最近7天、14天、30天、60天、90天、180天、d-num,上周l-7,上月l-30, 去年l-365
Times.getlastdays('c-30')
参数 | 是否必须 | type | 备注- |
---|---|---|---|
str | y | String | 用于计算的时间c-7, c-30 |
- 返回result,Array, 返回[开始时间, 结束时间]
用于计算区间时间间隔天数
参数 | 是否必须 | type | 备注- |
---|---|---|---|
nowDate | y | String | 开始时间 |
date | y | String | 结束时间 |
- 返回相隔天数
根据日期返回星期几
参数 | 是否必须 | type | 备注- |
---|---|---|---|
date | y | String | 时间 |
- 返回“周几”
格式化数据的公共方法
给数组对象排序
业务场景:接口一次性返回所有的数据,前端需要根据选中的字段进行排序,常用语表格排序
arr.sort(NumberFn.compare('value', false))
参数 | 是否必须 | type | 备注- |
---|---|---|---|
attr | y | String | 用于排序的字段 |
rev | n | Boolean | 升序还是降序,默认为降序 |
- 返回result,Array, 返回[{age: 20, name: 'ls'}, {age: 18, name: 'zs}]#### compare
业务场景:将大额数字处理成M,K,B,T
NumberFn.handlerNumberToBToM(3232323.32232, 3)
参数 | 是否必须 | type | 备注- |
---|---|---|---|
data | y | Number | 需要处理的数字 |
d | n | Number | 保留几位小数 |
- 返回字符串,类似于:3.23M
保留几位小数
NumberFn.numToFixed()
参数 | 是否必须 | type | 备注- |
---|---|---|---|
num | y | Number | 需要处理的数字 |
n | n | Number | 保留几位小数 |
- 返回字符串,类似于:2.33
NumberFn.noRepeatArrOfObj()
对象数组去重
参数 | 是否必须 | type | 备注- |
---|---|---|---|
array | y | Array | 原始数组 |
key | n | String | 根据key值去重 |
- 返回字符串,类似于:2.33
用于表单验证,以及其他的验证
Verify.minxTextLength()
不得小于XX个字符
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
min | n | Number | 不得小于xx的位数 |
callback | n | Function | 验证后的回调函数 |
- 返回function
Verify.validateThreshold()
0-100的数字验证
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回回调function
Verify.validateImpressions()
正整数字的验证
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回回调function
Verify.isLetterNumber()
验证数字、字母、下划线
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回回调function
Verify.isUrl()
验证是否是网址
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回回调function
Verify.vertifyPassword()
验证密码是否由8-20位之间的字母、数字、以及指定字符组成 .-!@#$%^*()
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回回调function
Verify.isMobile()
验证手机号是否正确
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isPhone()
验证电话号是否正确
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isString()
验证是否为字符串
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isNumber()
验证是否为数字
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isBoolean()
验证是否为布尔值
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isFunction()
验证是否为函数
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isNull()
验证是否为Null
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isUndefined()
验证是否为Undefined
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isObj()
验证是否为Object
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isArray()
验证是否为Array
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isDate()
验证是否为日期
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isRegExp()
验证是否为正则
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isError()
验证是否为错误对象
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isSymbol()
验证是否为Symbol函数
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isPromise()
验证是否为promise对象
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isSet()
验证是否为Set对象
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isWeiXin()
验证是否为微信浏览器
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isDeviceMobile()
验证是否为移动端
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isQQBrowser()
验证是否QQ浏览器
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isSpider()
验证是否为爬虫
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isIos()
验证是否为IOS
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isPC()
验证是否为PC端
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.isCardID()
验证身份证是否正确
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值
Verify.elementIsVisibleInViewport()
验证是否在适口范围内
参数 | 是否必须 | type | 备注- |
---|---|---|---|
value | y | Number | 验证值 |
callback | n | Function | 验证后的回调函数 |
- 返回布尔值