fish.js
v0.0.2
Published
a easy , simple and usual js,help developers reduce operations
Downloads
2
Readme
fish.js
一个封装了常用js的node库，包含cookie处理、事件处理、对象排序等等，现在只是封装了工作中常用的方法，其他的还需要完善。。
API
使用时直接获取 let fish = require('fish.js');
fish目前封装了几种常用的js，每一种封装成一个对象
目前有以下几种类型方法
eventUtil 事件类型相关的
cookieUtil cookie相关
commonUtil 一些基本常用的
mathUtil 计算相关的，主要是解决js精度计算问题
具体使用则单独调用各个对象的方法
/**
* @description 添加事件
* @param {element} 添加事件的元素
* @param {type} 事件类型
* @param {handler} 绑定的函数
**/
fish.eventUtil.addHandler(element, type, handler);
/**
* @description 删除事件
* @param {element} 删除事件的元素
* @param {type} 事件类型
* @param {handler} 需要删除的函数
**/
fish.eventUtil.removeHandler(element, type, handler);
/**
* @description 获取event
* @param {event} event对象
**/
fish.eventUtil.getEvent(event);
/**
* @description 获取event.type
* @param {event} event对象
**/
fish.eventUtil.getType(event);
/**
* @description 获取事件源
* @param {event} event对象
**/
fish.eventUtil.getElement(event);
/**
* @description 阻止浏览器默认行为
* @param {event} event对象
**/
fish.eventUtil.preventDefault(event);
/**
* @description 阻止冒泡
* @param {event} event对象
**/
fish.eventUtil.stopPropagation(event);
/**
* @description 禁止用F5键 （兼容IE和firefox）
* @param {e} event对象
**/
fish.eventUtil.stopF5(event);
/**
* @description 事件委托
* 给指定的标签（例如 li标签）添加
* @param {target} 目标对象
* @param {type} 触发的事件 不带'on'
* @param {fn} 方法
*
**/
fish.eventUtil.delegateEvent(target, type, fn);
/**
* @description 设置cookie
* @param {name} cookie名称
* @param {value} cookie值
* @param {day} 有效期（天）
**/
fish.cookieUtil.setCookie(name, value, day);
/**
* @description 获取cookie
* @param {name} cookie名称
**/
fish.cookieUtil.getCookie(name);
/**
* @description 删除cookie
* @param {name} cookie名称
**/
fish.cookieUtil.delCookie(name);
/**
* @description 通过ID获取元素
* @param {eleId} 元素id
**/
fish.commonUtil.getById(id);
/**
* @description 通过父级id和类名获取元素
* @param {fatherId} 查找元素的父元素id
* @param {className} 查找元素的类名
* @author YouNoFish
**/
fish.commonUtil.getByClass(fatherId, className);
/**
* @description 从url地址里面获取参数，这个可以用于html之间的传值使用
* @return {oJson}
*/
fish.commonUtil.getParamFromURL();
/**
* @description 普通数组排序 list.sort(commonUtil.normalSort('desc')); list.sort(commonUtil.normalSort('asc'));
* @return
*/
fish.commonUtil.normalSort(orderBy);
/**
* @description 对象数组排序 list.sort(commonUtil.objectSort('score','desc'));
* @param {propertyName} 进行排序的对象属性
* @param {type} 排序类型 desc 或者 asc
* @return
*/
fish.commonUtil.objectSort(propertyName, orderBy);
/**
* @description 去除字符串左边的空格
* @param {str} 进行操作的字符串
* @return
*/
fish.commonUtil.trimL(str);
/**
* @description 去除字符串右边的空格
* @param {str} 进行操作的字符串
* @return
*/
fish.commonUtil.trimR(str);
/**
* @description 去除字符串两边边的空格
* @param {str} 进行操作的字符串
* @return
*/
fish.commonUtil.trim(str);
/**
* @description 通过radio的name获取单选框的值
* @param {name} 单选框的name
* @return
*/
fish.commonUtil.getRadioValue(name);
/**
* @description 在目标节点后插入新元素
* @param {newElement} 新元素节点
* @param {targetElement} 目标节点
* @return
*/
fish.commonUtil.insertAfter(newElement, targetElement);
/**
* @description 字符串格式化 fish.commonUtil.strFormat('测试替换{0}文字{1}，可以无限长{2}','第一个','第二个','第三个');
* @param {str} 字符串
* @param {params} 格式化的参数
* @return
*/
fish.commonUtil.strFormat();
/**
* @description 时间转换器
* @param {time} 时间(支持时间戳和Date)
* @param {format} 转换的格式 eg:yyyy年MM月dd日 HH时mm分ss秒 fish.commonUtil.timeFormat(new Date(), 'yyyy年MM月dd日 HH时mm分ss秒');
* @return timeStr
*/
fish.commonUtil.timeFormat(time, format);
/**
* @description 根据长度截取字符串
* @param {_str} 字符串
* @param {_length} 截取后剩余的长度
* @return timeStr
*/
fish.commonUtil.cutStr(_str, _length);
/**
* 精确计算加法
* @param {Number} value1
* @param {Number} value2
* @param {Number} [precision] 计算后的精度，默认为两个操作数中的较大的小数位数
* @param {Boolean} [full] 完整精度，默认为false，1.00将显示为1；为true时1.00将显示为1.00
* @example
* var a=8.2;
* var b=0.2;
* console.log(a+b);//8.399999999998 计算结果有误差
* console.log(mathUtil.add(a,b);//8.4
* a=0.1;
* b=0.2;
* console.log(a + b); //0.30000000000000004
* console.log(mathUtil.add(0.1,0.2,2)); //0.3
* @return {Number} 计算结果
*/
fish.mathUtil.add(value1, value2, precision, full);
/**
* 精确计算减法
* @param {Number} value1
* @param {Number} value2
* @param {Number} [precision] 计算后的精度，默认为两个操作数中的较大的小数位数
* @param {Boolean} [full] 完整精度，默认为false，1.00将显示为1；为true时1.00将显示为1.00
* @example
* var a=8.2;
* var b=0.2;
* console.log(a-b);//7.999999999999999 计算结果有误差
* console.log(mathUtil.sub(a,b);//8
* @return {Number} 计算结果
*/
fish.mathUtil.sub(value1, value2, precision, full);
/**
* 精确计算乘法
* @param {Number} value1
* @param {Number} value2
* @param {Number} [precision] 计算后的精度，默认为两个操作数中的较大的小数位数
* @param {Boolean} [full] 完整精度，默认为false，1.00将显示为1；为true时1.00将显示为1.00
* @example
* var a = 8888.1;
* var b = 0.0002;
* console.log(a * b); //1.7776200000000002
* console.log(mathUtil.mul(a,b,2)); //1.78
* console.log(mathUtil.mul(a,b,6)); //1.77762
* console.log(mathUtil.mul(a,b,6,true)); //1.777620
* @return {Number} 计算结果
*/
fish.mathUtil.mul(value1, value2, precision, full);
/**
* 精确计算除法
* @param {Number} value1
* @param {Number} value2
* @param {Number} [precision] 计算后的精度，默认为两个操作数中的较大的小数位数
* @param {Boolean} [full] 完整精度，默认为false，1.00将显示为1；为true时1.00将显示为1.00
* @return {Number} 计算结果
*/
fish.mathUtil.div(value1, value2, precision, full);
更新
2017.07.13
- 第一次提交
2017.07.17
- 完善API文档