2 Base
优质
小牛编辑
133浏览
2023-12-01
基础类,提供一些简单常用的方法。
create
- Base.create( opts ) ⇒ Uploader
创建Uploader实例,等同于new Uploader( opts );
version
当前版本号。
$
引用依赖的jQuery或者Zepto对象。
browser
简单的浏览器检查结果。
webkit
webkit版本号,如果浏览器为非webkit内核,此属性为undefined
。chrome
chrome浏览器版本号,如果浏览器为chrome,此属性为undefined
。ie
ie浏览器版本号,如果浏览器为非ie,此属性为undefined
。暂不支持ie10+firefox
firefox浏览器版本号,如果浏览器为非firefox,此属性为undefined
。safari
safari浏览器版本号,如果浏览器为非safari,此属性为undefined
。opera
opera浏览器版本号,如果浏览器为非opera,此属性为undefined
。
os
操作系统检查结果。
android
如果在android浏览器环境下,此值为对应的android版本号,否则为undefined
。ios
如果在ios浏览器环境下,此值为对应的ios版本号,否则为undefined
。
inherits
- Base.inherits( super ) ⇒ child
- Base.inherits( super, protos ) ⇒ child
- Base.inherits( super, protos, statics ) ⇒ child
参数:
super
{Class}父类protos
{Object, Function} [可选]子类或者对象。如果对象中包含constructor,子类将是用此属性值。constructor
{Function} [可选]子类构造器,不指定的话将创建个临时的直接执行父类构造器的方法。
statics
{Object} [可选]静态属性或方法。
返回值:
- {Class}返回子类。
实现类与类之间的继承。
function Person() {
console.log( 'Super' );
}
Person.prototype.hello = function() {
console.log( 'hello' );
};
var Manager = Base.inherits( Person, {
world: function() {
console.log( 'World' );
}
});
// 因为没有指定构造器,父类的构造器将会执行。
var instance = new Manager(); // => Super
// 继承子父类的方法
instance.hello(); // => hello
instance.world(); // => World
// 子类的__super__属性指向父类
console.log( Manager.__super__ === Person ); // => true
noop
一个不做任何事情的方法。可以用来赋值给默认的callback.
bindFn
- Base.bindFn( fn, context ) ⇒ Function
返回一个新的方法,此方法将已指定的context
来执行。
var doSomething = function() {
console.log( this.name );
},
obj = {
name: 'Object Name'
},
aliasFn = Base.bind( doSomething, obj );
aliasFn(); // => Object Name
log
- Base.log( args... ) ⇒ undefined
引用Console.log如果存在的话,否则引用一个空函数noop。
slice
- Base.slice( target, start[, end] ) ⇒ Array
被uncurrythis的数组slice方法。 将用来将非数组对象转化成数组对象。
function doSomthing() {
var args = Base.slice( arguments, 1 );
console.log( args );
}
doSomthing( 'ignored', 'arg2', 'arg3' ); // => Array ["arg2", "arg3"]
guid
- Base.guid() ⇒ String
- Base.guid( prefx ) ⇒ String
生成唯一的ID
formatSize
- Base.formatSize( size ) ⇒ String
- Base.formatSize( size, pointLength ) ⇒ String
- Base.formatSize( size, pointLength, units ) ⇒ String
参数:
size
{Number}文件大小pointLength
{Number} [可选] [默认值: 2] 精确到的小数点数。[units=[
{Array}'B', 'K', 'M', 'G', 'TB' ]] 单位数组。从字节,到千字节,一直往上指定。如果单位数组里面只指定了到了K(千字节),同时文件大小大于M, 此方法的输出将还是显示成多少K.
格式化文件大小, 输出成带单位的字符串
console.log( Base.formatSize( 100 ) ); // => 100B
console.log( Base.formatSize( 1024 ) ); // => 1.00K
console.log( Base.formatSize( 1024, 0 ) ); // => 1K
console.log( Base.formatSize( 1024 * 1024 ) ); // => 1.00M
console.log( Base.formatSize( 1024 * 1024 * 1024 ) ); // => 1.00G
console.log( Base.formatSize( 1024 * 1024 * 1024, 0, ['B', 'KB', 'MB'] ) ); // => 1024MB
Deferred
- Base.Deferred() ⇒ Deferred
创建一个Deferred对象。 详细的Deferred用法说明,请参照jQuery的API文档。
Deferred对象在钩子回掉函数中经常要用到,用来处理需要等待的异步操作。
// 在文件开始发送前做些异步操作。
// WebUploader会等待此异步操作完成后,开始发送文件。
Uploader.register({
'before-send-file': 'doSomthingAsync'
}, {
doSomthingAsync: function() {
var deferred = Base.Deferred();
// 模拟一次异步操作。
setTimeout(deferred.resolve, 2000);
return deferred.promise();
}
});
isPromise
- Base.isPromise( anything ) ⇒ Boolean
参数:
anything
{*}检测对象。
返回值:
- {Boolean}
判断传入的参数是否为一个promise对象。
console.log( Base.isPromise() ); // => false
console.log( Base.isPromise({ key: '123' }) ); // => false
console.log( Base.isPromise( Base.Deferred().promise() ) ); // => true
// Deferred也是一个Promise
console.log( Base.isPromise( Base.Deferred() ) ); // => true
when
- Base.when( promise1[, promise2[, promise3...]] ) ⇒ Promise
返回一个promise,此promise在所有传入的promise都完成了后完成。 详细请查看这里。