[TOC] 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，不是Array，是单纯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. //parent ---> Foo
  11. var ChildFoo = appcan.inherit(parent,{
  12.     init:function(){//要添加给子类的方法
  13.         //do something
  14.     }
  15. });
  17. var cf = new ChildFoo();
  18. //调用父类的方法
  19. 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