前端开发工具集eutils

项目介绍

该项目整理了前端比较常用的工具集,包括js工具和css工具;
当我们新建一个前端项目时,只需要引入这个npm包,就可以省去很多写工具的重复工作;

成都创新互联公司服务项目包括萨尔图网站建设、萨尔图网站制作、萨尔图网页制作以及萨尔图网络营销策划等。多年来,我们专注于互联网行业,利用自身积累的技术优势、行业经验、深度合作伙伴关系等,向广大中小型企业、政府机构等提供互联网行业的解决方案,萨尔图网站推广取得了明显的社会效益与经济效益。目前,我们服务的客户以成都为中心已经辐射到萨尔图省份的部分城市,未来相信会继续扩大服务区域并继续获得客户的支持与信任!

  • 源码地址
  • API
  • version
  • collection

前端开发工具集 eutils

项目规范

  • 函数使用小驼峰方式命名
  • 对象使用大驼峰方式命名
  • 项目使用webpack构建,支持按需引入
  • 支持直接引入编译前的源文件:less文件、es6文件

安装

$ npm install @jnlong/eutils

使用

js

    // js引用方法1
    import eutils from 'eutils';

    eutils.date.format('2018-9-6', '{y}/{m}/{d} {h}:{i}:{s}');

    // js引用方法2
    import {type, urlParse, date, log as ulog} from 'eutils';
    date.format(new Date(), 'YYYY-MM-DD HH:mm:ss.SSS');

    // 按需引入js源文件
    import date as uDate from 'eutils/src/js/date'

style

    // 引入css
    @import 'eutils/dist/index.css';

    // 引入less:webpack需要配置less解析
    @import 'eutils/src/style/index.less';
    @import 'eutils/src/style/index.less';

用法

在 example/main.js中编写了每一个API的用法,可以打开文件查看。

example

可以运行样例查看example

  • git clone git@github.com:jnlong/eutils.git
  • cd eutils
  • npm install --save-dev
  • npm run dev
  • 用浏览器打开 http://localhost:8088/查看example,也可以同时打开浏览器的控制台查看console信息

API

tools

为了方便调用,tools目录的API生成在eutils根目录,调用方法:eutils.log(), eutils.toast(msg)

log

  • 调用方法:eutils.log(arg1, arg2, arg3, ...);
  • 参数:log(args),接受多个参数;
  • 打印日志,可以通过window.isDebug来全局控制是否打印的开关,实现只在测试环境打印日志;
  • 为了提高可读性,在打印时对一个参数设置了颜色
    前端开发工具集 eutils

deepCopy

object深拷贝,使用深拷贝的目的是:避免复制后的对象的更改,传递给源对象;
调用方法:eutils.deepCopy(obj);

参数
参数类型必填说明
data Object 需要执行深拷贝的object
返回
参数类型说明
data Object 执行深拷贝后的对象

checkLs

  • 判断所在浏览器是否支持localStorage;
  • 调用方法:eutils.checkLs();
  • 返回:Boolean

toast

toast弹窗,调用后弹出一个toast;
调用方法:eutils.toast('我是一个toast');
前端开发工具集 eutils

versionCompare

调用方法:eutils.versionCompare(v1, v2);

参数
参数类型必填说明
v1 String 版本号1
v2 String 版本号2
返回
参数类型说明
res Number v1=v2, 返回0;v1大于v2, 返回1;v1小于v2,返回-1;

date

format

日期格式化;
调用方法:etuils.date.format(new Date(), 'YYYY-MM-DD [at] HH:mm:ss');

参数
参数类型必填说明
date Date 需要格式化的日期
format String 格式样式,例如'YYYY-MM-DD [at] HH:mm:ss'
返回
参数类型说明
res String 返回样例 '2018-10-15 at 08:06:20'

calDuration

计算时间2比时间1,间隔的时长,同时支持之前和之后;如 1年前,3个月前,20天前,5分钟前,2秒前,5个月后,3小时后;
调用方法:eutils.date.calDuration(d1, d2) ;

参数
参数类型必填说明
d1 Date 日期1
d2 Date 日期2
返回
参数类型说明
res String 返回时间2 比 时间1,间隔的时长,如 '3个月前'、'5小时后'等等

add

(new Date(), unit, count) 对一个日期对象,加上某个单位的数量;比如给一个日期加3天:add(new Date(), 'd', 3)
调用方法:eutils.date.calDuration(d1, d2) ;

参数
参数类型必填说明
d1 Date 日期1
d2 Date 日期2
返回
参数类型说明
res String 时间2 比 时间1,间隔的时长,如 '3个月前'、'5小时后'等等

cookie

get

获取cookie;
调用方法:eutils.cookie.get(name) ;

参数
参数类型必填说明
name String cookie的名称
返回
参数类型说明
res String cookie的value

set

添加cookie;
调用方法:eutils.cookie.set({name: '', value: '', days: 3, path: '/'}) ;

参数
参数类型必填说明
opt Json json格式,其中days表示失效时间(单位天)

del

删除cookie;
调用方法:eutils.cookie.del(name) ;

参数
参数类型必填说明
name String cookie的名称

urlparse

search

调用方法:eutils.urlparse.search(name, url);

参数
参数类型必填说明
name String 需要查找的query名称;
url String query所在的url,默认是location.search;
返回
参数类型说明
res String name在url中对应的value,查找不到则返回空字符串('')

add

在url上添加参数,并且返回新的url;
调用方法:eutils.urlparse.add(name, value, url);

参数
参数类型必填说明
name String query的名称;
value String query的值;
url String 需要添加参数的url,默认是location.search;
返回
参数类型说明
res String 添加参数后的url

remove

在url上删除参数;
调用方法:eutils.urlparse.remove(name, url);

参数
参数类型必填说明
name String 需要查找的query名称;
url String query所在的url,默认是location.search;
返回
参数类型说明
res String 删除参数后的url

replace

调用方法:eutils.urlparse.replace(name, newValue, url);

参数
参数类型必填说明
name String 需要查找的query名称;
newValue String 需要替换的value;
url String query所在的url,默认是location.search;
返回
参数类型说明
res String 替换参数后的url

jsonToQuery

将json转换成url格式;
调用方法:eutils.urlparse.jsonToQuery(obj);

参数
参数类型必填说明
obj JSON
返回
参数类型说明
res String 转换后的url

queryToJson

将url转换成json格式
调用方法:eutils.urlparse.queryToJson(url);

参数
参数类型必填说明
url String 默认是location.search;
返回
参数类型说明
res Json 转换后的json对象

load

为了方便调用,load目录的API生成在eutils根目录

loadCss

动态加载外部css链接,并且通过id校验来避免重复添加;
调用方法:eutils.loadCss(href, id);

参数
参数类型必填说明
href String css链接
id String 不传参数,则不做重复添加的校验

loadScript

动态加载script,并且通过id校验来避免重复添加;
调用方法:eutils.loadScript(src, cb, id);

参数
参数类型必填说明
src String script链接
cb Functon 资源下载成功的回调函数,如果不需要回调,可以传null
id String 不传参数,则不做重复添加的校验

loadImg

(src, cb, id)

参数
参数类型必填说明
src String img链接
cb Functon 资源下载成功的回调函数,如果不需要回调,可以传null
id String 不传参数,则不做重复添加的校验

type

为了方便调用,type目录的API生成在eutils根目录,调用方法如:eutils.isSupportWebP()

isSupportWebP

判断是否支持webp格式的图片
返回:Boolean

isString(obj)

判断obj是不是String类型
返回:Boolean

isNumber(obj)

判断obj是不是Numbe类型
返回:Boolean

isArray(obj)

判断obj是不是Arra类型
返回:Boolean

isFunction(obj)

判断obj是不是Function类型
返回:Boolean

isDate(obj)

判断obj是不是Date类型
返回:Boolean

checkType

类型判断:判断str是否是指定类型,返回Boolean;
调用方法:eutils.checkType(str, type);
正则校验的类型: IP、QQ、english、chinese、tel、phone、postal、email、money、url、date
例如:
eutils.checkType('13812560000', 'phone'); // 返回 true
etutil.checkType('aaaxxx', 'url'); // 返回false

detector

根据ua判断浏览器环境、版本号;

parse

调用方法,eutils.detector.parse(ua);

参数
参数类型必填说明
ua String 需要校验的ua,默认是navigator.userAgent
返回

返回json,格式如下:

{
    device: {
        name: "iphone",
        version: -1,
        fullVersion: "-1",
        [iphone]: -1
    },
    os: {
        name: "ios",
        version: 6.1,
        fullVersion: "6.1",
        [ios]: 6.1
    },
    browser: {
        name: "chrome":
        version: 26.0,
        fullVersion: "26.0.1410.50",
        mode: 26.0,
        fullMode: "26.0.1410.50",
        compatible: false,
        [chrome]: 26.0
    },
    engine: {
        name: "webkit",
        version: 536.26,
        fullVersion: "536.26",
        mode: 523.26,
        fullMode: "523.26",
        compatible: false,
        [webkit]: 536.26
    }
}

css

common

常用样式

  • word-nowrap: 文本-强制不换行
  • word-wrap: 文本-强制换行
  • ellipsis: 多出部分用省略号表示 , 用于一行
  • ellipsis2: 多出部分用省略号表示 , 用于两行
  • ellipsis3: 多出部分用省略号表示 , 用于三行
  • flex: flex布局
  • flex-center: flex布局,水平居中
  • flex-middle: flex布局,垂直居中
  • flex-cm: flex布局,垂直、水平都居中
  • center: 在父元素中,水平、垂直居中;
  • mask: 遮罩层
  • bg: 背景图样式设置

reset

为了保持各类浏览器初始样式的一致性,执行格式重置;

normalize.css

normalize.css v8.0.1
来源地址:github.com/necolas/normalize.css

参考

  • 工具集utils: https://github.com/cd-dongzi/utils (star 190,css js)
  • 工具集outils: https://github.com/proYang/outils (start 1189 js)

文章名称:前端开发工具集eutils
标题URL:http://scjbc.cn/article/pdchhc.html

其他资讯