(转）快速了解微信小程序的使用，一个根据小程序的框架开发的todos app

微信官方已经开放微信小程序的官方文档和开发者工具。前两天都是在看相关的新闻来了解小程序该如何开发，这两天官方的文档出来之后，赶紧翻看了几眼，重点了解了一下文档中框架与组件这两个部分，然后根据简易教程，做了一个常规的todo app。

这个app基于微信小程序的平台，实现了todo app的常规功能，同时为了让它更接近实际的工作场景，也用到了loading与toast这两个组件来完成一些操作的交互与反馈。

这个平台给我的直观感受是，技术层面，它跟vue有相似性，但是远没有vue强大；开发时候的思路，不像vue，反倒觉得比较像backbone。所以要是使用过backbone,vue等mvc,mvvm框架的人，会觉得这个平台上手很容易。本文主要介绍这个todo app实现的一些要点。

先补充下本文相关的资料：

官方文档：https://mp.weixin.qq.com/debug/wxadoc/dev/index.html

官方开发者工具下载：https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html

本文todo app的功能演示：



注：需长按todo的text，才能直接编辑。因为是在手机端，所以不能使用双击事件来进行编辑，改成了长按事件。小程序的平台也没有提供双击事件的绑定。

如果你想在本地运行这个项目，需要先安装开发者工具，按照文档中简易教程的描述，先建好一个项目； 

建完之后，开发者工具就会打开这个项目； 

接着在磁盘上，找到建好的项目的文件夹，把里面的内容都删掉，把上面源码文件夹下的文件都粘贴进去； 

然后重新打开开发者工具，先进入到编辑页签，然后点击编译按钮，就会直接进入到调试界面，查看app的功能：

 


 

下面来介绍下这个app开发的要点：

1. 这个app的目录结构以及配置等就不详细介绍了，这些在文档-框架部分都有很详细的描述。这个平台里面没有html和css，取而代之的是wxml和wxss。wxss跟css几乎没有区别，缺点就是不如css强大，支持的选择器有限。但是好处是由于只有微信这一个平台，所以几乎没有兼容性问题，能够使用标准的，更新的css技术。wxml里面只能用平台提供的那些组件的标签，html的标签不能直接用，各个组件的在wxml的使用方式，都可以在文档-组件这一部分找到说明的示例。所以实际上wxml跟wxss编写起来都没有什么难题。

2. wxml支持以下这些特性：

 


 

在todo app里面除了模板和引用没有用到之外，其它的都使用到了，不过没有使用到每个特性的各个细节，只根据app的需要选用合适的功能。前几天看到有文章说，微信小程序可能是基于vue框架来实现的，所以就看了下vue的文档。对于数据绑定，条件渲染，列表渲染，事件这几部分都详细看了vue的用法。对比下来，wxml提供的这些特性，跟vue的相关特性是还比较像，不过功能并没有那么多，所以也不能轻易地直接拿vue框架的特性用到小程序里面。最佳实践，还是基于官方文档中提供的说明来，如果官方文档中没有提到的功能，通过猜测的方式去用，肯定是行不通的。我通过打印的方式，查看一些对象的原型，也并没有发现比官方文档要多的一些实例方法，说明小程序的框架功能确实是有限的。

3. wxss其实是可以用less或者sass来写的，只要选择器满足框架的要求即可。由于时间原因，就没有在这个app里面去尝试了。

4. 没有双向绑定。在vue里面，一个vue实例就是一个view-model；view层对数据的更新，会实时反馈到model；model的更新，也会实时反馈的到view。在小程序里面，没有双向绑定，view的更新不会直接同步到model；需要在相关事件回调里面，直接从view层拿到数据，然后通过setData的方式，更新model，小程序内部会在setData之后重新渲染page。比如单个todo项，toggle的操作：

toggleTodo: function( e ) {
    var id = this.getTodoId( e, 'todo-item-chk-' );
    var value = e.detail.value[ 0 ];
    var complete = !!value;
    var todo = this.getTodo( id );
    todo.complete = complete;
    this.updateData( true );
    this.updateStorage();
},

以上代码中，通过e.detail.value[0]拿到单个todo项里面checkbox的值，通过该值来判断todo的complete状态。最后在updateData的内部，还会通过setData方法，刷新model的内容。只有这样，在toggle操作之后，app底部的统计信息才会更新。

5. 事件绑定的时候，无法传递参数，只能传递一个event。比如上面那个toggle的操作，我其实很想在回调里面把当前todo的id传到这个回调里面，但是想尽办法都做不到，最后只能通过id的方式来处理：就是在wxml中绑定事件的组件上面，加一个id，这个id全page也不能重复，所以id得加前缀，然后在id最后加上todo的id值；当事件触发的时候，通过e.currentTarget.id就能拿到该组件的id，去掉相应的id前缀，就得到todo的id值了。这是目前用到的一个方法，我认为不是很优雅，希望后面能发现更好的办法来实现。

 


6. app中考虑到了loading的效果，要利用button组件的loading属性来实现。但是loading仅仅是一个样式的控制，它不会控制这个按钮是否能重复点击。所以还要利用buttong的disabled属性，防止重复点击。

剩下的实现细节，都在下面两个文件的源码中，欢迎大家指出其中的问题。

index.wxml的源码：

 

[html] view plain copy
  1. <!--list.wxml-->  
  2. <view class="container">  
  3.     <view class="app-hd">  
  4.         <view class="fx1">  
  5.             <input class="new-todo-input" value="{{newTodoText}}" auto-focus  bindinput="newTodoTextInput"/>      
  6.         </view>  
  7.         <button type="primary" size="mini" bindtap="addOne" loading="{{addOneLoading}}" disabled="{{addOneLoading}}">   
  8.         + Add  
  9.         </button>  
  10.     </view>  
  11.     <view class="todos-list" >  
  12.         <view class="todo-item {{index == 0 ? '' : 'todo-item-not-first'}} {{todo.complete ? 'todo-item-complete' : ''}}" wx:for="{{todos}}" wx:for-item="todo">  
  13.             <view wx-if="{{!todo.editing}}">  
  14.                 <checkbox-group id="todo-item-chk-{{todo.id}}" bindchange="toggleTodo">  
  15.                     <label class="checkbox">  
  16.                         <checkbox value="1" checked="{{todo.complete}}"/>  
  17.                     </label>  
  18.                 </checkbox-group>  
  19.             </view>  
  20.             <view id="todo-item-txt-{{todo.id}}" class="todo-text" wx-if="{{!todo.editing}}" bindlongtap="startEdit">  
  21.                 <text>{{todo.text}}</text>  
  22.             </view>  
  23.             <view wx-if="{{!todo.editing}}">  
  24.                 <button id="btn-del-item-{{todo.id}}" bindtap="clearSingle" type="warn" size="mini" loading="{{todo.loading}}"  disabled="{{todo.loading}}">   
  25.                     Clear  
  26.                 </button>  
  27.             </view>  
  28.             <input id="todo-item-edit-{{todo.id}}" class="todo-text-input" value="{{todo.text}}" auto-focus bindblur="endEditTodo" wx-if="{{todo.editing}}"/>      
  29.         </view>  
  30.     </view>  
  31.     <view class="app-ft" wx:if="{{todos.length > 0}}">  
  32.         <view class="fx1">  
  33.             <checkbox-group bindchange="toggleAll">  
  34.                 <label class="checkbox">  
  35.                     <checkbox value="1" checked="{{todosOfUncomplted.length == 0}}"/>  
  36.                 </label>  
  37.             </checkbox-group>  
  38.             <text>{{todosOfUncomplted.length}} left.</text>  
  39.         </view>  
  40.         <view wx:if="{{todosOfComplted.length > 0}}">  
  41.             <button type="warn" size="mini" bindtap="clearAll" loading="{{clearAllLoading}}" disabled="{{clearAllLoading}}">   
  42.                 Clear {{todosOfComplted.length}} of done.  
  43.             </button>  
  44.         </view>  
  45.     </view>  
  46.     <loading hidden="{{loadingHidden}}" bindchange="loadingChange">  
  47.         {{loadingText}}  
  48.     </loading>  
  49.     <toast hidden="{{toastHidden}}" bindchange="toastChange">  
  50.         {{toastText}}  
  51.     </toast>  
  52. </view>  

index.js的源码：

 

[javascript] view plain copy
  1. var app = getApp();  
  2. Page( {  
  3.     data: {  
  4.         todos: [],  
  5.         todosOfUncomplted: [],  
  6.         todosOfComplted: [],  
  7.         newTodoText: '',  
  8.         addOneLoading: false,  
  9.         loadingHidden: true,  
  10.         loadingText: '',  
  11.         toastHidden: true,  
  12.         toastText: '',  
  13.         clearAllLoading: false  
  14.     },  
  15.     updateData: function( resetTodos ) {  
  16.         var data = {};  
  17.         if( resetTodos ) {  
  18.             data.todos = this.data.todos;  
  19.         }  
  20.   
  21.         data.todosOfUncomplted = this.data.todos.filter( function( t ) {  
  22.             return !t.complete;  
  23.         });  
  24.   
  25.         data.todosOfComplted = this.data.todos.filter( function( t ) {  
  26.             return t.complete;  
  27.         });  
  28.   
  29.         this.setData( data );  
  30.     },  
  31.     updateStorage: function() {  
  32.         var storage = [];  
  33.         this.data.todos.forEach( function( t ) {  
  34.             storage.push( {  
  35.                 id: t.id,  
  36.                 text: t.text,  
  37.                 complete: t.complete  
  38.             })  
  39.         });  
  40.   
  41.         wx.setStorageSync( 'todos', storage );  
  42.     },  
  43.     onLoad: function() {  
  44.         this.setData( {  
  45.             todos: wx.getStorageSync( 'todos' ) || []  
  46.         });  
  47.         this.updateData( false );  
  48.     },  
  49.     getTodo: function( id ) {  
  50.         return this.data.todos.filter( function( t ) {  
  51.             return id == t.id;  
  52.         })[ 0 ];  
  53.     },  
  54.     getTodoId: function( e, prefix ) {  
  55.         return e.currentTarget.id.substring( prefix.length );  
  56.     },  
  57.     toggleTodo: function( e ) {  
  58.   
  59.         var id = this.getTodoId( e, 'todo-item-chk-' );  
  60.         var value = e.detail.value[ 0 ];  
  61.         var complete = !!value;  
  62.         var todo = this.getTodo( id );  
  63.   
  64.         todo.complete = complete;  
  65.         this.updateData( true );  
  66.         this.updateStorage();  
  67.     },  
  68.     toggleAll: function( e ) {  
  69.         var value = e.detail.value[ 0 ];  
  70.         var complete = !!value;  
  71.   
  72.         this.data.todos.forEach( function( t ) {  
  73.             t.complete = complete;  
  74.         });  
  75.   
  76.         this.updateData( true );  
  77.         this.updateStorage();  
  78.   
  79.     },  
  80.     clearTodo: function( id ) {  
  81.         var targetIndex;  
  82.         this.data.todos.forEach( function( t, i ) {  
  83.             if( targetIndex !== undefined ) return;  
  84.   
  85.             if( t.id == id ) {  
  86.                 targetIndex = i;  
  87.             }  
  88.         });  
  89.   
  90.         this.data.todos.splice( targetIndex, 1 );  
  91.     },  
  92.     clearSingle: function( e ) {  
  93.         var id = this.getTodoId( e, 'btn-del-item-' );  
  94.         var todo = this.getTodo( id );  
  95.   
  96.         todo.loading = true;  
  97.         this.updateData( true );  
  98.   
  99.         var that = this;  
  100.         setTimeout( function() {  
  101.             that.clearTodo( id );  
  102.             that.updateData( true );  
  103.             that.updateStorage();  
  104.         }, 500 );  
  105.     },  
  106.     clearAll: function() {  
  107.         this.setData( {  
  108.             clearAllLoading: true  
  109.         });  
  110.   
  111.         var that = this;  
  112.         setTimeout( function() {  
  113.             that.data.todosOfComplted.forEach( function( t ) {  
  114.                 that.clearTodo( t.id );  
  115.             });  
  116.             that.setData( {  
  117.                 clearAllLoading: false  
  118.             });  
  119.             that.updateData( true );  
  120.             that.updateStorage();  
  121.   
  122.             that.setData( {  
  123.                 toastHidden: false,  
  124.                 toastText: 'Success'  
  125.             });  
  126.         }, 500 );  
  127.   
  128.     },  
  129.     startEdit: function( e ) {  
  130.         var id = this.getTodoId( e, 'todo-item-txt-' );  
  131.         var todo = this.getTodo( id );  
  132.         todo.editing = true;  
  133.   
  134.         this.updateData( true );  
  135.         this.updateStorage();  
  136.     },  
  137.     newTodoTextInput: function( e ) {  
  138.         this.setData( {  
  139.             newTodoText: e.detail.value  
  140.         });  
  141.     },  
  142.     endEditTodo: function( e ) {  
  143.         var id = this.getTodoId( e, 'todo-item-edit-' );  
  144.         var todo = this.getTodo( id );  
  145.   
  146.         todo.editing = false;  
  147.         todo.text = e.detail.value;  
  148.   
  149.         this.updateData( true );  
  150.         this.updateStorage();  
  151.     },  
  152.     addOne: function( e ) {  
  153.         if( !this.data.newTodoText ) return;  
  154.   
  155.         this.setData( {  
  156.             addOneLoading: true  
  157.         });  
  158.   
  159.         //open loading  
  160.         this.setData( {  
  161.             loadingHidden: false,  
  162.             loadingText: 'Waiting...'  
  163.         });  
  164.   
  165.         var that = this;  
  166.         setTimeout( function() {  
  167.             //close loading and toggle button loading status  
  168.             that.setData( {  
  169.                 loadingHidden: true,  
  170.                 addOneLoading: false,  
  171.                 loadingText: ''  
  172.             });  
  173.   
  174.             that.data.todos.push( {  
  175.                 id: app.getId(),  
  176.                 text: that.data.newTodoText,  
  177.                 compelte: false  
  178.             });  
  179.   
  180.             that.setData( {  
  181.                 newTodoText: ''  
  182.             });  
  183.   
  184.             that.updateData( true );  
  185.             that.updateStorage();  
  186.         }, 500 );  
  187.     },  
  188.     loadingChange: function() {  
  189.         this.setData( {  
  190.             loadingHidden: true,  
  191.             loadingText: ''  
  192.         });  
  193.     },  
  194.     toastChange: function() {  
  195.         this.setData( {  
  196.             toastHidden: true,  
  197.             toastText: ''  
  198.         });  
  199.     }  
  200. });  

最后需要补充的是，这个app在有限的时间内依据微信的官方文档进行开发，所以这里面的实现方式到底是不是合理的，我也不清楚。我也仅仅是通过这个app来了解小程序这个平台的用法。希望微信官方能够推出一些更全面、最好是项目性的demo，在代码层面，给我们这些开发者提供一个最佳实践规范。欢迎有其它的开发思路的朋友，帮我指出我以上实现中的问题。 

注意：本文来自　http://www.cnblogs.com/lyzg/p/5906496.html

posted on 2017-06-21 11:14  轩子仔  阅读(309)  评论(0)  编辑  收藏  举报

Powered by: 博客园 Copyright © 2024 轩子仔
Powered by .NET 9.0 on Kubernetes