Skip to content

Modal 模态框

基础用法

  • 用于创建弹出层,显示信息或进行交互。
  • 提供多种样式和交互方式。
  • 如果需要对话框,那么官方的 uni.showModal 应该足以满足你的需求。当你需要更自由地控制动画、插槽时,不妨试试本组件。
vue
<template>
  <sn-modal title="标题" content="内容"></sn-modal>
</template>

更多演示请下载 demo 查看

属性

参数说明类型默认值可选值
title模态框标题String--
titleAlign标题对齐方式Stringcenterleft | center | right
titleSize标题字体大小String$3+1-
titleFont标题字体样式Stringmisans-semibold-
titleColor标题颜色String$title-
bgColor背景颜色String$front-
borderRadius圆角大小String$normal-
content模态框内容String--
contentAlign内容对齐方式Stringcenterleft | center | right
contentSize内容字体大小String$2+1-
contentColor内容颜色String$text-
contentFont内容字体样式Stringmisans-normal-
buttonType按钮类型Stringembedembed | float
buttonBorder按钮边框样式String0.5px solid $line-
confirmText确定按钮文本String确定-
confirmTextColor确定按钮文本颜色String$primaryDark-
confirmTextSize确定按钮文本大小String$3-
showCancel是否显示取消按钮Booleantruetrue |false
showConfirm是否显示确定按钮Booleantruetrue |false
cancelText取消按钮文本String取消-
cancelTextColor取消按钮文本颜色String$text-
cancelTextSize取消按钮文本大小String$3-
position弹出位置Stringcentercenter | top | bottom | left | right
aniTime动画时长(单位:ms)String350ms-
maskClose点击蒙层是否关闭Booleanfalsetrue | false
disabled是否禁用Booleanfalsetrue | false
preventBack是否阻止返回事件Booleanfalsetrue | false
maskOpacity遮罩层透明度Number0.4-
customStyle自定义模态框样式UTSJSONObject{}-

插槽

名称说明
header替换标题内容
content替换内容区域
actions替换操作按钮区域

事件

名称类型说明
clickMask() => void点击遮罩时触发
confirm() => void确认操作时触发
cancel() => void取消操作时触发
close() => void关闭时触发
open() => void打开时触发

方法

名称参数返回值描述
open--打开模态框
close--关闭模态框

使用 MIT 协议