入坑微信小程序(項目搭建)

超榮幸能夠參與我司【更美小程序】的搭建,在此分享些心得希望能夠幫助到像我一樣的前端界萌新。因【更美小程序】源碼需保密,我僅向大家分享基礎建設級別的非業務代碼。點我~

一個最基本的小程序項目需具備:app.js(入口文件)、app.json(全局配置)、app.wxss(通用樣式)、pages/(頁面)。pages/ 下的每一頁面擁有獨自的 .js、.json、.wxss。形如:

想了解更多請參考 微信小程序代碼構成。對于中大型項目需明確劃分功能模塊,我司小程序文件目錄如下:

  • assets:靜態資源

    <image /> 及 tabBar 支持引用本地靜態資源,而 wxss 中 background-image 不支持,但支持引用 base64 及網絡資源。

  • components:公用組件

  • templates:公用模板

    組件模板 的應用場景易混淆。父節點可向組件也可向模板傳入 data 控制其視圖。然組件的優勢在于其 數據監聽事件監聽生命周期 等機制,自行科普 component 構造器 你便明了。

    但構造組件成本較高,json、wxml、wxss、js 需齊備:

    反之模板較輕便,構造 wxml 接收 page data 即可:

    <template name="mError">
        <view class="mError">
            <image src="/assets/images/holder_error.png"></image>
            <text>網絡錯誤</text>
        </view>
    </template>
    <template is="mError" />
    

    將模塊封裝為組件或是模板需開發者分析其特性并結合業務場景定奪(純粹的視圖控制請選擇模板)。

  • settings:配置文件

    module.exports = {
        version: '1.0.0',
        server: 'https://backend.igengmei.com',
        release: 1
    }
    

    開發階段的網絡環境往往與生產階段不同,settings.js 配置了生產環境,需自行創建 settings_local.js(不入庫)配置開發環境。

    var settings = require('settings');
    var settings_local = null;
    try {settings_local = require('settings_local');} catch (err) {}
    module.exports = settings_local || settings
    

    上述腳本會優先 export settings_local.js 內配置。也可將 server 配置為本地服務,然小程序合法域名不支持 localhost...我們可在開發階段“不校驗安全域名、TLS 版本以及 HTTPS 證書”。(在微信開發者工具中設置)

  • utils:公用腳本

    utils 類腳本非全局注冊需在 page 內 import 方可調用。app.js 內注冊的全局函數無需 import,可通過 app.method(params) 直接調用:

    // utils 類腳本
    import Common from '../../utils/common'
    
    const app = getApp();
    Page({
        data: {},
        ...Common,  
        onLoad: function () {
            this.exampleRequest();
            // 全局注冊類腳本
            app.showToast(this, {
                message: '呆戀小喵一枚',
                duration: 3000,
                type: 'common'
            });
        },
        exampleRequest: function () {
            // 全局注冊類腳本  
            app.request({
                url: 'url',
                method: 'GET'
            });
        }
    });  
    

    全局注冊使用率高的模塊,可減少 page 內的 import,例如 app.request(params)、app.showToast(params) 等:

    import { getBaseInfo } from 'utils/baseInfo'
    import Request from 'utils/request'
    import Toast from 'utils/toast'
    
    App({
        GLOBAL: {
            baseInfo: getBaseInfo()
        },
        request: function (params) {
            Request(params);
        },
        showToast: function (page, opts) {
            Toast.show(page, opts);
        }
    });
    

    也可在 GLOBAL 內注冊一些全局 data,在 page 內通過 app.GLOBAL 獲取。


踩坑札記

關于 tabBar

app.json 內可配置 tabBar 的 pagePath、text、iconPath、selectedIconPath,但圖標尺寸、文字大小、元素間距不可自定義。icon 尺寸建議為 81px * 81px,若 icon 切圖恰好撐滿畫布,圖標與文字便相互緊貼不美觀。故 icon 切圖底邊距需有所保留:

關于 toast

小程序自帶 wx.showToast 必須傳入 icon:

wx.showToast({
    title: '成功',
    icon: 'success',
    duration: 2000
});

但我想使用樸素的 toast:

自行封裝 toast 捎帶默認類型及自定義類型是個不錯的選擇:

switch (opts.type) {
    case 'common':
        page.setData({
            'render.toast.show': true,
            'render.toast.message': opts.message
        });
        let t = setTimeout(() => {
            page.setData({
                'render.toast.show': false,
                'render.toast.message': ''
            });
            opts.callback();
        }, opts.duration);
        break;
    case 'loading':
        wx.showToast({
            title: opts.message,
            duration: opts.duration,
            icon: 'loading'
        });
        break;
    case 'success':
        wx.showToast({
            title: opts.message,
            duration: opts.duration,
            icon: 'success'
        });
        break;
}

關于 <rich-text />

<rich-text /> 渲染時不會將 nodes 解析為常規標簽,你只能拿到這樣一大坨:

無法直接獲取其中的 dom,且不可在 .wxss 中定義其樣式故必須添加內聯 style。

且 <rich-text /> 無法對 nodes 自動糾錯:例如部分瀏覽器可解析 <u>一段錯誤代碼</u>, <rich-text /> 則直接過濾錯誤代碼不進行渲染。

關于 onPullDownRefresh

enablePullDownRefresh 僅可開啟 pulldown 的交互及監聽,并非想象中的 window.location.reload。我們需要定義自己的 reload:

reload: function (page, callback) {
    page.setData({
        reqError: false
    });
    callback && callback();
    page.onLoad();
    page.onReady();
}
onPullDownRefresh: function () {
    const _page = this;
    Loadmore.clear(_page);
    app.reload(_page, function () {
        _page.setData({
            'render.orders': [],
            'render.loading': true,
            'render.empty.show': false
        });
    });
    wx.stopPullDownRefresh();
}

小程序無 window 概念,不可調用 window.location.reload。其實 reload 無非 重置 data、重新調用 onLoadonReady(原諒我這膚淺的理解,但你可在 callback 中做任何意義上的重置)。

在 onPullDownRefresh 回調執行時 wx.stopPullDownRefresh() 防止用戶瘋狂 pulldown 導致卡澀。

關于 wx.getSystemInfo

調用 wx.getSystemInfo 可獲取設備信息,fail 回調限制了獲取失敗時的嘗試次數:

function getMobileInfo(i) {
    wx.getSystemInfo({
        success: (res) => {
            BaseInfo.mobile = res.brand + res.model;
            BaseInfo.system = res.platform + res.system;
            BaseInfo.wechat = res.version;
            BaseInfo.winWidth = res.windowWidth / (res.windowWidth / 750);
            BaseInfo.winHeight = res.windowHeight / (res.windowWidth / 750);
        },
        fail: () => {
            (i < 3) && getMobileInfo(i + 1);
        }
    });
}
getMobileInfo(0);

請注意 windowWidth、windowHeight 度量單位為 px,而我司項目規定使用 rpx。為實現單位統一,需對 windowWidth 及 windowHeight 做單位轉換:

BaseInfo.winWidth = res.windowWidth / (res.windowWidth / 750);
BaseInfo.winHeight = res.windowHeight / (res.windowWidth / 750);

1rpx = (設備寬度 / 750) px

關于 wx.getLocation

首次 執行 wx.getLocation 小程序將自動調啟如下 dialog:

請注意是 首次!無論用戶選擇“確定”或是“取消”,再次進入“更美測試”均不會被詢問是否開啟定位(調用 100 次 wx.getLocation 也無濟于事)。除非用戶手動清理微信緩存、更新微信、切換賬號...

各種緩存:

存在上述問題的 API 絕不止 wx.getLocation 例如 wx.login,遺憾的是,小程序并未開放清理緩存的接口。但可通過 wx.openSetting 再次請求用戶開啟授權:

關于 wx.reportAnalytics

小程序數據分析可通過填寫配置上報、API 上報:

對于填寫配置上報,需提交觸發動作、觸發頁面、觸發元素、埋點數據等。但埋點數據需從 page data 中獲取,看看官方文檔是怎么曰的:

事件數據來源于對頁面 page 實例 data 對應字段值的收集。

OMG...需要在 page data 內維護埋點狀態,當埋點量較大時上報數據的復雜度可想而知。我曾傻傻的認為 data 字段值等同 dataset 值:

<text
    wx:for="{{ areas }}"
    data-id="{{ item.id }}"
    data-name="{{ item.name }}"
    data-idx="{{ index }}"
    bindtap="tapItem">{{ item.name }}</text>

未曾想竟為 page 實例中的 data 值:

Page({
    data: {},
    onLoad: function () {},
    onReady: function () {}
});

如此看來 API 上報更簡單,為觸發元素 dataset 埋點數據并調用 wx.reportAnalytics 傳入參數:

<text
    wx:for="{{ orders }}"
    data-id="{{ item.id }}"
    data-name="{{ item.name }}"
    data-type="order"
    bindtap="triggerSelected">{{ item.name }}</text>
triggerSelected (e) {
    var dataset = e.target.dataset;
    var id = dataset.id;
    var name = dataset.name;
    var type = dataset.type;
    wx.reportAnalytics('click_fliter_item', {
        item_type: type,
        item_id: id,
        item_name: name
    });
}

關于 rpx

rpx 在不同設備被小程序換算為 px 時能產生各種 bug,當設備寬度除不盡 750 時結果值精確至哪一位呢(額...bug 產生原因本人猜的),看看換算表:

舉個例子:

<view class="fliter-bar" style="top: {{ top }}rpx;"></view>
<view class="fliter-wrap" style="top: {{ top + 84 }}rpx;"></view>

問題一:當 top = 0 時,0rpx 被換算為 0.5px 也是厲害~

解決方案:

<view class="fliter-bar" style="top: {{ top ? (top + 'rpx') : 0 }};"></view>

問題二:當 fliter-bar 高度為 84rpx,理論上緊貼的 fliter-bar 與 fliter-wrap 在部分設備上也不緊貼...

關于 setData

假如你想在 this.setData 的 key 中傳入變量,下述寫法報錯:

triggerSelected (e) {
    var dataset = e.target.dataset;
    var id = dataset.id;
    var name = dataset.name;
    var type = dataset.type;
    this.setData({
        selected[type]: {
            id: id,
            name: name
        }
    });
}

且 this.setData 不支持模板字符串形式的 key,下述寫法也報錯:

triggerSelected (e) {
    var dataset = e.target.dataset;
    var id = dataset.id;
    var name = dataset.name;
    var type = dataset.type;
    this.setData({
        `selected.${type}`: {
            id: id,
            name: name
        }
    });
}

可將 selected 存入變量,直接操作 selected 變量后再 this.setData:

triggerSelected (e) {
    var dataset = e.target.dataset;
    var id = dataset.id;
    var name = dataset.name;
    var type = dataset.type;
    var selected = this.data.selected;
    selected[type] = {
        id: id,
        name: name
    };
    this.setData({
        selected: selected
    });
}

檢測 page data 內 selected 值與預期的一致,但當 selected 與視圖渲染相關時,意想不到的情況發生了...假定我通過 selected 的某一屬性值控制元素 class:

<text
    class="{{ selected.order.id == item.id ? 'active' : '' }}"
    wx:for="{{ orders }}"
    data-id="{{ item.id }}"
    data-name="{{ item.name }}"
    data-type="order"
    bindtap="triggerSelected">{{ item.name }}</text>

當元素被點擊時其 class 被賦值 active 使之呈現綠色:

而后我點擊了另一與之前被點擊元素 type 不同的元素,理論上不應影響第一次被點擊元素的狀態(selected.type2 變化不影響 selected.type1),然而:

active 仍在綠色卻不見了,這 bug 也是醉了,我不得不寫點爛代碼了(通過 switch case 一一處理):

triggerSelected (e) {
    var dataset = e.target.dataset;
    var id = dataset.id;
    var name = dataset.name;
    var type = dataset.type;
    var selected = this.data.selected;
    switch (type) {
        case 'area':
            this.setData({
                'selected.area': {
                    id: id,
                    name: name
                }
            });
            break;
        case 'tag':
            this.setData({
                'selected.tag': {
                    id: id,
                    name: name
                }
            });
            break;
        case 'order':
            this.setData({
                'selected.order': {
                    id: id,
                    name: name
                }
            });
            break;
    }
}

未完待續,謝謝關注~


作者:呆戀小喵

相關文章:初嘗微信小程序(浪漫調酒師)

我的后花園:https://sunmengyuan.github.io/garden/

我的 github:https://github.com/sunmengyuan

原文鏈接:https://sunmengyuan.github.io/garden/2018/01/04/xcx-gm.html

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,825評論 6 546
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,814評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,980評論 0 384
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 64,064評論 1 319
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,779評論 6 414
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,109評論 1 330
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,099評論 3 450
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,287評論 0 291
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,799評論 1 338
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,515評論 3 361
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,750評論 1 375
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,221評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,933評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,327評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,667評論 1 296
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,492評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,703評論 2 380