2.1.0 • Published 3 days ago

s94-web v2.1.0

Weekly downloads
-
License
ISC
Repository
-
Last release
3 days ago

s94-web

浏览器中常用工具库,类似jQuery,依赖了s94-js库

安装

$ npm install s94-web

使用

直接引入js方式

注1:s94-web中包含了s94-require模块,所以尽量保持s94-web模块在模块目录厘米。详情参考s94-require模块

注2:如果是“直接引入js方式”,也可以使用$代替s94

<script src="/node_modules/s94-web/s94.js" type="text/javascript" charset="utf-8"></script>
<!--调试模式-->
<script src="/node_modules/s94-web/s94.js?debug" type="text/javascript" charset="utf-8"></script>

require引入方式

var s94 = require('s94-web');

属性和方法

s94(selector) 基本方法

s94.__stack([index]) 获取js执行堆栈

s94.filename 文件的url地址

s94.dir 文件所在目录的url地址

s94.dirname(path) 计算path的上级目录地址

s94.debug 是否开启debug

s94.load(f) DOM结构加载完成后执行回调函数f

new s94.Ready(f) 函数队列对象

s94.extend(obj, data[, options]) 对象扩展

s94.type(obj) 返回obj参数的数据类型

s94.each(obj, callback[, thisArg]) 遍历obj对象(for in的语法糖)

s94.eachloop(obj, childkey, callback[, thisArg]) 递归遍历obj对象

s94.eachlimit(obj, op) 限制遍历obj对象

s94.merge(obj1[, obj2 ,...]) 合并多个对象,支持合并数组和对象

s94.sort(arr, ace) 使用自定义的规则对数组进行排序

s94.trim(str[, mask]) 去除字符串首尾的空格,传入mask参数可以额外去除对应字符

s94.reparam(str) 把urlparam类型字符串转化成对象

s94.param(obj) 把对象转化成urlparam类型字符串

s94.url(str[, base]) new URL()的低版本兼容

s94.encode(data) 把data编码成36位字符串(包含小写英文、数字)

new s94.Cache(engine) 示例化缓存对象

s94.cache(name[, value, timeout]) 缓存数据或者提取缓存的数据

s94.cache.clean([name]) 清理缓存数据

s94.ajax(setup) XMLHttpRequest同步异步请求

s94.loadJs(setup[, callback]) 异步加载js文件,加载完成执行回调

s94.screenOffsetPage([to, op, callback]) 屏幕相对于页面的偏移,或者滚动到指定位置

s94.domOffsetPage(dom) 元素相对于页面的偏移

s94.domOffsetParent(dom[, parent]) 元素doc相对于父级元素parent的偏移

s94.eventOffsetScreen(e) 获取事件触发定位,相对于屏幕

s94.eventOffsetTarget(e) 获取事件触发定位,相对于触发DOM节点

s94.eventOffsetDom(dom, e) 获取事件触发定位,相对于DOM节点

s94.date(fmt[, time]) 格式化时间日期

s94.strtodate(str, fmt) 字符转Date对象

s94.autoRequire(data) 自动加载模块注册

s94.lazy(doms) 懒加载

s94.log(obj[, note, depth]) 打印日志

s94.msg(data) 消息模块

s94.pjax(data) 无刷新跳转pjax模块

s94.rem rem系统

s94.Scroll 滚动事件模块

s94.Touch 触摸事件模块

s94(selector)

  • selector Function|String 传入的参数,不同参数,处理方法不同 - 传入Function:如果传入Function规定了传参,等同于new s94.Ready(f)。否则等同于s94.load(f) - 传入String:返回s94.fn对象。如果字符串包含“<”符号,当做HTML代码处理;否则当作选择器处理
  • 返回 s94.fn对象或者s94.Ready对象

    基本方法

//返回s94.fn对象
var $p1 = s94('p');
var $p2 = s94('<p>123</p>');

//等同于s94.load(f)
s94(function(){
	alert('加载完了');
})

//等同于new s94.Ready(f)
var ready = s94(function(next){
	setTimeout(function(){
		next()
	},1000)
})

s94.__stack(index)

  • index Number 序号,不传返回所有。0:s94.stack所在位置;1:执行“s94.stack方法”的闭包所在位置;2:执行“执行了s94.__stack方法”的闭包所在位置;3:依此类推
  • 返回 Object|Array 包含了执行流程中的文件url、行号、列号的Object或者包含所有Object的Array

    获取js执行堆栈,包含了执行流程中的文件url、行号、列号

//获取当前js代码执行所在的url地址
alert(s94.__stack(1)['file']);

//创建一个方法,执行方法的时候,获取执行时所在的url地址
function this_file(){
	return s94.__stack(2)['file'];
}

s94.dirname(path)

  • path String 路径,最好位http(s)协议
  • 返回 String 上级目录地址

    计算path的上级目录地址

var dir = s94.dirname('http://127.0.0.1/debug/index.html'); //http://127.0.0.1/debug

s94.debug

  • 返回 Boolean DEBUG状态

    获取或者设置DEBUG状态,DEBUG状态下,会进行错误监听。并把错误信息打印出了

s94.debug = true;
''.join(); //此处报错,会打印错误信息

s94.load(f)

  • f Function 执行的回调函数
  • 返回 Underfind

    DOM结构加载完成后执行回调函数f

s94.load(function(){
	//TODO....	
})
//简便写法
$(function(){
	//TODO....	
})

new s94.Ready(f)

  • f Function 队列执行的回调函数,方法接收两个参数(next, data) - next Function 表示队列中的下一个方法,用于在需要的地方和时候异步执行。或者f方法直接return非underfind数据也可以等同于执行next(如果f中没有执行next的,同时return的是underfind。表示终止流程,意味着,队列中后面的方法不再会执行。) - data Object 表示上一个方法传递过来的数据,可能是上一个f中next([data])执行的传参,也可能是上一个f中return的非underfind数据
  • 返回 s94.Ready 对象

    创建函数队列对象,s94.Ready的原型方法then可以用于插入下一个需要执行的方法

s94.ReadyPromise类似,但是在处理大量异步执行队列的时候,s94.Ready更加简洁。Promise有两个状态指示,主要异步优化,可以直接获取异步操作句柄,方便调用异步返回结果。而s94.Ready的只有一个用来表示执行下一个方法,具体的判断和是否终止执行队列,需要用户自己在回到函数里面判断,主要用于队列执行的流程,例如动画等需要按步骤进行的异步操作

var ready = new s94.Ready(function(next){
	//TODO....	
})
//简便写法
var ready = $(function(next){
	//TODO....	
})
//解和then的用法
var r = $(function(next, data){
	console.log('选择食物中。。。');
	setTimeout(function () {
		console.log('下好订单了,顶单号:1');
		next(1);
	},1000)
}).then(function(next, data){
	console.log('收到订单,顶单号:'+data+'。开始制作');
		setTimeout(function () {
			console.log('制作完成,开始准备派送,排送员:XXX');
			next('XXX');next('XX2X');
		},1000)
}).then(function(next, data){
	console.log('排送员:'+data+'接到商品,开始派送');
		setTimeout(function(){
			console.log('商品送达,接收人没在,放在了存放点,取件码:123');
			next('123');
		},1000)
})
setTimeout(function(){
	r.then(function(next, data){
		console.log('想起来要去取件,查看取件码:'+data)
	})
},5000)

s94.extend(obj, data, options)

  • obj Object 需要扩展的对象
  • data Object {key: value},包含扩展的键、值
  • options Object 属性描述符,具体参考Object.defineProperty() ,只能规定数据描述符的configurable、enumerable、writable这三个参数
  • 返回 Underfind

    对obj对象进行扩展

var Obj = function(name, age){
	this.name = name || '未知';
	this.age = age || 0;
}
//普通的对象扩展不够精细,扩展的属性或方法是否可修改,是否枚举这些都无法控制
Obj.prototype.myname = function(){
	console.log(this.name);
}
//使用Object.defineProperty()做精细的扩展,使myname方法不能修改,不能删除,但是可以枚举
Object.defineProperty(Obj.prototype, 'myname', {
	value: function(){
		console.log(this.name);
	},
	enumerable: true,
})
//s94.extend是Object.defineProperty()方法的简化,并且方便批量扩展多个属性或者方法
s94.extend(Obj.prototype, {
	myname: function(){
		console.log(this.name);
	},
	myage: function(){
		console.log(this.age);
	},
},{enumerable: true});

s94.fn.prototype.extend(data, options)

对s94.fn.prototype对象进行扩展的版本

	s94.fn.extend(data);
	//等同写法
	s94.extend(s94.fn.prototype, data);
	//示例
	s94.fn.extend({getName: function(){
		return this[0].nodeName;
	}})
	console.log(s94('.class').getName())

s94.type(obj)

  • obj Object 判断的数据
  • 返回 String 数据类型,就是对象的名称

    返回obj参数的数据类型

s94.type({a:1}); // Object
s94.type([1,2]); // Array
s94.type(new Date()); // Date

function Obj(){}
s94.type(new Obj()); // Obj

s94.each(obj, callback, thisArg)

  • obj Object 遍历的对象
  • callback Function 遍历时执行的回调函数,接收三个参数,类似Array.prototype.forEach,函数返回false终止遍历
  • thisArg Object callback执行的this
  • 返回 Underfind

    遍历obj对象(for in的语法糖)

var obj = {a:1, b:2}

s94.each(obj, function(row, i, o){
	//row 正在处理的当前元素。
	//i 当前元素的键值。
	//o 正在操作的对象,等同于obj
	console.log(i+':'+row)
});
//打印 a:1
//打印 a:2

s94.each(obj, function(row, i, o){
	//row 正在处理的当前元素。
	//i 当前元素的键值。
	//o 正在操作的对象,等同于obj
	console.log(i+':'+row);
	return false;
});
//打印 a:1

s94.fn.prototype.each(callback, thisArg)

  • callback Function 遍历时执行的回调函数,接收三个参数,类似Array.prototype.forEach,函数返回false终止遍历
  • thisArg Object callback执行的this
  • 返回 Underfind

    s94对象的each方法扩展

<div class="class"></div>
<div class="class"><p></p><p></p></div>
s94('.class').each(function(row, i, o){
	//row 正在处理的当前Node元素。
	//i 当前元素的序号。
	//o 正在操作的s94对象,等同于s94('.class')
	console.log(i+':'+row)
})
//打印 0:[object HTMLDivElement]
//打印 1:[object HTMLDivElement]

s94.eachloop(obj, childkey, callback, thisArg)

  • obj Object 遍历的对象
  • childkey String 需要递归遍历的属性名,为空表示直接递归遍历正在处理的当前元素。
  • callback Function 遍历时执行的回调函数,接收四个参数,相比于s94.each,第四个参数记录了键值路径,函数返回false终止遍历,返回underfind不递归遍历当前元素
  • thisArg Object callback执行的this
  • 返回 Underfind

    遍历obj对象(for in的语法糖)

var obj = {
	a: 'a',
	arr: [1,2,3],
	obj: {a:1, b:2}
}
s94.eachloop(obj, '', function(row, i, o, ks){
	//row 正在处理的当前元素。
	//i 当前元素的键值。
	//o 正在操作的对象,等同于obj
	//ks 键值路径
	console.log(ks+':'+row);
	return true
})
//a:a
//arr:1,2,3
//arr,0:1
//arr,1:2
//arr,2:3
//obj:[object Object]
//obj,a:1
//obj,b:2

var list = [
	{name: 'dir1',open:false, child:[
		{name: 'file1'},
		{name: 'file2'}
	]},
	{name: 'dir2',open:true, child:[
		{name: 'file3'},
		{name: 'file4'}
	]},
]
s94.eachloop(list, 'child', function(row, i, o, ks){
	console.log(row.name);
	if(row.open) return true;
});
//dir1
//dir2
//file3
//file4

s94.fn.prototype.eachloop(callback, thisArg)

  • callback Function 遍历时执行的回调函数,接收四个参数,相比于s94.each,第四个参数记录了键值路径,函数返回false终止遍历,返回underfind不递归遍历当前元素
  • thisArg Object callback执行的this
  • 返回 Underfind

    s94对象的eachloop方法扩展,childkey为children

<div class="class"></div>
<div class="class"><p></p><p></p></div>
s94('.class').eachloop( function(row, i, o, ks){
	console.log(ks+':'+row.nodeName);
	return true;
});
//
//打印 0:DIV
//打印 1:DIV
//打印 1,0:P
//打印 1,1:P

s94.eachlimit(obj, op)

  • obj Object 遍历的对象
  • op Function|Object 配置参数,如果为Function,表示op.each - limit Number 限制同时执行的数量,默认为100 - each Function 遍历执行的回调函数,each(next, row, k),当前遍历执行完成后,调用next表示进行下一个row的遍历 - over Function 遍历结束后的回调函数,over(obj)
  • 返回 Underfind

    限制遍历obj对象,主要用于不能同时遍历的情况,例如大批量的ajax请求,可以用eachlimit防止同时请求数量太多

var obj = [
	{name: 'name1', url: 'url1'},
	{name: 'name2', url: 'url2'},
	{name: 'name3', url: 'url3'},
	{name: 'name4', url: 'url4'},
	{name: 'name5', url: 'url5'},
	//......
	{name: 'name10000', url: 'url10000'},
]

s94.eachlimit(obj, {
	limit: 50,
	each: function(next, row, k){
		$.ajax({
			url: row.url,
			success: function(res){
				row.res = res;
				next();
			}
		})
	},
	over: function(){
		alert('下载完成')
	}
});

s94.merge(obj1, obj2 ,...)

  • obj1、obj2 Object 用于合并的多个对象
  • 返回 Object 合并后的对象

    合并多个对象,支持合并数组和对象。返回新的对象,不改变传入的对象

var obj1 = {a:1,b:2};
var obj2 = [1,2];

var res1 = s94.merge(obj1, obj2);
var res2 = s94.merge(obj2, obj1);

console.log( s94.type(res1), res1 );//打印Object {0: 1, 1: 2, a: 1, b: 2, length: 2, push: ƒ}
console.log( s94.type(res2), res2 );//打印Array (2) [1, 2, a: 1, b: 2]

s94.sort(arr, ace)

  • arr Array 排序的数组
  • ace Function 判断的回调方法ace(a, b),返回表示a,b是否按顺序排列
  • 返回 Array 排序后的数组

    使用自定义的规则对数组进行排序,用于弥补Array.prototype.sort()的不足

var arr = ['10','23','2','3','1'];
console.log( arr.sort() ); //打印['1', '10', '2', '23', '3']
console.log( s94.sort(arr, function(a, b){
	return Number(a) < Number(b);
}) ); //打印['1', '2', '3', '10', '23']
//倒序
console.log( s94.sort(arr, function(a, b){
	return Number(a) > Number(b);
}) ); //打印['23', '10', '3', '2', '1']

s94.trim(str, mask)

  • str String 操作的字符串
  • mask String 额外需要去除的对应字符
  • 返回 Object 合并后的对象

    去除字符串首尾的空格或者其他字符串

var str = '$ hello world ';

console.log( s94.trim(str) );//打印$ hello world
console.log( s94.trim(str, 'd$') );//打印hello worl

s94.reparam(str)

  • str String 操作的字符串
  • 返回 Object 转化后的对象

    把urlparam类型字符串转化成对象

var str = 'name=name1&pass=123456';
console.log( s94.reparam(str) );//打印{name: "name1", pass: "123456"}

//比较复杂的
var str = 'a=a&arr[]=1&arr[]=2&arr[]=3&obj[a]=1&obj[b]=2';
console.log( s94.reparam(str) );//打印{a: "a", arr: Array(3), obj: {…}}

s94.param(obj)

  • str String 操作的对象
  • 返回 Object 转化后的字符串

    把对象转化成urlparam类型字符串

var str = 'name=name1&pass=123456';
var obj = s94.reparam(str);

console.log( obj );//打印{name: "name1", pass: "123456"}
console.log( s94.param(obj) );//打印name=name1&pass=123456

//比较复杂的
var obj = {
	a: 'a',
	arr: [1,2,3],
	obj: {a:1, b:2}
}
var str =  s94.param(obj);
console.log( str );//打印a=a&arr[0]=1&arr[1]=2&arr[2]=3&obj[a]=1&obj[b]=2

s94.url(str, base)

  • str String 是一个表示绝对或相对 URL字符串
  • base String 如果str是一个相对URL,将以此地址为基础
  • 返回 URL URL对象,包含字段有href,protocol,username,password,host,hostname,port,origin,pathname,search,hash

    创建URL对象

s94.url('../index.html', 'http://localhost/html/s94.html');
// hash: ""
// host: "localhost"
// hostname: "localhost"
// href: "http://localhost/index.html"
// origin: "http://localhost"
// password: ""
// pathname: "/index.html"
// port: ""
// protocol: "http:"
// search: ""
// searchParams: URLSearchParams {}
// username: ""

s94.encode(data)

  • data Object 编码对象
  • 返回 String 编码后的编码成36位字符串(包含小写英文、数字)

    把data编码成36位字符串(包含小写英文、数字),主要是用来压缩对象,并且避免重复

console.log(s94.encode('123'));//打印1e3h5k6789abcdefghijklmnopqrstuvwxyz
console.log(s94.encode('321'));//打印1g3h5i6789abcdefghijklmnopqrstuvwxyz
var obj = {
	a: 'a',
	arr: [1,2,3],
	obj: {a:1, b:2}
}
console.log(s94.encode(obj));//打印6w568l9dfqidknk0kxoanoptqtvjxpzz0z11

new s94.Cache(engine)

  • engine Object 设定的Cache的引擎,包含方法setItem、getItem、removeItem参考Storage。默认为window.sessionStorage
  • 返回 Object 缓存示例,包含:
    • get(name, def) 获取缓存名为name的缓存值,如果缓存不存在,返回def
    • set(kv, timeout) 按kv的键值关系设定缓存,键和值分别表示缓存名和对应的值,timeout为过期的时间戳(毫秒),判定为false时表示永久 -remove(name) 移除缓存缓存name

s94.cache(name_kv, def_timeout)

  • name_kv String|Object 缓存名称或者设定缓存的键值对象。如果传入String表示获取缓存的name,如果传入键值对象,表示设定缓存的ky
  • def_timeout mixed 获取缓存的缺省值def,或者缓存过期的时间戳timeout
  • engine Object 设定的Cache的引擎
  • 返回 mixed 如果是获取缓存,返回对应的缓存值,如果缓存数据不存在,返回缺省值。如果传入value,返回underfind

s94.cache.remove(name, engine)

  • name String 缓存名称
  • engine Object 设定的Cache的引擎
  • 返回 Underfind

缓存数据或者提取缓存的数据

s94.cache({'name1':123});
console.log(s94.cache('name1'));//打印123
s94.cache.remove('name1');//移除缓存

//使用其他引擎-方式1 var c = new s94.Cache(localStorage); c.set({'name2':456}); console.log(c.get('name2'));//打印456 c.remove('name2');//移除缓存 //使用其他引擎-方式2 s94.cache({'name3':789}, 0, localStorage); console.log(s94.cache('name3', undefined, localStorage));//打印789 s94.cache.remove('name3', localStorage);//移除缓存

//使用自定义引擎 var engine = { setItem: function(keyName, keyValue){ //设定缓存操作... }, getItem: function(keyName){ //获取缓存操作... }, removeItem: function(keyName){ //移除缓存操作... } } s94.cache({'name4':789}, 0, engine); //。。。。。。

<p id="ajax"></p>

## **s94.ajax(setup)** 
- setup `Object|String` 配置对象,也可以单传入url
	- type `String` 请求类型,不分大小写,GET,POST,JSONP,默认GET
	- url `String` 请求地址
	- data `Object` 请求发送数据
	- headers `Object` 请求的header
	- jsonp `String` 如果是jsonp请求,请求附加的参数的键值,默认为callback
	- jsonpCallback `String` 如果是jsonp请求,请求附加的参数的值,默认为`'jsonp_'+(new Date().getTime())`
	- async  `Boolean` 是否异步,默认true
	- global  `Boolean` 是否全局广播事件,默认true
	- cache  `Boolean` 是否缓存数据,默认false
	- refresh  `Boolean` 如果缓存数据,当网络请求结果和缓存的数据不同时,是否刷新(再次调用success),默认true
	- progress  `Function` 进度事件回调函数,接收一个参数[ProgressEvent](https://developer.mozilla.org/zh-CN/docs/Web/API/ProgressEvent)
	- beforeSend  `Function` 请求执行前执行的回调函数
	- success  `Function` 请求成功的回调,接收一个参数,表示响应数据,如果响应数据类型为json,会调用JSON.parse
	- error  `Function` 请求出错的回调函数,接收一个参数,表示错误信息
	- complete  `Function` 请求完成的回到函数,接收一个参数,表示请求是否成功
- 返回 `Object` 修改后的setup,添加了属性cleanCache,xhr。同时也是所有回调函数的this
>ajax同步或者异步请求
```js
s94.ajax({
	url: 'url.....',
	cache: true,
	success: function(res){
		if(res.code!=1) {
			this.cleanCache(); //当返回结果错误后,清理缓存,避免多次报错处理
		}
		console.log(res);
	}
})

s94.loadJs(setup, callback)

  • setup String|Array|Object 配置对象,也可以单传入src - src String|Array 加载js的地址,多个地址用数组 - refresh Boolean 是否刷新,如果刷新,则需要引入的js已经存在同样会引入 - load Function 每个js加载成功后,会执行的回调函数,传入一个参数,当前加载的js节点对象 - error Function 当某个js加载失败后会执行的回调函数,传入一个参数,当前加载的js节点对象
  • callback Function 当src中的所有js加载完成后执行的回调函数,传入一个参数,加载的所有js节点列表数组
  • 返回 underfind

    异步加载js文件,加载完成执行回调

s94.loadJs(['js1.js','js2.js'], function(){
	console.log('加载完成了')
})

s94.screenOffsetPage(to, op, callback)

  • to Number|Object 偏移跳转到坐标to,格式{x:像素,y:像素},如果传入Number单表示Y坐标
  • op Object|Number {speed: 执行速度(px/s)}或者{time: 执行时间(毫秒),传入Number表示time
  • callback Function 动画执行结束后执行的回调函数
  • 返回 Object 偏移量{x: X偏移量,y: Y偏移量}

    屏幕相对于页面的偏移,或者滚动到指定位置

console.log(s94.screenOffsetPage());//打印{x: 0, y: 0}

//执行滚动到500px处,速度哦1000px/s
s94.screenOffsetPage(500, {speed: 1000});

s94.domOffsetPage(dom)

  • dom Node 节点对象
  • 返回 Object 偏移量{x: X偏移量,y: Y偏移量}

    元素相对于页面的偏移

console.log( s94.domOffsetPage(document.querySelector('.class')) );//打印{x: 0, y: 0}
//便捷写法
console.log( s94('.class').domOffsetPage() );//打印{x: 0, y: 0}

s94.domOffsetParent(dom, parent)

  • dom Node 节点对象
  • parent Node 父节点对象,默认为dom.parentNode
  • 返回 Object 偏移量{x: X偏移量,y: Y偏移量}

    元素dom相对于父级元素parent的偏移

console.log( s94.domOffsetParent(document.querySelector('.class'), document.querySelector('body')) );//打印{x: 0, y: 0}
//便捷写法
console.log( s94('.class').domOffsetParent(document.querySelector('body')) );//打印{x: 0, y: 0}

s94.eventOffsetScreen(e)

  • e Event 事件对象,默认为window.event
  • 返回 Object 偏移量{x: X偏移量,y: Y偏移量}

    获取事件触发定位,相对于屏幕

console.log( s94.eventOffsetScreen() );//打印{x: 20, y: 58}

s94.eventOffsetTarget(e)

  • e Event 事件对象,默认为window.event
  • 返回 Object 偏移量{x: X偏移量,y: Y偏移量}

    获取事件触发定位,相对于触发DOM节点

console.log( s94.eventOffsetTarget() );//打印{x: 20, y: 58}

s94.eventOffsetDom(dom, e)

  • dom Node 节点对象
  • e Event 事件对象,默认为window.event
  • 返回 Object 偏移量{x: X偏移量,y: Y偏移量}

    获取事件触发定位,相对于DOM节点,如果

console.log( s94.eventOffsetDom(document.querySelector('.class') );//打印{x: 20, y: 58}
//便捷写法
console.log( s94('.class').eventOffsetDom() );//打印{x: 20, y: 58}

s94.date(fmt, time)

  • fmt String 格式化样式模板,如果模板需要YMDHISWymdhisw字符串的,需要在前面加\ - Y|y 表示年份 - M|m 表示月份(1-12),大写的表示有前导0的, - D|d 表示当月的第几天(1-31),大写的表示有前导0的, - H|h 表示小时数量(0-23),大写的表示有前导0的, - I|i 表示分钟(0-59),大写的表示有前导0的, - S|s 表示秒(0-59),大写的表示有前导0的, - W|w 表示星期几,大写的表示汉字的(一-日),小写的表示数字(1-7)
  • time String|Number 需要格式化的时间,参数格式参考new Date(),默认为当前时间
  • 返回 String 格式化后的时间日期字符串

    格式化时间日期

console.log( s94.date( 'Y-M-D H:I:S') );//打印2022-06-15 09:11:18
//指定时间
console.log( s94.date( 'Y-M-D H:I:S', 1655255526000) );//打印2022-06-15 09:12:06
console.log( s94.date( 'Y-M-D H:I:S', '2022-06-15T09:12:06') );//打印2022-06-15 09:12:06
//模板中需要[YMDHISWymdhisw]字符串
console.log( s94.date( '<\\span>m-d W</\\span>', 1655255526000) );//打印<span>6-15 三</span>

s94.strtodate(str, fmt)

  • str String 转化的字符串
  • fmt String 格式化样式模板,格式等同s94.date
  • 返回 Date 日期对象

    格式化时间日期

var str = s94.date( 'Y-M-D H:I:S');
console.log( s94.strtodate( str, 'Y-M-D H:I:S') );//打印Wed Jun 15 2022 09:12:06 GMT+0800 (中国标准时间)

//字符串中没有指定的数据,会按最小值替换
console.log( s94.strtodate('<span>09:12:06</span>', '<\\span>H:I:S</\\span>') );//打印Thu Jan 01 1970 09:12:06 GMT+0800 (中国标准时间)

s94.autoRequire(data)

  • data Object 注册的自动加载模块{key: moduleName}
  • 返回 underfind

    自动加载模块注册,注册时,页面不会加载模块,只会在第一次使用时require需要的模块

s94.autoRequire({
	Vue: 'Vue',//模块名称的方式
	imgclip: '/node_modules/s94-imgclip/s94.ImgClip.js',//模块文件路径的方式
	md5: 'md5'
})
//注册后,可以直接使用s94.[key]调用
//调用的模块才会加载,仅注册,没调用的模块,不会加载
var app = s94.Vue.createApp({}); //加载Vue模块,并且创建APP
var imgclip = new $.ImgClip(document.querySelector('#imgclip'));//加载s94.ImgClip.js,并创建剪切组件
//由于md5模块没有调用,所有,页面中不会加载md5模块相关的js

clip(type, quality)

toBase64的别名

console.log(imgclip.clip()); //data:image/png;base64,iVBOR.....

toBlob(callback, type, quality)

  • callback Function 回调函数,用于接收裁剪后图片的Blob数据
  • type String 表示生成图片类型jpg,png,webp。(默认值:png)
  • quality Number 表示生成图片质量0-1
  • 返回 Promise|underfind

    输出裁剪图片,返回图片的blob数据

imgclip.toBlob(function(blobData){
	console.log(blobData);
});
//支持使用Promise异步调用
imgclip.toBlob().then(function(blobData){
	console.log(blobData);
});
2.1.0

3 days ago

2.0.2

25 days ago

2.0.1

26 days ago

2.0.0

26 days ago

1.2.0

28 days ago

1.1.96

3 months ago

1.1.99

3 months ago

1.1.98

3 months ago

1.1.97

3 months ago

1.1.95

4 months ago

1.1.94

4 months ago

1.1.93

4 months ago

1.1.92

5 months ago

1.1.91

5 months ago

1.1.90

5 months ago

1.1.89

5 months ago

1.1.88

5 months ago

1.1.87

5 months ago

1.1.86

5 months ago

1.1.85

5 months ago

1.1.84

5 months ago

1.1.83

5 months ago

1.1.81

6 months ago

1.1.80

6 months ago

1.1.82

6 months ago

1.1.74

10 months ago

1.1.73

11 months ago

1.1.72

11 months ago

1.1.78

10 months ago

1.1.77

10 months ago

1.1.76

10 months ago

1.1.75

10 months ago

1.1.79

10 months ago

1.1.70

1 year ago

1.1.71

1 year ago

1.1.63

1 year ago

1.1.62

1 year ago

1.1.61

1 year ago

1.1.67

1 year ago

1.1.66

1 year ago

1.1.65

1 year ago

1.1.64

1 year ago

1.1.69

1 year ago

1.1.68

1 year ago

1.1.56

1 year ago

1.1.55

1 year ago

1.1.54

2 years ago

1.1.53

2 years ago

1.1.59

1 year ago

1.1.58

1 year ago

1.1.57

1 year ago

1.1.60

1 year ago

1.1.52

2 years ago

1.1.34

2 years ago

1.1.38

2 years ago

1.1.37

2 years ago

1.1.36

2 years ago

1.1.35

2 years ago

1.1.39

2 years ago

1.1.41

2 years ago

1.1.40

2 years ago

1.1.45

2 years ago

1.1.44

2 years ago

1.1.43

2 years ago

1.1.42

2 years ago

1.1.49

2 years ago

1.1.48

2 years ago

1.1.47

2 years ago

1.1.46

2 years ago

1.1.51

2 years ago

1.1.50

2 years ago

1.1.29

2 years ago

1.1.28

2 years ago

1.1.30

2 years ago

1.1.33

2 years ago

1.1.32

2 years ago

1.1.31

2 years ago

1.1.12

2 years ago

1.1.11

2 years ago

1.1.10

2 years ago

1.1.16

2 years ago

1.1.15

2 years ago

1.1.14

2 years ago

1.1.13

2 years ago

1.1.19

2 years ago

1.1.18

2 years ago

1.1.17

2 years ago

1.1.23

2 years ago

1.1.22

2 years ago

1.1.21

2 years ago

1.1.20

2 years ago

1.1.27

2 years ago

1.1.26

2 years ago

1.1.25

2 years ago

1.1.24

2 years ago

1.1.1

2 years ago

1.1.0

2 years ago

1.0.16

2 years ago

1.1.9

2 years ago

1.1.8

2 years ago

1.1.7

2 years ago

1.1.6

2 years ago

1.1.5

2 years ago

1.1.4

2 years ago

1.1.3

2 years ago

1.1.2

2 years ago

1.0.11

2 years ago

1.0.15

2 years ago

1.0.14

2 years ago

1.0.13

2 years ago

1.0.12

2 years ago

1.0.9

2 years ago

1.0.10

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago