快速瞭解微信小程式的使用,一個根據小程式的框架開發的todos app

来源:http://www.cnblogs.com/lyzg/archive/2016/09/26/5906496.html
-Advertisement-
Play Games

微信官方已經開放微信小程式的官方文檔和開發者工具。前兩天都是在看相關的新聞來瞭解小程式該如何開發,這兩天官方的文檔出來之後,趕緊翻看了幾眼,重點瞭解了一下文檔中框架與組件這兩個部分,然後根據簡易教程,做了一個常規的todo app。這個app基於微信小程式的平臺,實現了todo 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的功能演示:

1

註:需長按todo的text,才能直接編輯。因為是在手機端,所以不能使用雙擊事件來進行編輯,改成了長按事件。小程式的平臺也沒有提供雙擊事件的綁定。

相關源碼:https://github.com/liuyunzhuge/blog/tree/master/todos/wx

如果你想在本地運行這個項目,需要先安裝開發者工具,按照文檔中簡易教程的描述,先建好一個項目;
建完之後,開發者工具就會打開這個項目;
接著在磁碟上,找到建好的項目的文件夾,把裡面的內容都刪掉,把上面源碼文件夾下的文件都粘貼進去;
然後重新打開開發者工具,先進入到編輯頁簽,然後點擊編譯按鈕,就會直接進入到調試界面,查看app的功能:

image

下麵來介紹下這個app開發的要點:

1. 這個app的目錄結構以及配置等就不詳細介紹了,這些在文檔-框架部分都有很詳細的描述。這個平臺裡面沒有html和css,取而代之的是wxml和wxss。wxss跟css幾乎沒有區別,缺點就是不如css強大,支持的選擇器有限。但是好處是由於只有微信這一個平臺,所以幾乎沒有相容性問題,能夠使用標準的,更新的css技術。wxml裡面只能用平臺提供的那些組件的標簽,html的標簽不能直接用,各個組件的在wxml的使用方式,都可以在文檔-組件這一部分找到說明的示例。所以實際上wxml跟wxss編寫起來都沒有什麼難題。

2. wxml支持以下這些特性:

image

在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值了。這是目前用到的一個方法,我認為不是很優雅,希望後面能發現更好的辦法來實現。

image

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


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • chunkupload簡介 chunkupload是一款基於java語言的斷點續傳組件,針對文件上傳,非文件下載,集成方便,使用簡單。 從整體上講,chunkupload會對文件進行切片處理,每個切片4M大小,預設情況下,chunkupload不會對切片進行合併,筆者也不建議在上傳文件時對切片進行合 ...
  • 時間複雜度O(n)當n比較大時歐拉篩法所用的時間比O(nloglogn)的演算法的時間少的會越來越明顯 為什麼呢? 因為在歐拉篩法中,每一個合數只被訪問並將其所對的f[]的值修改了一次。 ...
  • #include <stdio.h>main(){ int x; printf("請輸入要排序數字個數:"); scanf("%d",&x); int i,j,k,a,b,num[x]; printf("輸入數據:"); for(i=0;i<x;i++) scanf("%d",&num[i]); f ...
  • 1.Quartz 是用來完成任務調度的。 2.Quartz 的三個核心概念:調度器、任務、觸發器。 (1)Job:通過實現該介面來定義需要執行的任務。 (2)JobDetail:Quartz 在每次執行 Job 時,都重新創建一個 Job 實例,所以它不是直接接受一個 Job 的實例,而是接受 Jo ...
  • The Accomodation of Students Time Limit: 5000/1000 MS (Java/Others) Memory Limit: 32768/32768 K (Java/Others)Total Submission(s): 5451 Accepted Submis ...
  • 前言 2016年9月22日凌晨,微信官方通過“微信公開課”公眾號發佈了關於微信小程式(微信應用號)的內測通知。整個朋友圈瞬間便像炸開了鍋似的,各種揣測、介紹性文章在一夜裡誕生。而真正收到內測邀請的公眾號據說只有200個。 雖然內測名額十分稀少,但依賴中國廣大開發者的破解和分享精神,在網路上很快出現了 ...
  • 一、簡介 do_GridView的高度支持-1,根據gridview里item的個數來決定gridview的高度,這樣gridview自身就無法滾動了,需要放到固定高度的scrollview里才能滾動。 二、效果圖 三、相關討論 http://bbs.deviceone.net/forum.php? ...
  • textillate.js是一款強大的文字插件,若配合animate.css、fittext、lettering一起使用,這樣做出來的文字特效很完美。 線上實例 實例演示 使用方法 複製 複製 參數詳解 下載 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...