webcommon

前端业务代码工具库

本次工具是模仿outils，自己造轮子，还有网上收集的工具函数，进一步封装,在这里感谢outils的作者，还有好友Alex

目的：高效率完成前端业务代码

业务开发过程中，会经常用到日期格式化、url参数转对象、浏览器类型判断、节流函数等常用函数，为避免不同项目多次复制粘贴的麻烦，这里统一封装，并发布到npm，以提高开发效率。如果你也有常用的代码，欢迎为本项目提交pr。

安装使用

1. 直接下载min目录下的webcommon.min.js使用，支持UMD通用模块规范
2. 使用npm安装

浏览器:

  <script src="webcommon.min.js"></script>
  <script>
      var OS = webcommon.getOS() //直接调用
  </script>

npm:

$ npm install --save-dev webcommon

webpack、RequireJS、SeaJS等

// 完整引入
const webcommon = require('webcommon')
//const OS = webcommon.getOS() //获取操作系统类型

推荐使用方法

你真的不需要完整引入所有函数，所以只引入需要使用的方法即可。

// 只引入部分方法('webcommon/<方法名>')
const getOS = require('webcommon/getOS')
const OS = getOS()

API文档

Array

  arrayEqual  判断两个数组是否相等

  getMax  获取数组的最大值

  getMin  获取数组的最小值

Class

  addClass  为元素添加class

  hasClass  判断元素是否有某个class

  removeClass  为元素移除class

  getByClass  根据类名获取元素

Cookie

  getCookie  根据name读取Cookie

  removeCookie  根据name删除Cookie

  setCookie  添加Cookie

Device

  getExplore  获取浏览器类型和版本号

  getOS  获取操作系统类型

Dom

  getScrollTop  获取滚动条距顶部的距离

  offset  获取一个元素的距离文档(document)的位置，类似jQ中的offset()

  getText  获取标签内部的纯文本内容

  scrollTo  在${duration}时间内，滚动条平滑滚动到${to}指定位置

  setScrollTop  设置滚动条距顶部的距离

Function

  debounce  函数防抖

  throttle  函数节流

Keycode

  getKeyName  根据keycode获得键名

Object

  deepClone  深拷贝，支持常见类型

  isEmptyObject  判断Object是否为空

Random

  randomColorRgb   随机生成颜色Rgb格式

  randomColor   随机生成颜色

  randomNum  生成指定范围随机数

Regexp

  isEmail  判断是否为邮箱地址

  isIdCard  判断是否为身份证号

  isPhoneNum  判断是否为手机号

  isUrl  判断是否为URL地址

String

  digitUppercase  现金额转大写

Support

  isSupportWebP  判断浏览器是否支持webP格式图片

Time

  changeSecond  将秒转换为h:m:s

  formatPassTime  格式化${startTime}距现在的已过时间

  formatRemainTime  格式化现在距${endTime}的剩余时间

Url

  parseQueryString  url参数转对象

  stringfyQueryString  对象序列化

3D

  view3d  点击鼠标拖动，查看3D效果