码迷，mamicode.com
首页 > 微信 > 详细

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

时间：2017-06-21 13:57:03      阅读：340      评论：0      收藏：0      [点我收藏+]

标签：bst   hang   substring   tail   tool   模板   get   name   区别   

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

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

标签：bst   hang   substring   tail   tool   模板   get   name   区别   

原文地址：http://www.cnblogs.com/zxwy/p/7058605.html
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！