super-tools-lib

### map - lonLatToMercator, // 经纬度转墨卡托 - mercatorToLonlat, // 墨卡托转经纬度 - getPosition, // H5 获取地理位置

Usage no npm install needed!

<script type="module">
  import superToolsLib from 'https://cdn.skypack.dev/super-tools-lib';
</script>

README

常用 js 工具函数

用法

import _ from 'super-tools-lib';
_.guid()

of

import { guid } from 'super-tools-lib';
guid()

of

const _ = require('super-tools-lib');
_.guid();

utils

  • guid // 生成一个唯一的 guid

_.guid()
=> 'bfa39b2f-f77e-425e-8f41-1fe0d8ac38b4'
  • getFileBase64 // 文件的 Base64 编码，
_.getFileBase64(file, (base64) => {
  console.log("base64", base64);
});
  • isAndroidMobileDevice // 判断是否安卓移动设备访问

_.isAndroidMobileDevice()
=> true | false
  • isAppleMobileDevice // 判断是否苹果移动设备访问

_.isAppleMobileDevice()
=> true | false
  • throttle // 函数节流

const fn = _.throttle(()=>{console.log('1')},2000);
fn()
fn()
fn()
=> '1'
  • debounce // 函数防抖

const fn =  _.debounce(()=>{console.log('1')},2000);
fn()
fn()
fn() // 如果多次触发将上次记录延迟清除掉,以最后一次触发重新计时
=> '1'
  • fileDownload // 根据 url 地址下载文件，图片，音频，视频
_.fileDownload(url);
  • fuzzyQuery // 使用 match 方法实现模糊查询

 * @param  {Array}  list     进行查询的数组
 * @param  {String}  key     进行查询的数组的字段
 * @param  {String} keyWord  查询的关键词
 * @return {Array}           查询的结果

const arr = [{ name: "1" }, { name: "2" }, { name: "3" }];
_.fuzzyQuery(arr, "name", "1");
=> [ { "name": "1"}]
  • getUrlParam // 获取 url ？后的参数

_.getUrlParam();
=> {}
  • getCookie // 获取 cookie 值

_.getCookie()
=> 'xxxxxxxxxxxx'
  • colorHex // RGB 颜色转 16 进制

_.colorHex('255,192,203');
_.colorHex('rgb(255,192,203)')
=> '#ffc0cb'
  • hexToRgba // 16 进制颜色转 RGBA

_.hexToRgba('#ffc0cb');
=> 'rgba(255,192,203,1)'
  • rgbaToHex // rgba 颜色转 16 进制

_.rgbaToHex('rgba(255,192,203,1)')
=> '#ffc0cb'
  • viewportToPixels // 计算 vh / vw 转 px

_.viewportToPixels('90vh')
=> 640
  • noRefdelUrlParam // 无刷新去除 url ?后 参数

// http://localhost:8888/?id=2
_.noRefdelUrlParam('id');
=>  // http://localhost:8888/?
  • vconsole //移动端查看 log
_.vconsole();
  • getAge // 输入身份证号获取年龄

_.getAge('xxxxxxxxxxxxxxxxx');
=> '29岁0月14天'
  • getSex // 输入身份证号获取性别

_.getSex('xxxxxxxxxxxxxxxxx');
=> '男'
  • digitUppercase //数字转化为大写金额

_.digitUppercase(10000)
=> '壹万元整'
  • injectScript // 动态引入 js
_.injectScript(src);
  • sinogToLetter // 输入汉字转换汉字首字母

_.sinogToLetter('你好 ')
=> 'NH'

//375屏幕下
_.getFitSize(100,750);
=> 50

字符串方法

  • initialToCapitali // 字符串首位是字母转大写

_.initialToCapitali('aaaa');
=> 'Aaaa'
  • repeat // 传入字符串，和重复次数，返回结果字符串

_.repeat('abc',3)
=> 'abcabcabc'
  • trim // 去除字符串首尾空格

_.trim('  xxx  ')
=> 'xxx'

number

  • accAdd //浮点数加法运算

_.accAdd(0.1, 0.2)
=> 0.3
  • accSub //浮点数减法运算

_.accSub(0.3,0.1)
=> 0.2
  • accMul //浮点数乘法运算

_.accMul(0.1,3)
=> 0.3
  • accDiv //浮点数除法运算

_.accDiv(0.3,3)
=> 0.1
  • formatPrice //数字千分位增加逗号

_.formatPrice(1111112211111,',')
=> '1,111,112,211,111'

时间

  • dateFormater //格式化时间

_.dateFormater('YYYY-MM-DD HH:mm:ss',new Date())
=> '2022-01-18 12:01:10'
  • formatPassTime // 格式化${startTime}距现在的已过时间(距离传入的时间经多了多久)

_.formatPassTime(1578614400000);
=> '2年前'
  • formatRemainTime // 格式化现在距${endTime}的剩余时间

_.formatRemainTime(new Date('2023').getTime())
=> '347天19小时52分钟 26秒'

正则


规则 key
chinese_numeric_letters // 数字，字母，汉字，任意组合
numeric_letters // 数字，字母，数字或字母，字母或数字组合
number // 带小数点数字 0 ～ 30
cPattern // 车牌号
cP // 身份证
intNumber // 正整数
character // 字符 254
email // 邮箱
website // 网址
mobile // 手机号
cname //校验中文名 包含校验少数民族名字
ename //校验英文名 每一个单词首字母都是大写
ip //校验 IP 地址
ipv4 // 校验 ipv4 地址
color16Reg // 16 进制颜色校验
mac //校验 mac 地址

_.validate(key,value)
=> true | false

性能监控

  • performanceAnalysis // Performance.timing：利用 Performance.timing 进行性能分析
_.performanceAnalysis();

dom

  • getOffset // 获取一个元素距离浏览器左上角的偏移量

_.getOffset(element)
=> { top:0, left:0 }
  • stopPropagation //阻止冒泡事件
_.stopPropagation(element);
  • hasClass, //检测类名

_.hasClass(element,name)
=> true | false
  • addClass, //添加类名
_.addClass(element, name);
  • removeClass, //删除类名
_.removeClass(element, name);
  • replaceClass //替换类名
_.replaceClass(element, newName, oldName);
  • numberRoll //数字滚动封装，滚动到指定的数字
_.numberRoll(element, targetNumber, duration);

map

  • lonLatToMercator, // 经纬度转墨卡托
_.lonLatToMercator({ lon: 116.445088, lat: 39.94614 });
=> {x: 12962607.899733523, y: 4858118.574453057}
  • mercatorToLonlat, // 墨卡托转经纬度
_.mercatorToLonlat({x: 12962607.899733523, y: 4858118.574453057})
=> {lon: 116.44508800000001, lat: 39.946140000000014}
  • getDistance, // 输入起终点的高德坐标获取距离（米）
const startLon = 116.641874;
const startLat = 40.304162;
const endLon = 116.213407;
const endLat = 40.226617;

_.getDistance(startLon, startLat, endLon, endLat);
=> 37405
  • calcDistance // 计算经纬度两个坐标得距离

_.calcDistance(116.95400,39.95400,116.95300,39.95300)
=> 0.1222

浏览器

  • toFullScreen // 浏览器全屏
_.toFullScreen();
  • exitFullscreen // 浏览器退出全屏
_.exitFullscreen();
  • LocalStorage // 封装本地存储方法，提供 get，set，remove， clear 等方法
_.LocalStorage.get(user,name)
=> 返回user下的name值

_.LocalStorage.get(user, name, value)
=> 设置user下name字段的的值value

_.LocalStorage.remove(user, name)
=> 删除user下的name字段

_.LocalStoeage.clear()
=> 清空本地存储
  • getPosition // H5 获取地理位置
_.getPosition()
  .then((pos) => {
    console.log("pos", pos);
  })
  .catch((err) => console.log(err));
  • winCopy // 禁止/开启：右键、选择、复制
_.winCopy(true); // true | false
  • print // 打印指定内容
 * @param {string} printEleId //要打印的内容容器id
 * @param {string} rootEleId  //根节点容器id
 * @param {string} style // 打印时页面容器样式
 * @return {*}
_.print(printEleId, rootEleId, style)
  • copy // 复制文本
_.copy("xxxxxxds");
  • scrollToTop // 平滑滚动到页面顶部
_.scrollToTop();
  • userBrowser //返回当前浏览器是什么类型的浏览器
// 可能返回类型 Firefox, Chrome, Opera, Safari
_.userBrowser();
=> 'Chrome'

数组方法

  • arrayNonRepeatfy, // 利用 Map 数据结构去重
const arr = [1,1,'true','true',true,true,15,15,false,false, undefined,undefined, null,null, NaN, NaN,'NaN', 0, 0, 'a', 'a',{},{}]
_.arrayNonRepeatfy(arr)
=> [1, 'true', true, 15, false, undefined, null, NaN, 'NaN', 0, 'a', {}, {}]

对象方法

  • stringfyQueryString // 对象序列化
_.stringfyQueryString({name:'fei',id:1, "storeNo" : "1-105","floorName" : "F1",})
=> 'name=fei&id=1&storeNo=1-105&floorName=F1'

计算

  • smallRounding // 小数指定位数进行取整
_.smallRounding(89.38931,3);
=> 89.39

类型判断

  • isBase64
_.isBase64(target)
=> true | false
  • isArray
_.isArray(target)
=> true | false
  • isString
_.isString(target)
=> true | false
  • isFunction
_.isFunction(target)
=> true | false
  • isObject
_.isObject(target)
=> true | false
  • isNumber
_.isNumber(target)
=> true | false
  • isWeiXin
_.isWeiXin()
=> true | false
  • isSupportWebP // 判断浏览器是否支持 webP 格式图片
_.isSupportWebP()
=> true | false
  • returnType // 返回类型
_.returnType(target)
=> type
  • isPromise // 是否 Promise 对象
_.isPromise(target)
=> true | false
  • isSymbol
_.isSymbol(target)
=> true | false
  • isError
_.isError(target)
=> true | false
  • isRegExp
_.isRegExp(target)
=> true | false
  • isDate
_.isDate(target)
=> true | false
  • isUndefined
_.isUndefined(target)
=> true | false
  • isNull
_.isNull(target)
=> true | false

file 文件操作

  • downBlob // 下载二进制流文件
_.downBlob(file, fileName);
  • exportExcel // 导出 Excel
const column = [
  {
    title: "类型/楼层",
    dataIndex: "type",
    key: "type",
    align: "left",
  },
  {
    title: "单元（个）",
    dataIndex: "count",
    key: "count",
    align: "left",
  },
  {
    title: "数量占比",
    dataIndex: "countShare",
    key: "countShare",
    align: "left",
  },
  {
    title: "面积（㎡）",
    dataIndex: "size",
    key: "size",
    align: "left",
  },
  {
    title: "面积占比",
    dataIndex: "sizeShare",
    key: "sizeShare",
    align: "left",
  },
];
const data = [
  { type: "1", count: "2", countShare: "3", size: "4", sizeShare: "5" },
];

_.exportExcel(column, data, "fileName");