快速了解微信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，才能直接编辑。由于是在手机端，因此不能使用双击事件来进行编辑，改为了长按事件。小程序的平台也没有提供双击事件的绑定。

相关源码：https://github.com/liuyunzhuge/blog/tree/master/todos/wx

若是你想在本地运行这个项目，须要先安装开发者工具，按照文档中简易教程的描述，先建好一个项目； 
建完以后，开发者工具就会打开这个项目； 
接着在磁盘上，找到建好的项目的文件夹，把里面的内容都删掉，把上面源码文件夹下的文件都粘贴进去； 
而后从新打开开发者工具，先进入到编辑页签，而后点击编译按钮，就会直接进入到调试界面，查看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的源码：

<!--list.wxml-->
<view class="container">
    <view class="app-hd">
        <view class="fx1">
            <input class="new-todo-input" value="{{newTodoText}}" auto-focus  bindinput="newTodoTextInput"/>    
        </view>
        <button type="primary" size="mini" bindtap="addOne" loading="{{addOneLoading}}" disabled="{{addOneLoading}}"> 
        + Add
        </button>
    </view>
    <view class="todos-list" >
        <view class="todo-item {{index == 0 ? '' : 'todo-item-not-first'}} {{todo.complete ? 'todo-item-complete' : ''}}" wx:for="{{todos}}" wx:for-item="todo">
            <view wx-if="{{!todo.editing}}">
                <checkbox-group id="todo-item-chk-{{todo.id}}" bindchange="toggleTodo">
                    <label class="checkbox">
                        <checkbox value="1" checked="{{todo.complete}}"/>
                    </label>
                </checkbox-group>
            </view>
            <view id="todo-item-txt-{{todo.id}}" class="todo-text" wx-if="{{!todo.editing}}" bindlongtap="startEdit">
                <text>{{todo.text}}</text>
            </view>
            <view wx-if="{{!todo.editing}}">
                <button id="btn-del-item-{{todo.id}}" bindtap="clearSingle" type="warn" size="mini" loading="{{todo.loading}}"  disabled="{{todo.loading}}"> 
                    Clear
                </button>
            </view>
            <input id="todo-item-edit-{{todo.id}}" class="todo-text-input" value="{{todo.text}}" auto-focus bindblur="endEditTodo" wx-if="{{todo.editing}}"/>    
        </view>
    </view>
    <view class="app-ft" wx:if="{{todos.length > 0}}">
        <view class="fx1">
            <checkbox-group bindchange="toggleAll">
                <label class="checkbox">
                    <checkbox value="1" checked="{{todosOfUncomplted.length == 0}}"/>
                </label>
            </checkbox-group>
            <text>{{todosOfUncomplted.length}} left.</text>
        </view>
        <view wx:if="{{todosOfComplted.length > 0}}">
            <button type="warn" size="mini" bindtap="clearAll" loading="{{clearAllLoading}}" disabled="{{clearAllLoading}}"> 
                Clear {{todosOfComplted.length}} of done.
            </button>
        </view>
    </view>
    <loading hidden="{{loadingHidden}}" bindchange="loadingChange">
        {{loadingText}}
    </loading>
    <toast hidden="{{toastHidden}}" bindchange="toastChange">
        {{toastText}}
    </toast>
</view>

index.js的源码：

var app = getApp();

Page( {
    data: {
        todos: [],
        todosOfUncomplted: [],
        todosOfComplted: [],
        newTodoText: '',
        addOneLoading: false,
        loadingHidden: true,
        loadingText: '',
        toastHidden: true,
        toastText: '',
        clearAllLoading: false
    },
    updateData: function( resetTodos ) {
        var data = {};
        if( resetTodos ) {
            data.todos = this.data.todos;
        }

        data.todosOfUncomplted = this.data.todos.filter( function( t ) {
            return !t.complete;
        });

        data.todosOfComplted = this.data.todos.filter( function( t ) {
            return t.complete;
        });

        this.setData( data );
    },
    updateStorage: function() {
        var storage = [];
        this.data.todos.forEach( function( t ) {
            storage.push( {
                id: t.id,
                text: t.text,
                complete: t.complete
            })
        });

        wx.setStorageSync( 'todos', storage );
    },
    onLoad: function() {
        this.setData( {
            todos: wx.getStorageSync( 'todos' ) || []
        });
        this.updateData( false );
    },
    getTodo: function( id ) {
        return this.data.todos.filter( function( t ) {
            return id == t.id;
        })[ 0 ];
    },
    getTodoId: function( e, prefix ) {
        return e.currentTarget.id.substring( prefix.length );
    },
    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();
    },
    toggleAll: function( e ) {
        var value = e.detail.value[ 0 ];
        var complete = !!value;

        this.data.todos.forEach( function( t ) {
            t.complete = complete;
        });

        this.updateData( true );
        this.updateStorage();

    },
    clearTodo: function( id ) {
        var targetIndex;
        this.data.todos.forEach( function( t, i ) {
            if( targetIndex !== undefined ) return;

            if( t.id == id ) {
                targetIndex = i;
            }
        });

        this.data.todos.splice( targetIndex, 1 );
    },
    clearSingle: function( e ) {
        var id = this.getTodoId( e, 'btn-del-item-' );
        var todo = this.getTodo( id );

        todo.loading = true;
        this.updateData( true );

        var that = this;
        setTimeout( function() {
            that.clearTodo( id );
            that.updateData( true );
            that.updateStorage();
        }, 500 );
    },
    clearAll: function() {
        this.setData( {
            clearAllLoading: true
        });

        var that = this;
        setTimeout( function() {
            that.data.todosOfComplted.forEach( function( t ) {
                that.clearTodo( t.id );
            });
            that.setData( {
                clearAllLoading: false
            });
            that.updateData( true );
            that.updateStorage();

            that.setData( {
                toastHidden: false,
                toastText: 'Success'
            });
        }, 500 );

    },
    startEdit: function( e ) {
        var id = this.getTodoId( e, 'todo-item-txt-' );
        var todo = this.getTodo( id );
        todo.editing = true;

        this.updateData( true );
        this.updateStorage();
    },
    newTodoTextInput: function( e ) {
        this.setData( {
            newTodoText: e.detail.value
        });
    },
    endEditTodo: function( e ) {
        var id = this.getTodoId( e, 'todo-item-edit-' );
        var todo = this.getTodo( id );

        todo.editing = false;
        todo.text = e.detail.value;

        this.updateData( true );
        this.updateStorage();
    },
    addOne: function( e ) {
        if( !this.data.newTodoText ) return;

        this.setData( {
            addOneLoading: true
        });

        //open loading
        this.setData( {
            loadingHidden: false,
            loadingText: 'Waiting...'
        });

        var that = this;
        setTimeout( function() {
            //close loading and toggle button loading status
            that.setData( {
                loadingHidden: true,
                addOneLoading: false,
                loadingText: ''
            });

            that.data.todos.push( {
                id: app.getId(),
                text: that.data.newTodoText,
                compelte: false
            });

            that.setData( {
                newTodoText: ''
            });

            that.updateData( true );
            that.updateStorage();
        }, 500 );
    },
    loadingChange: function() {
        this.setData( {
            loadingHidden: true,
            loadingText: ''
        });
    },
    toastChange: function() {
        this.setData( {
            toastHidden: true,
            toastText: ''
        });
    }
});

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