air-js

轻量级、模块化的JS组件库 (函数库)

致力于打造轻量级、模块化的JS组件库，浏览器端和node服务端都可以使用的组件库。墙裂欢迎大家分享自己的组件，享用别人的组件！

组件API文档

请移步到：http://mokjs.sinaapp.com/air-api

在浏览器端使用

首先，把air文件夹（即air的源代码）拷贝到你的项目目录下。

其次，由于air的模块化遵循CommonJS模块化规范，所以在浏览器端使用时，需要你的开发工具对模块进行简单的封装。

封装方法，在文件头加 define(function (require, exports, module) { ，在文件尾加 }); 即可。

自动封装全部组件：进入当前目录，执行命令 node wrap-define 目标位置 ，目标位置指明封装后把文件放到哪里。

最后，不知道你们怎么加载模块，是不是还得配置模块根路径啥的？

在这里，墙裂推荐你使用 mokjs 解决JS的模块化问题。如果使用mokjs，把air拷贝到你的项目目录下，你就可以愉快地使用air了！

    var byteLength = require('air/string/byteLength');
    console.log(byteLength('中国人')); // 输出：6

在node服务端使用

通过npm命令安装air：npm install air-js

使用示例：

    // 所有的模块以模块简称为属性名挂载在air上
    var air = require('air-js');
 
    var byteLength = air.byteLength;
    console.log(byteLength('中国人')); // => 6
    console.log(byteLength('air')); // => 3
    console.log(air.byteLength('air')); // => 3
 
    console.log(air.clip('我是中国人', 8)); // => 我是中国…
    console.log(air.thousandFloat(78934.25)); // => 78,934.25

开发和测试air组件

air的开发和测试使用 mokjs 开发框架，在浏览器里运行测试用例前，需要打开mokjs的配置文件进行项目配置和路由配置。

在配置变量projects里添加以下配置：

    'test-air': {
        path: 'D:/1144/air/',	// air项目根路径
        modular_spec: 'CommonJS'
    },
    'test-air-html': {
        type: 'html',
        path: 'D:/1144/air/test/',	// 测试代码路径
        data: {
            root: 'http://test-air.cn/'
        }
    },

在配置变量routes里添加以下配置：

    'test-air.cn': [
        {
            regexp: /^\/air\/.+?\.js$/,
            project: 'test-air',
            format: function (match) {
                return '..' + match[0];
            }
        }, {
            regexp: /^.+?\.html/,
            project: 'test-air-html'
        }, {
            regexp: /.*/,
            root: projects['test-air'].path
        }
    ]

最后绑上host 127.0.0.1 test-air.cn ，即可访问类似 http://test-air.cn/util/url.html?arg=1 这样的测试地址进行查看了。

测试用例的编写请参照 test/util/url.html。

生成组件API文档

API文档采用 mokdoc 工具生成。

需要安装mokdoc：npm install mokdoc

修改下面的配置并运行代码即可生成文档：

    var mokdoc = require('mokdoc');
 
    mokdoc.config.set('air', {
        path: 'D:/1144/air/air/',	// 源代码路径
        doc_path: 'D:/mokjs/air-api/'	// 文档数据保存到哪里（要放到文档展示包里）
    });
 
    mokdoc.start('air', function(){
        console.log('done!');
    });

版本发布记录

请看 CHANGELOG.md