微信小程序自定义组件 Component - 初始化页面

一般情况下大多数页面在加载时都需要进行一些网络检查、基础配置数据的加载,而如果每个页面都写一遍显然是特别愚蠢的做法,同样是一件特别苦恼的事情。
所以,懒人自有懒办法,提取通用 page init component,组合达到当前小程序想要实现的效果。

Ta 里面有什么?

  • 页面初始化时的网络监察
  • 页面初始化时的必要数据加载
  • 页面初始化时的 Loading 交互
  • 页面初始化失败时的提醒

实现结果

# 页面初始化

# 由于网络原因页面初始化失败

实现

在尝试实现前,先将实现步骤梳理和归纳一下,找到其中的规律便于在接下来开发中编码并且对于维护也能顺理成章。

  1. 一个 Loading 界面
  2. 一个能够接收入参的错误提醒界面
  3. 实现网络检查函数
  4. 核心配置数据请求
  5. 回调通知父级函数

达到以上条件,基本上就成功了一半,初始已具有一定模型。

component 的实现

init.wxml 基础结构

<view>
    <view wx:if="{{!loading && !errStatus}}">
        <slot name="page"></slot>
    </view>
    <view class="{{ (loading || errStatus) ? 'show':'' }}">
        <view>
            <!-- Loading -->
            <view wx:if="{{loading}}"><text>Loading</text></view>
            <!-- Error -->
            <view wx:if="{{errStatus}}">
                <view>
                    <view>{{errTitle}}</view>
                    <view>{{errContent}}</view>
                </view>
                <view>
                    <button>再次尝试</button>
                    <button>回到主页</button>
                    <button>联系客服</button>
                </view>
            </view>

        </view>
    </view>
</view>

以上的代码逻辑很简单
1.loadingerrStatus 均为 false 时,显示插槽内的内容, slot page 插槽,就是实际 init 完成后需要显示的内容

  1. loadingerrStatus 任意为 true 时显示提示,提示 Loading 状态或异常状态
  2. errTitle & errContent 则是异常时提示的内容

init.js

Component({
    options: {
        addGlobalClass: true,
        multipleSlots: true
    },
    properties: {
        resyncUser: {
            type: Boolean,
            value: false
        },
        loopInit: {
            type: Boolean,
            value: false
        },
        autoHide: {
            type: Boolean,
            value: true
        }
    },
    data: {
        loading: true,
        errStatus: false,
        errTitle: '数据异常',
        errContent: '可能发生了未知错误,请重试',
    },
    pageLifetimes: {
        show: function() {
            if (!this._showLoop || this.data.loopInit) {
                this.init().then(
                    () => {
                        this._showLoop = true
                    }
                )
            }
        }
    },
    observers: {
        'loading': function (loading) {
            if (loading) {
                this.setData({
                    errStatus: false
                })
            }
        },
        'errStatus': function (errStatus) {
            if (errStatus) {
                this.setData({
                    loading: false
                })
            }
        }
    },
    methods: {
        init: function(){
            return new Promise((resolve, reject) => {
                this.showLoading()
                this.network()
                    .then(
                        () => {
                            return this.user()
                        }
                    )
                    .then(
                        user => {
                            if (this.data.autoHide){
                                this.hide()
                            }
                            this.triggerEvent('callback', {
                                user: user,
                                userJSON: user.toJSON()
                            })
                            resolve()
                        }
                    )
                    .catch(
                        err => {
                            reject()
                        }
                    )
            })
        },
        user: function() {
            return new Promise((resolve, reject) => {
                getApp().user.get(this.data.sync).then(
                    user => {
                        resolve(user)
                    },
                    err => {
                        this.showError('账户异常', '同步账户时出现异常,请重新尝试')
                        reject(err)
                    }
                )
            })
        },
        network: function() {
            return new Promise((resolve, reject) => {
                wx.getNetworkType({
                    success: res => {
                        if (res.networkType != 'none') {
                            resolve(true)
                        } else {
                            this.showError('网络异常', '请检查您的网络连接')                            
                            reject(false)
                        }
                    },
                })
            })
        },
        hide: function(){
            this.setData({
                loading: false,
                errStatus: false
            })
        },
        showLoading: function() {
            this.setData({
                loading: true
            })
        },
        showError: function(_title, _content) {
            this.setData({
                errStatus: true,
                errTitle: _title,
                errContent: _content
            })
        }
    }
})

properties中定义组件的对外属性,便于父级页面在引用时进行配置,在我自己小程序中,同步用户数据是我的核心配置函数,我需要在所有页都同步用户数据且配置不相同,所有有此定义,具体细节不表了。

  1. resyncUsertrue,强制同步;false,引用变量缓存
  2. loopInit:表示是否需要循环初始化,在 component 无法监听 父级的 onLoad 事件,所以父级每次 onShow 时都会被初始化,该参数则决定是否要将其阻断。ture,每次 onShow 都初始化;false,仅初始化一次
  3. autoHide 表示初始化完成后是否要自动隐藏 init。true,初始化完成后自动隐藏;false,初始化后的隐藏决定权交给父级

.json 配置组件

"usingComponents": {
    "INIT": "/pages/_copts/init/main"
}

.wxml 中的使用

<INIT id="init"
loopInit="{{false}}" autoHide="{{false}}"
bind:callback="init">
    <view slot="page">
        <!-- 你的代码  -->       
    </view>
</INIT>

在具体使用该 init 的父级页中配置 json 和引用 init 组件并对其 loopInit autoHide callback 进行配置。
如果想直接使用,也可以不用配置交给默认值决定。

额外事项

在组件的 init.js 中我们定义多个方法,可以使用在父级节点使用 this.selectComponent 获取组件示例后调用

  1. this.selectComponent('#init').hide()
  2. this.selectComponent('#init').showError('title','content')
    这里不太推荐直接访问和修改组件的属性,我们仅提供方法调用,交给组件自身去修改属性避免错乱。

番外

其实对于初始化的办法很多种,我这里是的办法是根据自身的小程序特性和需要而确定,具体的源码估计对看官意义也不甚大,我就不献丑了。文章的意义更多的还是抛砖引玉与记录自身在写代码过程中的感想体悟。如果你有想法或打脸请随时留言。

以上,
玩的开心!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,732评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,496评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,264评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,807评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,806评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,675评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,029评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,683评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,704评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,666评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,773评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,413评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,016评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,204评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,083评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,503评论 2 343

推荐阅读更多精彩内容