ant-design/components/modal/index.zh-CN.md

3.2 KiB
Raw Blame History

type category subtitle title
Feedback Components 对话框 Modal

模态对话框。

何时使用

需要用户处理事务,又不希望跳转页面以致打断工作流程时,可以使用 Modal 在当前页面正中打开一个浮层,承载相应的操作。

另外当需要一个简洁的确认框询问用户时,可以使用精心封装好的 ant.Modal.confirm() 等方法。

API

参数 说明 类型 默认值
visible 对话框是否可见 boolean
confirmLoading 确定按钮 loading boolean
title 标题 string|ReactNode
closable 是否显示右上角的关闭按钮 boolean true
onOk 点击确定回调 function(e)
onCancel 点击遮罩层或右上角叉或取消按钮的回调 function(e)
width 宽度 string|number 520
footer 底部内容,当不需要默认底部按钮时,可以设为 footer={null} string|ReactNode 确定取消按钮
okText 确认按钮文字 string 确定
cancelText 取消按钮文字 string 取消
maskClosable 点击蒙层是否允许关闭 boolean true
style 可用于设置浮层的样式,调整浮层位置等 object -
wrapClassName 对话框外层容器的类名 string -
afterClose Modal 完全关闭后的回调 function

清空旧数据

<Modal /> 组件有标准的 React 生命周期,关闭后状态不会自动清空。 如果希望每次打开都是新内容,需要自行手动清空旧的状态。或者打开时给 Modal 设置一个全新的 key React 会渲染出一个全新的对话框。

<Modal key={this.state.newRandomKey} visible={this.state.visible} />

Modal.xxx()

包括:

  • Modal.info
  • Modal.success
  • Modal.error
  • Modal.warning
  • Modal.confirm

以上均为一个函数,参数为 object具体属性如下

参数 说明 类型 默认值
title 标题 string|ReactNode
content 内容 string|ReactNode
onOk 点击确定回调,参数为关闭函数,返回 promise 时 resolve 后自动关闭 function
onCancel 取消回调,参数为关闭函数,返回 promise 时 resolve 后自动关闭 function
width 宽度 string|number 416
iconType 图标 Icon 类型 string question-circle
okText 确认按钮文字 string 确定
cancelText 取消按钮文字 string 取消
maskClosable 点击蒙层是否允许关闭 Boolean false