Vue 进阶必学之高阶组件 HOC

Easter79
• 阅读 1056

高阶组件这个概念在 React 中一度非常流行,但是在 Vue 的社区里讨论的不多,本篇文章就真正的带你来玩一个进阶的骚操作。

先和大家说好,本篇文章的核心是学会这样的思想,也就是 容器木偶 组件的解耦合,这可以有很多方式,比如 slot-scopes,比如未来的composition-api。本篇所写的代码也不推荐用到生产环境,生产环境有更成熟的库去使用,这篇强调的是 思想,顺便把 React 社区的玩法移植过来皮一下。

不要喷我,不要喷我,不要喷我,此篇只为演示高阶组件的思路,如果实际业务中想要简化文中所提到的异步状态管理,请使用基于 slot-scopes 的开源库 vue-promised

另外标题中提到的 20k 其实有点标题党,我更多的想表达的是我们要有这样的精神,只会这一个技巧肯定不能让你达到 20k。但我相信只要大家有这样钻研高级用法,不断优化业务代码,不断提效的的精神,我们总会达到的,而且这一天不会很远。

例子

本文就以平常开发中最常见的需求,也就是异步数据的请求为例,先来个普通玩家的写法:

`

`

一般我们都这样写,平常也没感觉有啥问题,但是其实我们每次在写异步请求的时候都要有 loadingerror 状态,都需要有 取数据 的逻辑,并且要管理这些状态。

那么想个办法抽象它?好像特别好的办法也不多,React 社区在 Hook 流行之前,经常用 HOC(high order component) 也就是高阶组件来处理这样的抽象。

高阶组件是什么?

说到这里,我们就要思考一下高阶组件到底是什么概念,其实说到底,高阶组件就是:

一个函数接受一个组件为参数,返回一个包装后的组件

在 React 中

在 React 里,组件是 Class,所以高阶组件有时候会用 装饰器 语法来实现,因为 装饰器 的本质也是接受一个 Class 返回一个新的 Class

在 React 的世界里,高阶组件就是 f(Class) -> 新的Class

在 Vue 中

在 Vue 的世界里,组件是一个对象,所以高阶组件就是一个函数接受一个对象,返回一个新的包装好的对象。

类比到 Vue 的世界里,高阶组件就是 f(object) -> 新的object

实现

有了这个思路,我们就开始尝试实现。

首先上文提到了,HOC 是个函数,本次我们的需求是实现请求管理的 HOC,那么先定义它接受两个参数

  1. wrapped 也就是需要被包裹的组件对象。

  2. promiseFunc 也就是请求对应的函数,需要返回一个 Promise

并且 loadingerror 等状态,还有 加载中加载错误 等对应的视图,我们都要在 新返回的包装组件 中定义好。

const withPromise = (wrapped, promiseFn) => {   return {     name: "with-promise",     data() {       return {         loading: false,         error: false,         result: null,       };     },     async mounted() {       this.loading = true;       const result = await promiseFn().finally(() => {         this.loading = false;       });       this.result = result;     },   }; };

看起来不错了,但是函数里我们好像不能像在 .vue 单文件里去书写 template 那样书写模板了,

但是我们又知道模板最终还是被编译成组件对象上的 render 函数,那我们就直接写这个 render 函数。(注意,本例子是因为便于演示才使用的原始语法,脚手架创建的项目可以直接用 jsx 语法。)

const withPromise = (wrapped, promiseFn) => {   return {     data() { ... },     async mounted() { ... },     render(h) {       return h(wrapped, {         props: {           result: this.result,           loading: this.loading,         },       });     },   }; };

到了这一步,已经是一个勉强可用的雏形了,我们来声明一下 木偶 组件。

const view = {   template: `     <span>       <span>{{result?.name}}</span>     </span>   `,   props: ["result", "loading"], };

注意这里的组件就可以是任意 .vue 文件了,我这里只是为了简化而采用这种写法。

然后用神奇的事情发生了,别眨眼,我们用 withPromise 包裹这个 view 组件。

`// 假装这是一个 axios 请求函数
const request = () => {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve({ name: "ssh" });
    }, 1000);
  });
};

const hoc = withPromise(view, request)
`

然后在父组件中渲染它:

`
  

`

此时,组件在空白了一秒后,渲染出了我的大名 ssh,整个异步数据流就跑通了。

现在在加上 加载中加载失败 视图,让交互更友好点。

`const withPromise = (wrapped, promiseFn) => {
  return {
    data() { ... },
    async mounted() { ... },
    render(h) {
      const args = {
        props: {
          result: this.result,
          loading: this.loading,
        },
      };

      const wrapper = h("div", [
        h(wrapped, args),
        this.loading ? h("span", ["加载中……"]) : null,
        this.error ? h("span", ["加载错误"]) : null,
      ]);

      return wrapper;
    },
  };
};

`

到此为止的代码可以在 效果预览 里查看,控制台的 source 里也可以直接预览源代码。

完善

到此为止的高阶组件虽然可以演示,但是并不是完整的,它还缺少一些功能,比如

  1. 要拿到子组件上定义的参数,作为初始化发送请求的参数。

  2. 要监听子组件中请求参数的变化,并且重新发送请求。

  3. 外部组件传递给 hoc 组件的参数现在没有透传下去。

第一点很好理解,我们请求的场景的参数是很灵活的。

第二点也是实际场景中常见的一个需求。

第三点为了避免有的同学不理解,这里再啰嗦下,比如我们在最外层使用 hoc 组件的时候,可能希望传递一些 额外的props 或者 attrs 甚至是 插槽slot 给最内层的 木偶 组件。那么 hoc 组件作为桥梁,就要承担起将它透传下去的责任。

为了实现第一点,我们约定好 view 组件上需要挂载某个特定 key 的字段作为请求参数,比如这里我们约定它叫做 requestParams

const view = {   template: `     <span>       <span>{{result?.name}}</span>     </span>   `,   data() {     // 发送请求的时候要带上它     requestParams: {       name: 'ssh'     }     },   props: ["result", "loading"], };

改写下我们的 request 函数,让它为接受参数做好准备,

并且让它的 响应数据 原样返回 请求参数

// 假装这是一个 axios 请求函数 const request = (params) => {   return new Promise((resolve) => {     setTimeout(() => {       resolve(params);     }, 1000);   }); };

那么问题现在就在于我们如何在 hoc 组件中拿到 view 组件的值了,

平常我们怎么拿子组件实例的?没错就是 ref,这里也用它:

`const withPromise = (wrapped, promiseFn) => {
  return {
    data() { ... },
    async mounted() {
      this.loading = true;
      // 从子组件实例里拿到数据
      const { requestParams } = this.$refs.wrapped
      // 传递给请求函数
      const result = await promiseFn(requestParams).finally(() => {
        this.loading = false;
      });
      this.result = result;
    },
    render(h) {
      const args = {
        props: {
          result: this.result,
          loading: this.loading,
        },
        // 这里传个 ref,就能拿到子组件实例了,和平常模板中的用法一样。
        ref: 'wrapped'
      };

      const wrapper = h("div", [
        this.loading ? h("span", ["加载中……"]) : null,
        this.error ? h("span", ["加载错误"]) : null,
        h(wrapped, args),
      ]);

      return wrapper;
    },
  };
};
`

再来完成第二点,子组件的请求参数发生变化时,父组件也要响应式的重新发送请求,并且把新数据带给子组件。

const withPromise = (wrapped, promiseFn) => {   return {     data() { ... },     methods: {       // 请求抽象成方法       async request() {         this.loading = true;         // 从子组件实例里拿到数据         const { requestParams } = this.$refs.wrapped;         // 传递给请求函数         const result = await promiseFn(requestParams).finally(() => {           this.loading = false;         });         this.result = result;       },     },     async mounted() {       // 立刻发送请求,并且监听参数变化重新请求       this.$refs.wrapped.$watch("requestParams", this.request.bind(this), {         immediate: true,       });     },     render(h) { ... },   }; };

第二个问题,我们只要在渲染子组件的时候把 $attrs$listeners$scopedSlots 传递下去即可,

此处的 $attrs 就是外部模板上声明的属性,$listeners 就是外部模板上声明的监听函数,

以这个例子来说:

<my-input value="ssh" @change="onChange" />

组件内部就能拿到这样的结构:

{   $attrs: {     value: 'ssh'   },   $listeners: {     change: onChange   } }

注意,传递 $attrs$listeners 的需求不仅发生在高阶组件中,平常我们假如要对 el-input 这种组件封装一层变成 my-input 的话,如果要一个个声明 el-input 接受的 props,那得累死,直接透传 $attrs$listeners 即可,这样 el-input 内部还是可以照样处理传进去的所有参数。

// my-input 内部 <template>   <el-input v-bind="$attrs" v-on="$listeners" /> </template>

那么在 render 函数中,可以这样透传:

`const withPromise = (wrapped, promiseFn) => {
  return {
    ...,
    render(h) {
      const args = {
        props: {
          // 混入 $attrs
          ...this.$attrs,
          result: this.result,
          loading: this.loading,
        },

        // 传递事件
        on: this.$listeners,

        // 传递 $scopedSlots
        scopedSlots: this.$scopedSlots,
        ref: "wrapped",
      };

      const wrapper = h("div", [
        this.loading ? h("span", ["加载中……"]) : null,
        this.error ? h("span", ["加载错误"]) : null,
        h(wrapped, args),
      ]);

      return wrapper;
    },
  };
};
`

至此为止,完整的代码也就实现了:

``

  
    
    
    hoc-promise
  
  
    
      <hoc msg="msg" @change="onChange">
        
        
          

I am named slot

        
      
    

    
    
  

``

可以在 这里 预览代码效果。

我们开发新的组件,只要拿 hoc 过来复用即可,它的业务价值就体现出来了,代码被精简到不敢想象。

``import { getListData } from 'api'
import { withPromise } from 'hoc'

const listView = {
  props: ["result"],
  template:      <ul v-if="result>       <li v-for="item in result">         {{ item }}       </li>     </ul>   ,
};

export default withPromise(listView, getListData)
``

一切变得简洁而又优雅。

组合

注意,这一章节对于没有接触过 React 开发的同学可能很困难,可以先适当看一下或者跳过。

有一天,我们突然又很开心,写了个高阶组件叫 withLog,它很简单,就是在 mounted 声明周期帮忙打印一下日志。

const withLog = (wrapped) => {   return {     mounted() {       console.log("I am mounted!")     },     render(h) {       return h(wrapped)     },   } }

这里我们发现,又要把onscopedSlots 等属性提取并且透传下去,其实挺麻烦的,我们封装一个从 this 上整合需要透传属性的函数:

function normalizeProps(vm) {   return {     on: vm.$listeners,     attr: vm.$attrs,     // 传递 $scopedSlots     scopedSlots: vm.$scopedSlots,   } }

然后在 h 的第二个参数提取并传递即可。

const withLog = (wrapped) => {   return {     mounted() {       console.log("I am mounted!")     },     render(h) {       return h(wrapped, normalizeProps(this))     },   } }

然后再包在刚刚的 hoc 之外:

var hoc = withLog(withPromise(view, request));

可以看出,这样的嵌套是比较让人头疼的,我们把 redux 这个库里的 compose 函数给搬过来,这个 compose 函数,其实就是不断的把函数给高阶化,返回一个新的函数。

function compose(...funcs) { return funcs.reduce((a, b) => (...args) => a(b(...args))) }

compose(a, b, c) -> c(b(a))

这个函数对于第一次接触的同学来说可能需要很长时间来理解,因为它确实非常复杂,但是一旦理解了,你的函数式思想又更上一层楼了。

但是这也说明我们要改造 withPromise 高阶函数了,因为仔细观察这个 compose,它会包装函数,让它接受一个参数,并且把第一个函数的返回值 传递给下一个函数作为参数。

比如 compose(a, b) 来说,b(arg) 返回的值就会作为 a 的参数,进一步调用 a(b(args))

这需要保证参数只有一个。

那么按照这个思路,我们改造 withPromise,让它只接受一个参数 被包裹的函数,其实就是要进一步高阶化它:

const withPromise = (promiseFn) => {   // 返回的这一层函数,就符合我们的要求,只接受一个参数   return function (wrapped) {     return {       mounted() {},       render() {},     }   } }

有了它以后,就可以更优雅的组合高阶组件了:

`const compsosed = compose(
    withPromise(request),
    withLog,
)

const hoc = compsosed(view)
`

以上 compose 章节的完整代码 在这。

注意,这一节如果第一次接触这些概念看不懂很正常,这些在 React 社区里很流行,但是在 Vue 社区里很少有人讨论!关于这个 compose 函数,第一次在 React 社区接触到它的时候我完全看不懂,先知道它的用法,慢慢理解也不迟。

总结

本篇文章的所有代码都保存在 Github仓库 中,并且提供预览。

谨以此文献给在我源码学习道路上给了我很大帮助的 《Vue技术内幕》 作者 hcysun 大佬,虽然我还没和他说过话,但是在我还是一个工作几个月的小白的时候,一次业务需求的思考就让我找到了这篇文章:探索Vue高阶组件 | HcySunYang

当时的我还不能看懂这篇文章中涉及到的源码问题和修复方案,然后改用了另一种方式实现了业务,但是这篇文章里提到的东西一直在我的心头萦绕,我在忙碌的工作之余努力学习源码,期望有朝一日能彻底看懂这篇文章。

时至今日我终于能理解文章中说到的 $vnodecontext 代表什么含义,但是这个 bug 在 Vue 2.6 版本由于 slot 的实现方式被重写,也顺带修复掉了,现在在 Vue 中使用最新的 slot 语法配合高阶函数,已经不会遇到这篇文章中提到的 bug 了。

本文分享自微信公众号 - 前端从进阶到入院(code_with_love)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
待兔 待兔
4个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Jacquelyn38 Jacquelyn38
3年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
徐小夕 徐小夕
3年前
《精通react/vue组件设计》之5分钟教你实现一个极具创意的加载(Loading)组件
前言本文是笔者写组件设计的第八篇文章,今天带大家用5分钟实现一个极具创意的加载(loading)组件.涉及的核心知识点主要是css3相关特性,如果大家非常熟悉,可直接跳过介绍直接看正文.时刻问自己:是否具备创造力?笔记前端组件的一般分类:通用型组件:比如Button,Icon等.布局型组件:比如Grid,Layout布
Stella981 Stella981
3年前
KVM调整cpu和内存
一.修改kvm虚拟机的配置1、virsheditcentos7找到“memory”和“vcpu”标签,将<namecentos7</name<uuid2220a6d1a36a4fbb8523e078b3dfe795</uuid
Easter79 Easter79
3年前
Twitter的分布式自增ID算法snowflake (Java版)
概述分布式系统中,有一些需要使用全局唯一ID的场景,这种时候为了防止ID冲突可以使用36位的UUID,但是UUID有一些缺点,首先他相对比较长,另外UUID一般是无序的。有些时候我们希望能使用一种简单一些的ID,并且希望ID能够按照时间有序生成。而twitter的snowflake解决了这种需求,最初Twitter把存储系统从MySQL迁移
Stella981 Stella981
3年前
Docker 部署SpringBoot项目不香吗?
  公众号改版后文章乱序推荐,希望你可以点击上方“Java进阶架构师”,点击右上角,将我们设为★“星标”!这样才不会错过每日进阶架构文章呀。  !(http://dingyue.ws.126.net/2020/0920/b00fbfc7j00qgy5xy002kd200qo00hsg00it00cj.jpg)  2
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
为什么mysql不推荐使用雪花ID作为主键
作者:毛辰飞背景在mysql中设计表的时候,mysql官方推荐不要使用uuid或者不连续不重复的雪花id(long形且唯一),而是推荐连续自增的主键id,官方的推荐是auto_increment,那么为什么不建议采用uuid,使用uuid究
Python进阶者 Python进阶者
10个月前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这
Easter79
Easter79
Lv1
今生可爱与温柔,每一样都不能少。
文章
2.8k
粉丝
5
获赞
1.2k