Silence.js高效开发移动Web前端类库

基于Zepto的轻量级移动Web前端JavaScript类库。

编写这个类库原因及目的：

采用MVC设计模式，使代码工程化结构化。
使用RouterJS，提升前端交互性能，延长页面使用时间，并通过Ajax实现交互，避免页面跳转的交互中断糟糕体验。
使用LocalStorage前端离线缓存，实现缓存时间有效期，从而带给用户极致的响应效率。
基于ZetpoJS，移动端的JQuery，兼容JQuery大部分语法，体积更小，效率更高。
基于Touch.js，支持移动端触摸事件（'swipe', 'swipeLeft', 'swipeRight', 'swipeUp', 'swipeDown','doubleTap', 'tap', 'singleTap', 'longTap'），并避免click事件移动端延时300ms的恶心效果。

Zepto的设计目的是提供 jQuery 的类似的API，但并不是100%覆盖 jQuery 。Zepto设计的目的是有一个5-10k的通用库、下载并快速执行、有一个熟悉通用的API，所以你能把你主要的精力放到应用开发上。

Zepto模块：

module	default	description
zepto	✔	核心模块；包含许多方法
event	✔	通过`on()`& `off()`处理事件
ajax	✔	XMLHttpRequest 和 JSONP 实用功能
form	✔	序列化 & 提交web表单
ie	✔	增加支持桌面的Internet Explorer 10+和Windows Phone 8。
detect		提供 `$.os`和 `$.browser`消息
fx		The `animate()`方法
fx_methods		以动画形式的 `show`, `hide`, `toggle`, 和 `fade*()`方法.
assets		实验性支持从DOM中移除image元素后清理iOS的内存。
data		一个全面的 `data()`方法, 能够在内存中存储任意对象。
deferred		提供 `$.Deferred`promises API. 依赖"callbacks" 模块. 当包含这个模块时候, `$.ajax()` 支持promise接口链式的回调。
callbacks		为"deferred"模块提供 `$.Callbacks`。
selector		实验性的支持 jQuery CSS 表达式实用功能，比如 `$('div:first')`和`el.is(':visible')`。
touch		在触摸设备上触发tap– 和 swipe– 相关事件。这适用于所有的`touch`(iOS, Android)和`pointer`事件(Windows Phone)。
gesture		在触摸设备上触发 pinch 手势事件。
stack		提供 `andSelf`& `end()`链式调用方法
ios3		String.prototype.trim 和 Array.prototype.reduce 方法 (如果他们不存在) ，以兼容 iOS 3.x.

Zepto插件编写规范：

1 ;(function($){
2   $.extend($.fn, {
3     foo: function(){
4       // `this` refers to the current Zepto collection.
5       // When possible, return the Zepto collection to allow chaining.
6       return this.html('bar')
7     }
8   })
9 })(Zepto)

RouterJS使用API编写：

html编写

viewport适应移动端浏览器，页面必须引入div id="container"容器，并且引入routerJS库。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=0">
    <title>example</title>
</head>
<body>
    <div id="container"></div>
    <script src="router.js"></script>
</body>
</html>

javascript编写

 1 var router = new Router({
 2     container: '#container'
 3 });
　　//无参数页面
 4 var home = {
 5     url: '/',
 6     className: 'home',
 7     render: function (){
 8         return '<h1>home</h1>';
 9     }
10 };
　　//带参数的页面
11 var post = {
12     url: '/post/:id',
13     className: 'post',
14     render: function (){
15         var id = this.params.id;
16         return '<h1>post</h1>';
17     }
18 };
　　//创建路由关系，并定义默认页面
19 router.push(home).push(post).setDefault('/').init();

new Router参数 option 是可选的，下面是该参数可选的属性。

属性	类型	默认值	描述
container	String	'#container'	`container` 容器的选择器
enter	String	'enter'	该页面出现时添加的类名，`enterTimeout` 为 0 时会被忽略
enterTimeout	Number	0	在这个时间之后移除添加的 `enter` 类名
leave	String	'leave'	该页面离开时添加的类名，`lieaveTimeout` 为 0 时会被忽略
leaveTimeout	Number	0	在这个时间之后移除该页面的 DOM

push添加路由页面的配置。下面是 route 参数的属性。

属性	类型	描述
url	String	以 `/` 开头的 url，会体现在 hash，支持参数，如：`/user/:userId/post/:posdId`
className	String	可选，该页面可以添加的额外类名，以便控制该页面下的样式
render	function	页面渲染方法，支持同步和异步, 可以直接返回 html 字符串，可以返回 `promise` 对象，也可以接收 `callback` 参数
bind	function	执行绑定事件的方法，`this` 指向当前页面容器

本地缓存API编写：

 1 /**
 2  * User: Sparkfly
 3  * Date: 16-5-31
 4  * Time: 下午11:33
 5  * 前端缓存驱动，基于localStorage缓存对象
 6  */
 7 
 8 ;(function(){
 9     //缓存队列
10     var _local_storage = [];
11     var __key__ = "local_storage";
12 
13     var start_cache = function(){
14         var storage_str = localStorage.getItem(__key__);
15         if(storage_str==null){
16             _local_storage = [];
17         }else{
18             _local_storage = JSON.parse(storage_str);
19         }
20         return true;
21     }
22 
23     var end_cache = function(){
24         var storage_str = JSON.stringify(_local_storage);
25         localStorage.setItem(__key__,storage_str);
26         return true;
27     }
28 
29     //添加缓存
30     var set_cache = function(_key,_element,_expires){
31         var _current_timestamp_ = (new Date()).valueOf();
32         start_cache();
33         _local_storage.push({
34             key:_key,
35             element:_element,
36             expires: ( _current_timestamp_ + parseInt(_expires) * 1000 )
37         });
38         end_cache();
39         return true;
40     }
41 
42     //获取缓存
43     var get_cache = function(_key){
44         var _result_ = null;
45         return _result_;
46         var _current_timestamp_ = (new Date()).valueOf();
47         start_cache();
48         var __item__ = null;
49         $.each(_local_storage,function(index,item){
50             if(item.key == _key){
51                 __item__ = item;
52             }
53         });
54         if(__item__ != undefined && __item__ != null){
55             if(__item__['expires'] != undefined && __item__['expires'] > _current_timestamp_){
56                 _result_ =  __item__['element'];
57             }else if(__item__['expires'] != undefined){
58                 //移除缓存
59                 var __storage__ = [];
60                 $.each(_local_storage,function(index,item){
61                     if(item.key != _key){
62                         __storage__.push(item);
63                     }
64                 });
65                 _local_storage = __storage__;
66             }
67         }
68         end_cache();
69         return _result_;
70     }
71 
72     //删除缓存
73     var delete_cache = function(_key){
74         start_cache();
75         var __storage__ = [];
76         $.each(_local_storage,function(index,item){
77             if(item.key != _key){
78                 __storage__.push(item);
79             }
80         });
81         _local_storage = __storage__;
82         start_cache();
83     }
84 
85     var clear_cache = function(){
86         _local_storage = [];
87         start_cache();
88     }
89 
90     //缓存对象
91     var fast_cache = {
92         set_cache:set_cache,
93         get_cache:get_cache,
94         del_cache:delete_cache,
95         clear:clear_cache
96     };
97     $.extend($.fn,{FAST_CACHE:fast_cache});
98 
99 })(Zepto)

控制器API编写：

 1 /**
 2  * Created with JetBrains PhpStorm.
 3  * User: Sparkfly
 4  * Date: 16-5-30
 5  * Time: 下午11:12
 6  * To change this template use File | Settings | File Templates.
 7  */
 8 ;(function(){
 9     $.extend($.fn,{ controller:{
10         _key_index:1,
11         controller_lists:[],
12         add:function(_item,_index){
13             var self = this;
14             (_index == undefined)?
15                 _index=self._key_index++:_index=_index;
16             self.controller_lists.push(_item);
17         },
18         remove:function(_index){
19             //移除controller
20         },
21         search:function(_index){
22             //获取controller
23         },
24         init_router:function(_router,_link){
25             var self = this;
26             $.each(self.controller_lists,function(_index,_item){
27                 _router.push(_item);
28             });
29             _router.setDefault(_link).init();
30         }
31     }
32     });
33 })(Zepto)

index.html

支持微信JSJDK服务方式

 1 <!DOCTYPE html>
 2 <html lang="en">
 3 <head>
 4     <meta charset="UTF-8">
 5     <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=0">
 6     <title>首 页</title>
 7     <link rel="stylesheet" href="./lib/style/weui.min.css"/>
 8     <link rel="stylesheet" href="./lib/style/example.css"/>
 9     <link rel="stylesheet" href="./lib/style/style.css"/>
10 
11     <link rel="stylesheet" href="./lib/style/dropload.css"/>
12     <script>
13         /*全局定义 start */
14         var globals = {
15             WX_JS_JDK_CONFIG : {
16 
17             },
18             IS_WX_BROWSER : function(){
19                 //是否属于微信浏览器
20                 return true;
21             },
22             IN_VERSION : "1.0"
23         };
24         /*全局定义 end   */
25     </script>
26 </head>
27 <body ontouchstart>
28 <div class="container js_container" id="main_container">
29     <!-- container html -->
30 </div>
31 <!-- core start -->
32 <script src="./core/zepto.min.js"></script>
33 <script src="./core/router.min.js"></script>
34 
35 <script src="./core/touch.js"></script>
36 <script src="./core/cache.js"></script>
37 <script src="./core/dialog.js"></script>
38 <script src="./core/Silence.js"></script>
39 <script src="./core/controller.js"></script>
40 
41 <!-- core end   -->
42 
43 <!-- lib start -->
44 <script src="./lib/script/swipeSlide.js"></script>
45 <script src="./lib/script/dropload.js"></script>
46 <!-- lib end -->
47 
48 <!-- controller js start -->
49 <script src="./view/weui/weui_home.js"></script>
50 <script src="./view/weui/weui_button.js"></script>
51 
52 <script>
53     $.fn.controller.init_router(
54             $.fn.pageManager({
55                 container: '#main_container',
56                 enterTimeout: 250,
57                 leaveTimeout: 250
58             }),"/"
59     );
60 </script>
61 <!-- controller js end   -->
62 </body>
63 </html>

演示地址：

　　Silence.js类库演示

github路径：

　　https://github.com/helingfeng/fastU

作为前端的初学者，第一次写类库，虽然结果并不理想，但我会不断学习新知识，然后在review和重构代码，希望，最后能把它做得更好。