Skip to content

Modal 模态框 ​

展示标题、描述、插槽内容和操作按钮。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<!-- 模态框 -->
<fui-modal :show="showModal" title="提示" descr="确认提交吗?"
  @click="handleModalClick" @cancel="showModal = false" />

按钮点击后需由页面根据返回的索引处理,并更新 showModal。

属性 ​

除遮罩颜色和层级外,尺寸单位为 rpx。

属性类型说明官网默认值
showBoolean是否显示false
titleString标题-
sizeNumber / String标题字号34
colorString标题颜色#333
descrString描述内容-
descrSizeNumber / String描述字号28
descrColorString描述颜色#7F7F7F
buttonsArray按钮对象数组取消、确定
directionString按钮排列方向:row、columnrow
radiusNumber / String按钮圆角16
widthNumber / String模态框宽度640
topNumber / String垂直偏移,可为负数0
backgroundString背景色#FFFFFF
boxRadiusNumber / String容器圆角16
paddingNumber / String容器上下内边距32
maskBackgroundString遮罩颜色rgba(0,0,0,.6)
maskClosableBoolean点击遮罩是否触发 cancelfalse
zIndexNumber层级,nvue 不支持996

默认按钮为 [{ text: '取消', plain: true }, { text: '确定' }];按钮对象还可设置 color 和 background。

事件 ​

事件说明回调参数
click点击模态框按钮包含 index 和按钮字段的对象
cancel点击可关闭的遮罩{}

插槽 ​

插槽说明
default模态框的自定义内容