antd Dialog 学习笔记

聊聊 AntD 中的 Dialog

先介绍三种常用的用法,

  • 受控模式,通过 visible 控制 Dialog 在目标组件中的显示,这个时最简单的用法。
const Demo: React.FC = () => {
  const [visible, setVisible] = React.useState<boolean>(false);
  return (
    <Modal visible={visible} close={() => setVisible(false)}>
      <div>I am dialog body</div>
    </Modal>
  );
};
  • 函数式调用,但是 Dialog 组件还在调用者的 VD 树上,可以通过 context 对其页面刷新进行影响,但是通过 setState 很难,因为闭包的原因或者类似于 memo 的原因,dialog body 以及不在最近一次刷新的范畴内,因为它属于闭包。
    Notes:必须要将 elements 放到 render 函数里面
const Demo:React.FC=()=>{
    const [fns,elements]=Modal.useModal();
    const openDialog=()=>{
        const {update,destory}=fns.info({
            content:<div>I am dialog body</div>
        })
    }

    return (
        <Button onClick={()=>openDialog()}>Open Dialog</Button>
        {elements}
    )
}
  • 函数式调用,但是 Dialog 组件以及不在调用者的 VD 树上了,连 Context 也无法影响到它了。
function openDialog() {
  const { update, destory } = Modal.info({
    content: <div>I am dialog body</div>,
  });
}

rc-dialog 这个组件职责是什么?

这些个组件总是很复杂,让人看的云里雾里,很多的辅助功能将原本的功能给掩盖了,让初学者看得很累。

  • 它负责将某个组件(DialogBody)Portal 到 getContainer 下面,默认是 document.body。
  • 它提供了一些额外的功能,例如 Mask, Dialog 外面在添加 header,close,footer 等。
  • 它还提供了动画,还有垂直方向滚动条出现时的页面抖动问题,通过修改 width 来实现

关闭的过程逻辑如下: onClose -> 外部组件调用 setVisible(false), Dialog 然后发现 visible=false, -> CSSMotion 开始走 leave 动画,动画结束后发出 afterClose 事件,然后在 DialogWrapper 里面会 返回 null,
这样整个 Dialog 就返回 null.

antd-modal 这个组件封装了什么?

  • Modal 这个组件,提供了默认的 footer,样式,类名,关闭按钮等这些东西。
  • ConfirmDialog 这个组件是在Modal的基础上做了封装,它去除了 Modal 里面默认的 header,footer,完全由自己内部定义实现了。注意是为了提供 info,warning,error,confirm,success 这五种风格的弹框。
  • HookModal 是封装了ConfirmDialog,它负责关闭与刷新 ConfirmDialog,同时将这两个接口暴露给外面。它是给useModal使用的。
  • useModal() hook 函数,提供了函数式动态打开 info,warning,error,confirm,success弹框的方式,这种方式创建的组件需要放在当前调用组件的 render 函数里,同在一棵树上。
  • info(),warning(),error(),confirm(),success(),也是函数式调用打开弹框,但是他们不在当前调用树上面。

学习一下useModal,

它的功能就是返回一个 ReactElement(用作容器),以及往这个 ReactElement 里面添加(删除)一个元素的方法。它主要使用了usePatchElement()这个 hook 函数,这个函数很简单,很有用。它就是返回一个容器,以及往容器中添加元素的方法,调用这个方法会返回删除这个元素的方法。我们只要将这个容器放到我们调用的 VD 上就行了,同时,我们可以通过 memo,让这个容器里的东西不参与当前 VD 的刷新,来提高性能。

export default function usePatchElement(): [
  React.ReactElement[],
  (element: React.ReactElement) => Function
] {
  const [elements, setElements] = React.useState<React.ReactElement[]>([]);

  const patchElement = React.useCallback((element: React.ReactElement) => {
    // append a new element to elements (and create a new ref)
    setElements((originElements) => [...originElements, element]);

    // return a function that removes the new element out of elements (and create a new ref)
    // it works a little like useEffect
    return () => {
      setElements((originElements) =>
        originElements.filter((ele) => ele !== element)
      );
    };
  }, []);

  return [elements, patchElement];
}

考虑写一个函数式弹框的组件,由如下需求:

  • 可以带 title,或者不带 title,或者定制化的 title,
  • closable icon
  • 可以带 footer,或者不带 footer,ok? cancel? button
  • 支持在特定的位置弹出来,或者居中弹出
  • 支持同一棵 VD 树,或者不同的 VD 树。
上一篇:antd-react自定义显示表格操作按钮


下一篇:【前端开发】dva+antd+react