《精通react/vue组件设计》之配合React Portals实现一个功能强大的抽屉(Drawer)组件

时间 2020-02-10

标签精通 react vue 组件设计配合 portals 实现一个功能强大抽屉 drawer 栏目 React 繁體版

原文原文链接

前言

本文是笔者写组件设计的第六篇文章,内容依次从易到难,今天会用到react的高级API React Portals,它也是不少复杂组件必用的方法之一. 经过组件的设计过程,你们会接触到一个完成健壮的组件设计思路和方法,也能在实现组件的过程逐渐对react/vue的高级知识和技巧有更深的理解和掌握,而且在企业实际工做作游刃有余.javascript

之因此会写组件设计相关的文章,是由于做为一名前端优秀的前端工程师,面对各类繁琐而重复的工做,咱们不该该循序渐进的去"辛勤劳动",而是要根据已有前端的开发经验,总结出一套本身的高效开发的方法.css

做为数据驱动的领导者react/vue等MVVM框架的出现,帮咱们减小了工做中大量的冗余代码, 一切皆组件的思想深得人心. 为了让工程师们有更多的时间去考虑业务和产品迭代,咱们不得不掌握高质量组件设计的思路和方法.因此笔者将花时间去总结各类业务场景下的组件的设计思路和方法,并用原生框架的语法去实现各类经常使用组件的开发,但愿能让前端新手或者有必定工做经验的朋友能有所收获.html

若是对于react/vue组件设计原理不熟悉的,能够参考个人以前写的组件设计系列文章:前端

正文

在开始组件设计以前但愿你们对css3和js有必定的基础,并了解基本的react/vue语法.咱们先看看实现后的组件效果: vue

1. 组件设计思路

按照以前笔者总结的组件设计原则,咱们第一步是要确认需求. 一个抽屉(Drawer)组件会有以下需求点:java

能控制抽屉是否可见
能手动配置抽屉的关闭按钮
能控制抽屉的打开方向
关闭抽屉时是否销毁里面的子元素(这个问题是工做中频繁遇到的问题)
指定 Drawer 挂载的 HTML 节点, 能够将抽屉挂载在任何元素上
点击蒙层能够控制是否容许关闭抽屉
能控制遮罩层的展现
能自定义抽屉弹出层样式
能够设置抽屉弹出层宽度
能控制弹出层层级
能控制抽屉弹出方向(上下左右)
点击关闭按钮时能提供回调供开发者进行相关操做

需求收集好以后,做为一个有追求的程序员, 会得出以下线框图:node

对于react选手来讲,若是没用typescript,建议你们都用PropTypes, 它是react内置的类型检测工具,咱们能够直接在项目中导入. vue有自带的属性检测方式,这里就不一一介绍了.react

经过以上需求分析, 是否是以为一个抽屉组件要实现这么多功能很复杂呢? 确实有点复杂,可是不要怕,有了上面精确的需求分析,咱们只须要一步步按照功能点实现就行了.对于咱们经常使用的table组件, modal组件等其实也须要考虑到不少使用场景和功能点, 好比antd的table组件暴露了几十个属性,若是很差好理清具体的需求, 实现这样的组件是很是麻烦的.接下来咱们就来看看具体实现.webpack

2. 基于react实现一个Drawer组件

2.1. Drawer组件框架设计

首先咱们先根据需求将组件框架写好,这样后面写业务逻辑会更清晰:css3

import PropTypes from 'prop-types'
import styles from './index.less'

/** * Drawer 抽屉组件 * @param {visible} bool 抽屉是否可见 * @param {closable} bool 是否显示右上角的关闭按钮 * @param {destroyOnClose} bool 关闭时销毁里面的子元素 * @param {getContainer} HTMLElement 指定 Drawer 挂载的 HTML 节点, false 为挂载在当前 dom * @param {maskClosable} bool 点击蒙层是否容许关闭抽屉 * @param {mask} bool 是否展现遮罩 * @param {drawerStyle} object 用来设置抽屉弹出层样式 * @param {width} number|string 弹出层宽度 * @param {zIndex} number 弹出层层级 * @param {placement} string 抽屉方向 * @param {onClose} string 点击关闭时的回调 */
function Drawer(props) {
  const { 
    closable = true, 
    destroyOnClose, 
    getContainer = document.body, 
    maskClosable = true, 
    mask = true, 
    drawerStyle, 
    width = '300px',
    zIndex = 10,
    placement = 'right', 
    onClose,
    children
  } = props

  const childDom = (
    <div className={styles.xDrawerWrap}> <div className={styles.xDrawerMask} ></div> <div className={styles.xDrawerContent} { children } { !!closable && <span className={styles.xCloseBtn}>X</span> } </div> </div>
  )
  return childDom
}

export default Drawer
复制代码

有了这个框架,咱们来一步步往里面实现内容吧.

2.2 实现visible, closable, onClose, mask, maskClosable, width, zIndex, drawerStyle

之因此要先实现这几个功能,是由于他们实现都比较简单,不会牵扯到其余复杂逻辑.只须要对外暴露属性并使用属性便可. 具体实现以下:

function Drawer(props) {
  const { 
    closable = true, 
    destroyOnClose, 
    getContainer = document.body, 
    maskClosable = true, 
    mask = true, 
    drawerStyle, 
    width = '300px',
    zIndex = 10,
    placement = 'right', 
    onClose,
    children
  } = props

  let [visible, setVisible] = useState(props.visible)

  const handleClose = () => {
    setVisible(false)
    onClose && onClose()
  }

  useEffect(() => {
    setVisible(props.visible)
  }, [props.visible])

  const childDom = (
    <div className={styles.xDrawerWrap} style={{ width: visible ? '100%' : '0', zIndex }} > { !!mask && <div className={styles.xDrawerMask} onClick={maskClosable ? handleClose : null}></div> } <div className={styles.xDrawerContent} style={{ width, ...drawerStyle }}> { children } { !!closable && <span className={styles.xCloseBtn} onClick={handleClose}>X</span> } </div> </div>
  )
  return childDom
}
复制代码

上述实现过程值得注意的就是咱们组件设计采用了react hooks技术, 在这里用到了useState, useEffect, 若是你们不懂的能够去官网学习, 很是简单,若是有不懂的能够和笔者交流或者在评论区提问. 抽屉动画咱们经过控制抽屉内容的宽度来实现,配合overflow:hidden, 后面我会单独附上css代码供你们参考.

2.3 实现destroyOnClose

destroyOnClose主要是用来清除组件缓存,比较经常使用的场景就是输入文本,好比当我是的抽屉的内容是一个表单建立页面时,咱们关闭抽屉但愿表单中用户输入的内容清空,保证下次进入时用户能从新建立, 可是实际状况是若是咱们不销毁抽屉;里的子组件, 子组件内容不会清空,用户下次打开时开始以前的输入,这明显不合理. 以下图所示:

要想清除缓存,首先就要要内部组件从新渲染,因此咱们能够经过一个state来控制,若是用户明确指定了关闭时要销毁组件,那么咱们就更新这个state,从而这个子元素也就不会有缓存了.具体实现以下:

function Drawer(props) {
  // ...
  let [isDesChild, setIsDesChild] = useState(false)

  const handleClose = () => {
    // ...
    if(destroyOnClose) {
      setIsDesChild(true)
    }
  }

  useEffect(() => {
    // ...
    setIsDesChild(false)
  }, [props.visible])

  const childDom = (
    <div className={styles.xDrawerWrap}> <div className={styles.xDrawerContent} { isDesChild ? null : children } </div> </div>
  )
  return childDom
}
复制代码

上述代码中咱们省略了部分不相关代码, 主要来关注isDesChild和setIsDesChild, 这个属性用来根据用户传入的destroyOnClose属性俩判断是否该更新这个state, 若是destroyOnClose为true,说明要更新,那么此时当用户点击关闭按钮的时候, 组件将从新渲染, 在用户再次点开抽屉时, 咱们根据props.visible的变化,来从新让子组件渲染出来,这样就实现了组件卸载的完整流程.

2.4 实现getContainer

getContainer主要用来控制抽屉组件的渲染位置,默认会渲染到body下, 为了提供更灵活的配置,咱们须要让抽屉能够渲染到任何元素下,这样又怎么实现呢? 这块实现咱们能够采用React Portals来实现,具体api介绍以下:

Portal 提供了一种将子节点渲染到存在于父组件之外的 DOM 节点的优秀的方案。第一个参数（child）是任何可渲染的 React 子元素，例如一个元素，字符串或 fragment。第二个参数（container）是一个 DOM 元素。

具体使用以下:

render() {
  // `domNode` 是一个能够在任何位置的有效 DOM 节点。
  return ReactDOM.createPortal(
    this.props.children,
    domNode
  );
}
复制代码

因此基于这个api咱们就能把抽屉渲染到任何元素下了, 具体实现以下:

const childDom = (
    <div className={styles.xDrawerWrap} style={{ position: getContainer === false ? 'absolute' : 'fixed', width: visible ? '100%' : '0', zIndex }} > { !!mask && <div className={styles.xDrawerMask} onClick={maskClosable ? handleClose : null}></div> } <div className={styles.xDrawerContent} style={{ width, [placement]: visible ? 0 : '-100%', ...drawerStyle }}> { isDesChild ? null : children } { !!closable && <span className={styles.xCloseBtn} onClick={handleClose}>X</span> } </div> </div>
  )

  return getContainer === false ? childDom 
            : ReactDOM.createPortal(childDom, getContainer)
复制代码

由于这里getContainer要支持3种状况,一种是用户不配置属性,那么默认就挂载到body下,还有就是用户传的值为false, 那么就为最近的父元素, 他若是传一个dom元素,那么将挂载到该元素下,因此以上代码咱们会分状况考虑,还有一点要注意,当抽屉打开时,咱们要让父元素溢出隐藏,不让其滚动,因此咱们在这里要设置一下:

useEffect(() => {
    setVisible(() => {
      if(getContainer !== false && props.visible) {
        getContainer.style.overflow = 'hidden'
      }
      return props.visible
    })
    setIsDesChild(false)
  }, [props.visible, getContainer])
复制代码

当关闭时恢复逻辑父级的overflow, 避免影响外部样式:

const handleClose = () => {
    onClose && onClose()
    setVisible((prev) => {
      if(getContainer !== false && prev) {
        getContainer.style.overflow = 'auto'
      }
      return false
    })
    if(destroyOnClose) {
      setIsDesChild(true)
    }
  }
复制代码

2.5 实现placement

placement主要用来控制抽屉的弹出方向, 能够从左弹出,也能够从右弹出, 实现过程也比较简单,咱们主要要更具属性动态修改定位属性便可,这里咱们会用到es新版的新特性,对象的变量属性. 核心代码以下:

<div className={styles.xDrawerContent} style={{ width, [placement]: visible ? 0 : '-100%', ...drawerStyle }}>
 </div>
复制代码

这样,不管是上下左右,均可以完美实现了.

2.6 健壮性支持, 咱们采用react提供的propTypes工具:

import PropTypes from 'prop-types'
// ...
Drawer.propTypes = {
  visible: PropTypes.bool,
  closable: PropTypes.bool, 
  destroyOnClose: PropTypes.bool, 
  getContainer: PropTypes.element, 
  maskClosable: PropTypes.bool, 
  mask: PropTypes.bool, 
  drawerStyle: PropTypes.object, 
  width: PropTypes.oneOfType([
    PropTypes.string,
    PropTypes.number
  ]),
  zIndex: PropTypes.number,
  placement: PropTypes.string, 
  onClose: PropTypes.func
}
复制代码

关于prop-types的使用官网上有很详细的案例,这里说一点就是oneOfType的用法, 它用来支持一个组件多是多种类型中的一个. 组件相关css代码以下:

.xDrawerWrap {
  top: 0;
  height: 100vh;
  overflow: hidden;
  .xDrawerMask {
    position: absolute;
    left: 0;
    right: 0;
    top: 0;
    bottom: 0;
    background-color: rgba(0, 0, 0, .5);
  }
  .xDrawerContent {
    position: absolute;
    top: 0;
    padding: 16px;
    height: 100%;
    transition: all .3s;
    background-color: #fff;
    box-shadow: 0 0 20px rgba(0,0,0, .2);
    .xCloseBtn {
      position: absolute;
      top: 10px;
      right: 10px;
      color: #ccc;
      cursor: pointer;
    }
  }
}
复制代码

经过以上步骤, 一个功能强大的的drawer组件就完成了,关于代码中的css module和classnames的使用你们能够本身去官网学习,很是简单.若是不懂的能够在评论区提问,笔者看到后会第一时间解答.

最后

后续笔者将会继续实现

modal(模态窗),
alert(警告提示),
badge(徽标),
table(表格),
tooltip(工具提示条),
Skeleton(骨架屏),
Message(全局提示),
form(form表单),
switch(开关),
日期/日历,
二维码识别器组件

等组件, 来复盘笔者多年的组件化之旅.

若是想获取组件设计系列完整源码, 或者想学习更多H5游戏, webpack，node，gulp，css3，javascript，nodeJS，canvas数据可视化等前端知识和实战，欢迎在公号《趣谈前端》加入咱们的技术群一块儿学习讨论，共同探索前端的边界。