yskj-tools v1.7.7

最新版本 V1.2.19

更新说明(V1.2.x)

新增_environ(判断当前所处的环境)基础函数
新增p_uploadFile(上传文件)
新增v_idCard（身份证校验）方法
扩展_format兼容性
新增p_uploadFile图片压缩功能
修改p_uploadFile图片压缩改为前端处理
优化p_initVue方法，支持直接获取用户信息
修复p_uploadFile方法多文件上传不能正确获取length问题。*1.2.5
修复v_idCard方法bug，兼容身份证号码中有X的情况。 *1.2.6
新增p_uploadFile返回解密过后的字段名 *1.2.8
修改_unique方法为：json数组去重 *1.2.9
修改p_uploadFile多文件上传bug *1.2.10
修复print返回bug *1.2.12
修复p_uploadFile方法bug *1.2.13
p_uploadFile方法支持base64上传文件 *1.2.14
新增文件解密方法p_decryUrl *1.2.15
文件解密方法p_decryUrl新增支持：字符串，数据，json数组格式 *1.2.17

更新说明(V1.1.0)

1. 由于vue-cli2不支持扩展运算符的第三方库，修改export方式

快捷使用

将方法全部注册到vue的原型链上，之后可以使用this来调用

import tools from 'yskj-tools'
for (const keys of Object.keys(tools)) {
    Vue.prototype[keys] = tools[keys]
}

基础工具类方法

异步工具类方法

表单验证类方法

时间格式化

功能：时间格式化
参数：{
    time: 需要被格式化的时间(支持格式为 时间戳和'2021-04-26 16:00:00', '2021/04/26 16:00:00')
    format：返回的时间格式，默认'MM-DD' => 04-26, 还支持'MM-DD hh:mm' => 04-26 15:07  'YY-MM-DD hh:mm:ss' 'YY-MM-DD'  'MM-DD' 'hh:mm:ss' 'hh:mm'
    'y' => 2021     'm' => 04   'd' => 26   
    'week' => 1 (0 表示星期天， 1表示星期一，······)
}
用法：如下

_format('2021-4-26') // 04-26
_format('2021-4-26 14:59:32', 'MM-DD hh:mm') // 04-26 14:59
_format(1619424033104, 'MM-DD hh:mm') // (1619424033104为时间戳) 04-26 16:01
_format(1619424033104, 'week') // 1
_format(new Date(), 'y') // 2021
_format(new Date(), 'm') // 04
_format(new Date(), 'd') // 26

json数组去重

功能：json数组去重
参数： {
    arr: json Array
    key: 唯一的key名，根据此键名进行去重
}
用法：如下

var arr = [{id: 1, name: '11'}, {id: 1, name: '22'}]
_unique(arr, 'id') // [{id: 1, name: '11'}]

中国大陆姓名验证

功能：中国大陆姓名验证
参数：用户输入的姓名
用法：如下

v_name('刘德华') // true
v_name('周杰伦') // true
v_name('123') // false
v_name('james') // false

手机号码验证

功能：手机号码验证
参数：用户输入的手机号码
用法：如下

v_phone(13188808452) // true
v_phone(11188888888) // false
v_phone(1772645777) // false

文件校验

功能：上传前校验文件是否合法
参数：{
    file: file文件对象
    str: 当前校验的对象（video，image，word, excel）
    filesize: 自定义最大上传容量，filesize默认大小为10，单位为'MB'，目前支持的单位有'KB', 'MB', 'GB'
}
用法：如下

v_file(file, 'image', { size: 10, units: 'MB' })

// 如果上传的文件类型正确，没有超出最大上传容量，则返回：
{
    message: 'ok',
    type: 'success',
    isSize: true // 上传文件的大小没有超出限定大小
}

// 如果上传的文件超出最大上传容量，则返回：
{
    message: `上传的文件的大小不能超过${filesize.size + filesize.units}`,
    type: 'error',
    isSize: false // 上传文件的大小超出了限定大小
}

获取租户Id

参数: {
    logo: 租户标识，默认's_gtn'
    baseUrl: 基础请求地址
    url: 接口地址, 默认不传递
}

p_tenantId({
    baseUrl: 'xxxx',
    url: 'xxxx'
}).then((res) => {}).catch((err) => {})

token加/解密

参数: {
    baseUrl: 基础请求地址
    url: token加/解密接口, 默认不传递，
    token: 用户令牌，不加Bearer
}

p_encryToken({
    baseUrl: 'xxxx',
    token: 'xxxx'
}).then((res) => {}).catch((err) => {})

智慧校园子系统统一初始化前的操作

参数: {
    baseUrl（*String）: 基础请求地址，
    url（String）: token加/解密接口, 默认不传递，
    token（*String）: 用户加密令牌，
    getInfo（Boolean），是否获取用户信息，默认为false
    infoUrl（String）：用户信息接口地址，有默认值
}

p_initVue({
    baseUrl: 'xxxx',
    token: 'xxxx'
}).then((res) => {}).catch((err) => {})

性别映射

参数: {
    sex: 后端返回的表示性别的值
}

_sex(0) // 男
_sex(1) // 女
_sex(5) // 未知
_sex('female') // 女
_sex('male') // 男
_sex('unknown') // 未知

判断当前所处的环境

    返回值为：{
        miniapp： 微信小程序中，
        wx: 微信浏览器中
        ali: 支付宝浏览器中
        browser： 普通浏览器
    }

文件上传

支持：
    1. 多文件上传 
    2. 图片压缩功能 ^1.2.1 注：小程序压缩请使用wx.chooseImage自带的压缩功能
    3. 小程序，Web通用

参数: {
    files(Array): 图片集合(小程序是本地图片路径集合，Web是file对象集合)
    options(obj): {
        fileType(String): 文件类型，可选值：base64、file(默认)
        token(*String)
        baseUrl(*String): 应用的基本地址    注意：不要以斜杠开头！！！
        uploadBaseUrl(*String)：上传的api基本地址     注意：不要以斜杠开头！！！
        uploadUrl(String)：上传的api地址，默认为：'alpha/upload_file.do'      注意：不要以斜杠开头！！！
        tokenUrl(String): 长传前的token转换接口，默认为：'base/api/file/token'      注意：不要以斜杠开头！！！
        maxLength(Number): 最大上传文件个数，默认为9
        openCompress(Boolean): 文件上传前是否开启压缩功能，默认为false
        width(Number): 开启图片压缩时传递，压缩的图片宽度，默认值：500
    }
}

p_uploadFile([],{}).then((res) => {}).catch((err) => {})

文件加密转解密

参数: {
    decryData: 加密字符串/数组/json数组
    options{
        key:(String): 加密字段的key值，如果是json数组，则key为必传项
        token(*String)
        baseUrl(*String): 应用的基本地址    注意：不要以斜杠开头！！！
        uploadBaseUrl(*String)：上传的api基本地址     注意：不要以斜杠开头！！！
        decryUrl(String): 加密转解密接口，默认为：'alpha/get_file_url_key.do'      注意：不要以斜杠开头！！！
        tokenUrl(String): 上传前的token转换接口，默认为：'base/api/file/token'      注意：不要以斜杠开头！！！
    }
}

p_decryUrl(decryData,{
    xxx: xx
}).then((res) => {})