下载文档

基础类库Base
更新时间:2016-03-20

AppCan整个框架依赖的基础库

appcan.logs(msg)

把日志输出到控制台

  1. msg:要打印到控制台的消息

例如:

  1. //打印这段文字到控制台
  2. appcan.logs('这是一个打印消息');

appcan.define(name,function(){})

创建一个新模块 appcan.define(name,defineCall)

  1. name:要创建的模块名
  2. defineCall:创建模块的函数,执行该函数时会传入三个参数,第一个参数是zepto对象,第二个是要导出的模 块的引用的副本,第三个是要导出模块对象,其中的exports对象就是要导出到来的引用点。

例如:

  1. //定义一个foo模块
  2. appcan.define('foo',function($,exports,modules){
  3. //do something
  4. modules.exports = {foo:'foo'};
  5. });

appcan.extend(obj,[obj])

扩展对象,如果只有一个参数则会把参数扩展到appcan自己上。例如 appcan.extend({showVersion:function(){return this.version;}}) 会给appcan增加 一个showVersion方法,可以直接调用appcan.showVersion()获取当前appcan库的版本号。返回值是扩展后的对象

  1. name:obj:要扩展的对象
  2. name:[obj]:如果第二个参数不为空,会把第二个参数扩展到第一个参数上,并返回扩展后的值

例如:

  1. //把foo扩展到appcan上
  2. appcan.extend({foo:'foo'});
  3. //把一个对象copy 到另一个对象上
  4. appcan.extend({},{foo:'foo'});

appcan.require(name)

引用一个模块,返回当前名称对应的模块

  1. name:要获取模块的名称,返回对应的模块

例如:

  1. //引用一个foo对象
  2. var foo = appcan.require('foo');
  3. //当然你也可以直接使用该对象
  4. appcan.foo.do()

appcan.use(name,funCall)

引用对应的模块进行后续开发

  1. name:模块名
  2. funCall:回调函数,第一个参数默认传入dom对象即zepto对象,第二个参数是前面要使用的模块名对象,模块名可以是数组,如果参数是数组,回调 中会把数组格式化好按照顺序添加到回调的后续参数中

例如:

  1. //如果想直接写代码,又不想返回一个模块,用这个方法
  2. appcan.use('foo',function($,foo){
  3. //这样就可以使用foo对象了
  4. foo.do();
  5. });
  6. //另外可以直接使用,foo对象
  7. appcan.foo.do();

appcan.isString(obj)

判断指定的对象是否是String类型,返回值如果为true表示是字符串,否则不是字符串

  1. obj:要判断类型的对象

例如:

  1. //判断foo是否是字符串,
  2. var res = appcan.isString(foo); //如果res为true则表示foo是字符串,否则foo不是字符串

appcan.isArray(obj)

判断指定的对象是否是Array(数组)类型,返回值如果为true表示是数组类型,否则不是数组类型

  1. obj:要判断类型的对象

例如:

  1. //判断foo是否是数组
  2. var res = appcan.isArray(foo); //如果res为true表示foo是数组,否则foo不是数组

appcan.isFunction(obj)

判断指定的对象是否是函数类型,返回值如果为true表示是函数类型,否则不是函数类型

  1. obj:要判断类型的对象

例如:

  1. //判断foo,是否是一个函数
  2. var res = appcan.isFunction(foo); //如果res为true则foo是函数,否则foo不是函数

appcan.isPlainObject(obj)

判断指定的类型是否是朴素Object对象,返回值如果为true表示是朴素Object对象,否则不是朴素Object对象

  1. obj:要判断类型的对象

例如:

  1. //判断foo是否是一个朴素的对象
  2. var res = appcan.isPlainObject(foo); //如果foo是一个存纯粹的对象,不是window,不是Aarry,是单纯Object对象

appcan.ready(funCall)

在appcan内部插件可用后执行内部的回调函数,如果用到appcan的插件一定要调用该方法

  1. funCall:内部插件全部准备好后执行该函数

例如:

  1. //当所有组建准备好后执行内部回调方法
  2. appcan.ready(function(){
  3. //do something
  4. });

appcan.inherit(parent,proto,staticProps)

创建一个新的类继承指定的父类

  1. parent:要继承的父类
  2. proto:子类的新方法如果要添加新的属性则需要实现initated方法
  3. staticProps:子类的静态属性通过这个对象实现

例如:

  1. //定义一个父类
  2. var Foo = function(){
  3. };
  4. Foo.prototype = {
  5. constructor:Foo,
  6. show:function(){
  7. //do something
  8. }
  9. };
  10. //定义一个子类集成Foo
  11. var ChildFoo = appcan.inherit(parent,{
  12. init:function(){//要添加给子类的方法
  13. //do something
  14. }
  15. });
  16. var cf = new ChildFoo();
  17. //调用父类的方法
  18. cf.show();

appcan.trim(str)

去除字符串两端的空白字符

  1. str:要去除空白字符的字符串
  2. 返回去除完字符串的结果

例如:

  1. //去除字符串两端的空格
  2. appcan.trim(' a ');//返回'a'没有任何空格

appcan.trimLeft(str)

去除字符左侧的空白字符

  1. str:要去除空白字符的字符串
  2. 返回去除完空白字符的字符串

例如:

  1. //去除字符串左端的空格
  2. appcan.trimLeft(' a ');//返回'a '左边空格去掉

appcan.trimRight(str)

去除字符右侧的空白字符

  1. str:要去除空白字符的字符串
  2. 返回去除完空白字符的字符串

例如:

  1. //去除字符串右端的空格
  2. appcan.trimRight(' a ');//返回' a'右边空格去掉

appcan.byteLength(str)

  1. 获取字符串的字节长度
  2. str:要获取字节长的字符串
  3. 返回当前字符串的字节长度

例如:

  1. //获取一个字符串长度,中文字符按照实际位长计算
  2. appcan.byteLength('a啊');//返回4
  3. appcan.byteLength('aa');//返回2