1.0.5 • Published 8 months ago

wil-utils v1.0.5

Weekly downloads
-
License
ISC
Repository
-
Last release
8 months ago

wil-utils

常用工具集合

Demo示例
前往Gitee

  1. query: 获取url参数值
  2. throttle: 截流函数
  3. debounce:延迟/弹簧函数
  4. cookie 操作
  5. webview webview 环境检测
  6. hash 查询/添加 location.hash
  7. scrollToDistance 缓动滚动到某段距离
  8. emoji2Unicode emoji表情字符转Unicode

安装

npm install wil-utils --save

API

query 模块

import { query } from 'wil-utils';
// http://192.168.31.74:8080/test.html?a=122
console.log('query a的值为:', query.get('a'));  // 122
console.log('query a=100:', query.add(location.href, 'a', 100)); // 返回http://192.168.31.74:8080/test.html?a=100

query.get(key)

返回location.href的query值

属性类型默认值是否必填说明
keyString

query.add(url, key, value)

给指定的url字符串增加query值并返回

属性类型默认值是否必填说明
urlString
keyString
valueString|Number

throttle 模块

截流函数

import { throttle } from 'wil-utils';
throttle(function () {
  console.log('touch move');
}, 150);

Option

参数类型是否必填描述
fnFunction传入需要截流的函数
intervalNumber间隔执行时间,单位是毫秒
immediatelyBoolean是否需要立即执行一次

debounce 模块

防抖函数

import { debounce } from 'wil-utils';
debounce(function () {
  console.log('handle click');
}, 150);

Option

param类型描述
fnFunction实际要执行 debounce的函数
delayNumber延迟时间,单位是毫秒

cookie 模块

import { cookie } from 'wil-utils';
cookie.set('tel', '18600000001');
cookie.get('tel');

cookie.get(key)

param类型描述
KeyString获取的cookie键值

cookie.set(key, value, domain, second, path)

param类型描述默认值
KeyString设置的cookie key必填
valueString设置的cookie value必填
domainString设置的cookie domain
secondNumber设置的cookie 的过期时间(秒)
pathString设置的cookie path

webview 模块

检测当前浏览器环境

import { webview } from 'wil-utils';
console.log(webview.isApple);
属性说明
isWeibo是否是微博客户端内
isQQ是否是QQ客户端内
isDingtalk是否是钉钉客户端内
isWeixin是否是微信客户端内
isAndroid是否是安卓设备
isApple是否是苹果设备
isIphone是否是IPhone设备
iphoneXSet是否是全面屏的iPhone设备
isTablet是否是平板设备
isIpad是否是iPad设备
isAndroidTable是否是安卓平板设备

hash 模块

import { hash } from 'wil-utils';
console.log(hash.get('tel'));

hash.get(key)

返回location.hash中某个key的值

属性类型默认值是否必填说明
keyString要查询的字段名

hash.add(key, value)

location.hash添加某个格式为key=value的值

属性类型默认值是否必填说明
keyString字段名
valueString|Number字段值

scrollToDistance

scrollToDistance(container, distance, duration, cb);

参数类型默认值是否必填说明
containerdom滚动容器
distanceNumber相对当前所处位置的滚动距离,负值表示向下滚动,正值表示向上滚动
durationNumber滚动时长,毫秒
cbFunction滚动结束回调

emoji2Unicode

emoji2Unicode(str);

参数类型默认值是否必填说明
strstring带emoji(😊)表情的字符串
1.0.5

8 months ago