第一個微信小程序

微信官方已經開放微信小程序的官方文檔和開發者工具。前兩天都是在看相關的新聞來了解小程序該如何開發，這兩天官方的文檔出來以後，趕忙翻看了幾眼，重點了解了一下文檔中框架與組件這兩個部分，而後根據簡易教程，作了一個常規的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，才能直接編輯。由於是在手機端，因此不能使用雙擊事件來進行編輯，改爲了長按事件。小程序的平臺也沒有提供雙擊事件的綁定。

相關源碼：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的操做：

- Hide code

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的源碼：

- Hide code

<!--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的源碼：

- Hide code

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，在代碼層面，給咱們這些開發者提供一個最佳實踐規範。歡迎有其它的開發思路的朋友，幫我指出我以上實現中的問題。