Antd Trigger 类组件结构简析

Antd 组件库中,包含有 Trigger 的组件,它们都有类似的组件结构。以下组件都可以归为这一类:

  • ToolTip

  • Popover

  • PopConfrim

  • Cascader

  • DataPicker

  • TimePicker

  • Select

  • TreeSelect

  • Dropdown

这些组件的特点,就是都有弹框。通过点击,hover,或是改变焦点的方式,打开或关闭弹框。而这个特点,就是 Trigger 组件所要实现的功能:弹框可见性的控制。

看图

先看很黄的这一组,Popover/PopConfirm -> Tooltip -> rcTooltip -> rcTrigger -> child

这类组件,可以为弹框传入自定义的内容或组件。Popover 和 PopConfirm 都是从 Tooltip 整容来的,为弹窗添加了常用的功能。

其中,内部组件 Trigger,负责为组件添加监听事件,来控制弹框的可见性。

// rc-trigger\lib\Trigger.js
var ALL_HANDLERS = ['onClick','onMouseDown','onTouchStart','onMouseEnter','onMouseLeave','onFocus','onBlur'];

可以看出,Trigger 支持 onClick,onMouseDown,onTouchStart,onMouseEnter,onFocus 来触发弹窗,通过 onClick,onMouseLeave,onBlur 来取消弹窗。弹窗的打开与关闭方式可以不是对应的,例如可以 mouseEnter 打开,click 关闭。我们写弹窗组件的时候,也能把这一部分逻辑抽象出来,感觉应该很棒。

当我们用 React 写弹窗组件的时候,肯定想过要如何添加点击取消功能。使用遮罩,会有一次无效操作,对选框类弹框就不太好了。Antd 的做法是添加全局监听事件,通过判断点击的元素,是否包含在组件或弹框中,即可判断是否为取消弹框的点击。下面是 Antd 中判断组件包含性的方法

function contains(root,n) {
    var node = n;
    while (node) {
        if (node === root) {
            return true;
        }
        node = node.parentNode;
    }
    return false;
}

除了添加监听事件,Trigger 还有一个很重要的功能,就是弹框的渲染。Trigger 中的弹框并没有渲染进正常的文档流中,它 mixin 了一个 getContainerRenderMixin 内部组件,该组件通过 React 的非稳定方法 unstable_renderSubtreeIntoContainer(),将组件挂载到 document.body 下。因为如果把弹窗渲染在正常文档流中,组件的定位会受到父元素定位的影响,我们知道,如果父元素为静态定位,定位标的就会变成再父一级元素。将弹窗挂载在 body 下,就能解决这个问题。

虽然弹框脱离了正常文档流,但其仍受父组件控制。而组件包裹的子组件仍然渲染在正常文档流。

// rc-util\lib\getContainerRenderMixin2
_reactDom2["default"].unstable_renderSubtreeIntoContainer(instance,component,instance._container,function callback() {
   instance._component = this;
   if (ready) {
       ready.call(this);
   }
});

绿

很绿的一组,也是寄生于 Trigger,但不属于 Tooltip 一族,它们的弹窗内容被传入了定义好的组件,定制性更强。从 Trigger 这一层开始,结构都差不多。

蓝色代表忧伤,看到这么多层嵌套,看着是挺忧伤的。Popup -> Animate -> AnimateChild -> rcAlign -> PopupInner -> LazyRenderBox -> content

Popup

Popup 组件负责按参数,配置弹框的各种特性,像要不要遮罩、zIndex设多少、隐藏要不要卸载掉弹框等,把这些属性渲染到功能组件中

Animate

Animate 和 AnimateChild,顾名思义,就是搞动画的。Animate 组件类似于 React 的 ReactTransitionGroup 组件,它会调用子组件中的钩子函数,来控制动画效果。

// rc-animate\lib\AnimateChild.js
componentWillUnmount: function componentWillUnmount() {
    this.stop();
},componentWillEnter: function componentWillEnter(done) {
    if (_util2["default"].isEnterSupported(this.props)) {
        this.transition('enter',done);
    } else {
        done();
    }
},componentWillAppear: function componentWillAppear(done) {
    if (_util2["default"].isAppearSupported(this.props)) {
        this.transition('appear',componentWillLeave: function componentWillLeave(done) {
    if (_util2["default"].isLeaveSupported(this.props)) {
      this.transition('leave',done);
    } else {
      done();
    }
},

AnimateChild

AnimateChild 在生命周期的钩子函数中,通过改变类名,如改变后缀 -appear,-enter,-leave,来执行动画效果。Antd 动画主要是 CSS3 动画。

.zoom-motion(@className,@keyframeName,@duration: @animation-duration-base) {
  .make-motion(@className,@duration);
  .@{className}-enter,.@{className}-appear {
    transform: scale(0); // need this by yiminghe
    animation-timing-function: @ease-out-circ;
  }
  .@{className}-leave {
    animation-timing-function: @ease-in-out-circ;
  }
}

Align

Align 组件负责对齐元素。前面说了,Popup 脱离了正常文档流,挂在了 document.body 上。那如何把两个风马牛不相及的元素对齐呢?还要考虑到窗口改变时也能对得上。靠的是元素的可视矩阵(区域)计算,说的挺轻巧,反正代码我还没看懂。

// rc-align\node_modules\dom-align\lib\index.js
function domAlign(el,refNode,align) {
    // masive code
}

PopupInner

渲染了个div,添了个 LazyRenderBox 功能组件

LazyRenderBox

这个组件很懒,因为你看不见它的时候,它就不干活了。

shouldComponentUpdate: function shouldComponentUpdate(nextProps) {
    return nextProps.hiddenClassName || nextProps.visible;
},

content

之前的一沓都是套在外面的衣服,你的 content 才是用户想看的。

尽管 React 组件树很复杂,但是最终渲染出来的 Dom 树却是格外的清爽。

最后

Antd 不简单,看来写一套靠谱的组件可不是闹着玩的,一些看似简单的功能,实现起来却是十分的复杂。一沓代码看下来,可能就领悟了皮毛,却感觉已经受益匪浅了。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


react 中的高阶组件主要是对于 hooks 之前的类组件来说的,如果组件之中有复用的代码,需要重新创建一个父类,父类中存储公共代码,返回子类,同时把公用属性...
我们上一节了解了组件的更新机制,但是只是停留在表层上,例如我们的 setState 函数式同步执行的,我们的事件处理直接绑定在了 dom 元素上,这些都跟 re...
我们上一节了解了 react 的虚拟 dom 的格式,如何把虚拟 dom 转为真实 dom 进行挂载。其实函数是组件和类组件也是在这个基础上包裹了一层,一个是调...
react 本身提供了克隆组件的方法,但是平时开发中可能很少使用,可能是不了解。我公司的项目就没有使用,但是在很多三方库中都有使用。本小节我们来学习下如果使用该...
mobx 是一个简单可扩展的状态管理库,中文官网链接。小编在接触 react 就一直使用 mobx 库,上手简单不复杂。
我们在平常的开发中不可避免的会有很多列表渲染逻辑,在 pc 端可以使用分页进行渲染数限制,在移动端可以使用下拉加载更多。但是对于大量的列表渲染,特别像有实时数据...
本小节开始前,我们先答复下一个同学的问题。上一小节发布后,有小伙伴后台来信问到:‘小编你只讲了类组件中怎么使用 ref,那在函数式组件中怎么使用呢?’。确实我们...
上一小节我们了解了固定高度的滚动列表实现,因为是固定高度所以容器总高度和每个元素的 size、offset 很容易得到,这种场景也适合我们常见的大部分场景,例如...
上一小节我们处理了 setState 的批量更新机制,但是我们有两个遗漏点,一个是源码中的 setState 可以传入函数,同时 setState 可以传入第二...
我们知道 react 进行页面渲染或者刷新的时候,会从根节点到子节点全部执行一遍,即使子组件中没有状态的改变,也会执行。这就造成了性能不必要的浪费。之前我们了解...
在平时工作中的某些场景下,你可能想在整个组件树中传递数据,但却不想手动地通过 props 属性在每一层传递属性,contextAPI 应用而生。
楼主最近入职新单位了,恰好新单位使用的技术栈是 react,因为之前一直进行的是 vue2/vue3 和小程序开发,对于这些技术栈实现机制也有一些了解,最少面试...
我们上一节了了解了函数式组件和类组件的处理方式,本质就是处理基于 babel 处理后的 type 类型,最后还是要处理虚拟 dom。本小节我们学习下组件的更新机...
前面几节我们学习了解了 react 的渲染机制和生命周期,本节我们正式进入基本面试必考的核心地带 -- diff 算法,了解如何优化和复用 dom 操作的,还有...
我们在之前已经学习过 react 生命周期,但是在 16 版本中 will 类的生命周期进行了废除,虽然依然可以用,但是需要加上 UNSAFE 开头,表示是不安...
上一小节我们学习了 react 中类组件的优化方式,对于 hooks 为主流的函数式编程,react 也提供了优化方式 memo 方法,本小节我们来了解下它的用...
开源不易,感谢你的支持,❤ star me if you like concent ^_^
hel-micro,模块联邦sdk化,免构建、热更新、工具链无关的微模块方案 ,欢迎关注与了解
本文主题围绕concent的setup和react的五把钩子来展开,既然提到了setup就离不开composition api这个关键词,准确的说setup是由...
ReactsetState的执行是异步还是同步官方文档是这么说的setState()doesnotalwaysimmediatelyupdatethecomponent.Itmaybatchordefertheupdateuntillater.Thismakesreadingthis.staterightaftercallingsetState()apotentialpitfall.Instead,usecom