This package has been deprecated

Author message:

this package has been deprecated, use spa-custom-hooks instead

vue-custom-hooks

1.1.6 • Public • Published

license license

简体中文 | English

vue-custom-hooks 是什么?

  • 一个可以定制vue组件钩子的东西,你可以注册全局的异步任务,满足条件时即可自动执行页面里相关的钩子。
  • 支持和vue的原生钩子created,mounted等随意搭配使用。
  • 支持传统h5、uni-app、wepy、mpvue

它有什么用?

用简单优雅的方式解决业务页面里需要同时监听多个全局状态的问题

来点真实的场景吧

用户首次进入小程序需要在app.vue的onLaunch登录获取token和用户信息(都是异步任务),然后存到store里。现在要做一个页面,进来把用户的头像昵称等渲染在canvas上,需求关键点在于两个条件都要满足。

方案1、在页面里监听store是否拿到了用户信息 && dom树渲染完毕。
//缺点:比较麻烦,耦合度高,用到的页面都要监听userinfo的改变和dom树渲染完毕,重复性代码多,不利于维护
data(){
    return{
        //任务完成数
        num: 0
    }
},
computed: {
    userInfo: function(){
        return this.$store.state.userInfo
},
watch:{
    userInfo(newval,oldval){
        //监听拿到用户信息了
        if(newval.nickName){
            this.num++;
            if(this.num == 2){
                //可以渲染canvas了
                renderCanvas();
            }
        }
    }
},
mounted(){
    //dom渲染完毕
    this.num++;
    if(this.num == 2){
        //可以渲染canvas了
        renderCanvas();
    }
}
方案2、在页面里去获取用户信息 && dom树渲染完毕。
//缺点:跟方案1差不多,用到的页面都要写获取用户信息的方法和监听dom树渲染完毕
data(){
    return{
        //任务完成数
        num: 0
    }
},
computed: {
    userInfo: function(){
        return this.$store.state.userInfo
},
methods:{
    getUserInfo(cb){
        //发起请求获取用户信息
        let userinfo = {nickName:'张三'};
        this.$store.commit('userinfo',userinfo);
        cb()
    }
},
created(){
    this.getUserInfo(()=>{
        this.num++;
        if(this.num == 2){
            //可以渲染canvas了
            renderCanvas();
        }
    })
},
mounted(){
    //dom渲染完毕
    this.num++;
    if(this.num == 2){
        //可以渲染canvas了
        renderCanvas();
    }
},

使用vue-custom-hooks实现以上场景

//第一步,安装插件:
npm install vue-custom-hooks

//第二步,入口文件里注册插件:
import CustomHook from 'vue-custom-hooks';
Vue.use(CustomHook ,{
     'UserInfo':{
        name:'UserInfo',
        watchKey: 'userinfo',
        deep: true,
        onUpdate(val){
            //userinfo里含有nickName则表示命中此钩子
            return !!val.nickName;
        }
    }
},store)

//第三步,业务页面里使用插件(任何页面都可以使用,耦合度低,重复性代码少):
onMountedUserInfo(){
    //可以渲染canvas了
    renderCanvas();
}

注册参数说明

  • 注册CustomHook

import store from './store'
import CustomHook from 'vue-custom-hooks';
Vue.use(CustomHook,diyHooks,store)
  • diyHooks对象说明

{
    //1.注册属性监听钩子
    //UserInfo,钩子单名,首字母大写
    'UserInfo':{
        //name,钩子全称,监听属性的话可以和上面的key一致,必填
        name:'UserInfo',
        //watchKey要监听的store里的属性名(相当于$store.state.userinfo),属性监听钩子模式必填
        watchKey: 'userinfo',
        //是否默认命中,非必填
        hit: false,
        //deep是否深度监听,非必填
        deep: true,
        //onUpdate属性改变时执行的callback,用来决定是否要命中此钩子,非必填,缺省值相当于返回了!!val
        onUpdate(val){
            //这里表示userinfo里含有nickName则命中此钩子。注意不可以异步return
            return !!val.nickName;
        }
    },
    
    //2.注册事件监听钩子
    //BeforeMount,钩子单名,首字母大写
    'BeforeMount':{
        //name,原生钩子名,用来命中此钩子,必填
        name:'beforeMount',
        //destroy,相反的钩子名,用来取消命中,事件监听钩子必填
        destroy:'destroyed',
        //是否默认命中,非必填
        hit: false
    }
}

如何使用?

export default {
    name: 'Home',
    created(){
        //页面初始化完成
    },
    mounted(){
        //dom渲染完成
    },
    onLoginCreated(){
        //登录成功(拿到token) && 页面初始化完成
        //Tips:适用于某页面发送的请求依赖token的场景
    },
    onCreatedUserInfo(){
        //页面初始化完成 && 获取用户信息完成
        //Tips:适用于页面初始化时需要用到用户信息去做判断再走页面逻辑的场景
    },
    onMountedUserInfo(){
        //dom渲染完成 && 获取用户信息完成
        //Tips:适用于首次进入页面需要在canvas上渲染头像的类似场景
    },
    onReadyShow(){
        //dom渲染完成 && 页面显示
        //Tips:适用于需要获取组件或者dom,并且每次页面显示都会执行的场景
    },
}

钩子使用规则

`on{UserInfo}{BeforeMount}{Login}{Position}...` //所有注册好的钩子都可以随意搭配,排列顺序不影响钩子执行,都是 && 的关系

已经注册好的原生钩子

Launch、Created、Load、Attached、Show、Mounted、Ready
//↓↓↓如需其他的钩子可自行注册↓↓↓(如果当前框架的某钩子和其对应的相反钩子跟如下配置不一致也需要手动注册,比如wepy有created但没有destroyed)

Demo二维码

left image description here

进群交流

left image description here

如果有什么好的建议欢迎提issues或者提pr

喜欢的话点个star

Readme

Keywords

none

Package Sidebar

Install

npm i vue-custom-hooks

Weekly Downloads

1

Version

1.1.6

License

MIT

Unpacked Size

40.2 kB

Total Files

11

Last publish

Collaborators

  • qizhang