GithubHelp home page GithubHelp logo

duke-lv / mass-framework Goto Github PK

View Code? Open in Web Editor NEW

This project forked from rubylouvre/mass-framework

0.0 3.0 0.0 39.04 MB

一个模块化,面向大规模开发的javascript框架

License: MIT License

JavaScript 98.90% CSS 0.34% HTML 0.76%

mass-framework's Introduction

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按钮。

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

继续让你确认,没问题就继续点!

这样就同步成功!!!!!!

mass-framework's People

Contributors

rubylouvre avatar riophae avatar jinkspeng avatar jslouvre avatar a289459798 avatar dolymood avatar qiangtou avatar qinerg avatar yolio2003 avatar wbpmrck avatar xyhp915 avatar

Watchers

James Cloos avatar duke.lv avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.