Skip to content

Latest commit

 

History

History
194 lines (183 loc) · 12.7 KB

README.md

File metadata and controls

194 lines (183 loc) · 12.7 KB
Raw

mass Framework

mass Framework的贡献者列表(排名不分先后)：

abcd(1群) ,Alucelx(1群)， 带刀(1群)，sapjax(2群) ,教主Franky(2群), 一三一四君(2B群), riophae,
soom(5群),Hodor(5群)，小叶(3群，904591031)

一个模块化，以大模块开发为目标，jQuery式的框架。里面优先应用了大量HTML5新API，估计除了个别手机专属框架外，没有像它如此大范围应用了。这一来可以大大减少框架的体积，二来大幅提高运行效率。

mass Framework的模块化经过一年化调整与改良，大致分为四类：

  1. 种子模块， mass.js，最精简的内核， 包含模块加载系统。
  2. 补丁模块， lang_fix.js, css_fix.js, event_fix.js, node_fix.js, attr_fix, ajax_fix, 主要是用于兼容IE678的，在chrome1+, FF4+, opera10+, safari4+是不会加载它们的。
  3. 核心模块， 所有位于根目录下，但不在其子目录下的JS文件， 提供框架的核心功能。
  4. 外围模块， 位于more的JS文件。

mass Framework的源码阅读顺序

都是位于src目录下，里面的子目录是外围模块。

mass.js -> lang.js(lang_fix.js) -> class.js -> flow.js -> data.js -> support.js -> query.js ->
node.js(node_fix.js) -> css.js(css_fix.js) -> attr.js(attr_fix.js) -> event.js(event_fix.js) -> fx.js -> ajax.js(ajax_fix.js)

lang, class, flow, data专注于语言层面，query, node, css, attr, event, fx, ajax专注于DOM层面。

mass Framework的文档：

它大部分文档已经转移到newland.js项目之下，我们可以在这里访问得到它！

mass Framework的优点：

  1. 多库共存。
  2. 多版本共存。
  3. 高度模块化，使用AMD规范的加载系统，实现并行加载，按需加载，自行处理依赖，有利于调试与最小化资源调度。(目前版本为v21)
  4. flow提供自定义事件机制，$.Observer是一般化的观察者模块，
    $.Flow, 是其强化版， 专注于流程控制与从多处获取数据，解耦回调嵌套，减少等待时间，实现多路监听，一处归化;
  5. 强大的类工厂。（目前版本为v11）
  6. AS3式的补帧动画系统，支持回放，旋转，暂停！
  7. 第五代选择器引擎Icarus，全面兼容CSS3高级伪类与jQuery自定义伪类的。
  8. 与jQuery完全兼容的事件系统，强大的事件系统机制能轻松处理动态添加的节点的事件监听问题，此外还内置对滚轮事件的支持。
  9. lang_fix模块已经为您修复了旧式IE的语言BUG，与添加上ECMA262v5的绝对大多数新API的支持与，因此痛快使用 String.prototype.trim, Array.prototype.forEach, Array.prototype.map,Array.prototype.filter, Array.prototype.reduce, Function.prototype.bind吧。
  10. ajax模块支持XMLHTTPRequest2.0绝对大多数功能，能在旧式IE下上传下载二进制数据。
  11. lang模块的提供语言链对象相当于把underscore.js这个库整合进来，你能想到语言扩展都有了。
  12. API 95%与jQuery神似，学习成本极低。
  13. 全中文注释与大量参考链接与版本变更日志，绝对对你提高JS水平的好教程。

框架的使用：

点击上面的ZIP按钮将框架下载回来，解压，运行里面的Sws.exe服务器。

一个简单的例子

require("ready,node",function(){
/*待到domReady完成，执行回调*/
   $.log("将日志打印到页面上",true)
})

上面的代码相当于：

require("ready,node",function(){
/*待到domReady完成，并且在node.js模块加载完毕，执行回调*/
   $("<pre>将日志打印到页面上</pre>").appendTo("body")
})

我们在请求node.js时，会自动加载其依赖，如lang.js,support.js,class.js,query.js,data.js等等， IE下还会加载lang_fix.js，但你无需理会它是怎么处理，只需专注于你的业务逻辑就行了。

如果嫌麻烦，直接像jQuery那样，不过会把许多无用的部分都加载下来了。

$(function(){
$("<pre>将日志打印到页面上</pre>").appendTo("body")
});

jQuery1.7最新的API它也支持了

$(function(){
 $("#dataTable tbody tr").on("click", function(event){
	alert($(this).text());
 });
});

相比于jQuery只限于DOM的操作，mass Framework对基本数据类型提供了大量的工具方法，甚至连es6的候选方法你都能找到。它们分别挂在$.String, $.Array, $.Number, $.Object之下。

多库共存

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8"/>
        <title>多库共存</title>
        <script>
            var $ = {
                toString:function(){
                    return "[object jQuery]"
                }
            };//假设这是已存在的库
        </script>
        <script type="text/javascript" src="../mass.js" charset="UTF-8"></script>
        <script>
            //mass的命名空间将自动改为$+它当前的版本号
            $1.require("lang",function(){
                $1.log($+"")//[object jQuery]
            })

    &lt;/script&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;/body&gt;



</html>


写个框架，将自己过往的积累都沉淀下来，等到回头去看时，发现之前攻克的每一个知识点，都乖巧地排在框架里，
在你需要的时候，可以快速派上用场。这种感觉就像在组织自己的军团一样，军团中有驯服得很好的，也有个性还很浮躁的刺儿头。
你慢慢将这支军团由一盘散沙驯练成精锐部队，这感觉真好。
                                                     ——真阿当
	以前的程序员们，经常会为了做一个数据处理程序而自己开发一门编程语言。
	比如Charls Moore在美国国家天文台，做射电望远镜数据提取程序，开发了Forth。有的为了给自己写的书排版漂亮些，
	写了TeX。近的说，有人为了做网站写了Rails 和 Django。想想都不好意思称自己是程序员了。

JS文件的合并

使用combo.js

node.exe combo

JS文件的压缩

使用compiler.jar( GCC，需要有JAVA运行环境)

java -jar compiler.jar --js mass_merge.js --js_output_file mass_min.js
java -jar compiler.jar --js avalon.js --js_output_file avalon_min.js

BUG提交与插件的友情贡献。

大家在github注册后，就可以在https://github.com/RubyLouvre/mass-Framework/issues里面提交建议或BUG什么了。

如果是想贡献力量，可以点击最上面的Fork按钮，拷贝一份作为自己的版本，然后在里面修改代码，添加插件，写完后通知我，好让我合并到主干上。

by 司徒正美 （zhongqincheng）

2011.11.15

http://www.cnblogs.com/rubylouvre/

如何贡献自己的力量

首先你总得有自己的github帐号吧，注册一个，非常简单，只需用户名，邮箱，密码，邮箱只是用来找回密码的，不做验证。因此注册后立即能用！比如我现在新注册一个叫JsLouvre的示范帐号。

然后搜索我的项目——mass Framework

第一个就是，点击进入项目，然后点上方的Fork按钮，这就拷贝一份我的项目的副本作为你自己的项目

创建成功！

接着就是修改代码了，这要在自己发现真的存在漏洞或有什么改进之处才要动手啊！不能想改就改。要通读你要改的那一部分，必要时通读全框架。因此新手们最好找国内高手的框架进行学习， 一来中文注释比较亲切，二来也方便接下来的交流。通常我们在clone git到本地进行修改的，这又涉及另外一些工具与命令的学习。不过，github完全允许你在线上进行修改，提交，合并。

比如你发现data模块的注释与mass模块的不一样，要统一合并，将函数外的注释移到里头。（更有意义的方式是，打开http://www.jshint.com/，就能发现许多小问题。

变成编辑状态，不过不太好用。大家有条件一定要学学如何使用TortoiseGit或Sublime Text 2下载github项目到本地，进行修改，提交，pull request啊！

请认真写下你的修改日志，方便原框架作者查阅。

修改成功后的样子：

接着下来一步非常重要，就是提交你的修改给原作者。点击上方的pull request按钮！

红色区域为原作者的项目，你要贡献的目标；亮蓝色区域为你的项目；黑色处填写标题与必须描述；点击右下方绿区域的按扭进行提交！

接着下来就是框架作者的事儿了，我会在自己的项目看到你们的提交。万一以后你们有幸被别人贡献代码，也做这活儿。

点击中间那个大大的pull request(2)的按钮到另一页面，中间有个被鲜绿色高亮的merge pull request按钮。作者查看你的修改，觉得可以就点它进行合并。

最后你们就会在原项目上看到自己贡献的代码！

如何让自己的项目与原作者的项目保持同步！

我经常看到许多人，只会fork一次，提交过一次修改就不知怎么办了！因此原框架作者是非常勤奋的，一天会提交N次，一个星期后许多文件都改动过了，而那些代码贡献者不可能一个个跟着修改。 因此我们还是用到上方的pull request按钮。

这次是把自己的项目放到左边，原框架作者放到右边，在选择过程中，你会发现原框架作者有许多贡献者的。这里我希望大家一定要浏览Commits与Files Changed进行学习!这也是github最大的价值所在！把握别人对代码的改进，最能提高我们编码水平。这里面会涉及大量的编码技巧！

补上必要说明，然后点击下方send pull request按钮。

很快你就看到评论区最下方有个鲜绿色高亮的按钮，继续点就是。

继续让你确认，没问题就继续点！

这样就同步成功！！！！！！