
源碼地址:https://github.com/jsongo/wx-gesture-lock
這個 Demo 的核心算法與主流程,來自開源項目 H5lock(https://github.com/lvming6816077/H5lock )。移植到小程序端時,幾乎每一行語法都要重新打磨:先後剝離了 window、document 這類瀏覽器專屬對象,又補上一層機制,把「界面操作」和「第三方庫」徹底分開,後文會重點講這部分。
需要提前說明的是,這個 Demo 目前只適合在開發者工具裡體驗。放到真機上,手指一滑,頁面會跟著滾動,手勢判定隨之失效——這也是後續要解決的坑。
H5lock 本質上是一個為瀏覽器寫的能力。改造它,可以拆成兩步。
第一步:模塊化
小程序只認得通過 module.exports 導出的模塊,所以第一件事就是補上導出口:
module.exports = { ... }
如果希望「被引入時順便執行一段初始化邏輯」,常見有兩種寫法。第一種是立即執行函數:
// mylib.js
module.exports = (function () {
// 這裡寫初始化代碼
return xxx; // 導出單個方法,多個就組裝成 map
})();
// 使用方
let MyLib = require('mylib.js');
let lib = MyLib();
lib.xxx();
第二種是 ES6 的 class:
// mylib.js
module.exports = class {
constructor() {
// 這裡寫初始化代碼
}
xxx() { ... }
};
// 使用方
let MyLib = require('mylib.js');
let lib = new MyLib();
lib.xxx();
第二步:替換掉小程序不存在的 API
以下全局對象與方法在小程序中並不可用,需要逐一搜索並改寫:
window、document、frames、self、location、navigator、localStorage、history、caches、screen、alert、confirm、prompt、XMLHttpRequest、WebSocket。
實踐中最常撞見的是 document 操作——第三方庫通常用它來取 DOM 節點、再改節點屬性。這部分不必硬改,用下面介紹的解耦技巧可以漂亮地繞過去;其餘情況就得結合具體場景自己判斷了。本文 Demo 採用 class 封裝的方式完成改造。
當一個頁面 JS 膨脹到上千行,或者一段邏輯需要被多個頁面共用,代碼就該拆出去了。拆完立刻會遇到尷尬:共用文件裡需要改動頁面上的數據,可它偏偏要被 A、B 兩個頁面同時引用,難道把 setData 寫進共用文件?顯然不行。
你可能會想到 DOM 上的 trigger 機制,但它只能綁在節點上;也可能聽說過 StateJS(https://statejs.org/ )這種狀態機方案,思路很漂亮,值得一讀。不過我們其實不必再引入一個庫,幾行代碼就夠了。
完整代碼:https://github.com/jsongo/wx-gesture-lock/blob/master/lib/event.js
module.exports = function (app) {
app && (app.trigger = function (eventType, data) {
var pages = getCurrentPages(),
curPage = pages[pages.length - 1],
methodName = 'on' + eventType.charAt(0).toUpperCase() + eventType.substr(1),
callback = curPage[methodName];
callback && callback.call(curPage, data);
});
};
它的做法非常樸素:給 app 掛一個 trigger 方法,調用時找出當前頁面上對應的 onXxx 方法並執行。方法名由 eventType 變形而來,例如 app.trigger('textChange') 會去找 onTextChange。所以說到底,這套解耦本質上是一份命名約定。
在 app.js 中引入,並於 onLaunch 裡掛載:
var event = require('lib/event.js');
App({
onLaunch: function () {
event(this); // this 就是 app 本身
},
globalData: {}
});
共用文件裡,原本要寫 setData 的地方改成觸發事件:
app.trigger('titleChanged', '請解鎖');
頁面裡再補上響應:
Page({
onTitleChanged: function (newTitle) {
this.setData({ title: newTitle });
}
});
三步走完,共用邏輯與頁面渲染就徹底鬆耦合了。
以上就是這套微信小程序手勢解鎖實戰的分享,希望對正在折騰小程序的你有參考價值。有疑問歡迎留言,我會及時回復。