Dialog 对话框

介绍

模态对话框,在浮层中显示,引导用户进行相关操作,常用于消息提示、消息确认,或在当前页面内完成特定的交互操作。

弹出框组件支持函数调用和组件调用两种方式。

安装

  1. import { createApp } from 'vue';
  2. import { Dialog } from '@nutui/nutui';
  3. const app = createApp();
  4. app.use(Dialog);

函数调用

  1. Dialog({
  2. title: '基础弹框',
  3. content: '支持函数调用和组件调用两种方式。'
  4. });
  5. Dialog({
  6. content: '无标题弹框'
  7. });
  8. Dialog({
  9. title: '提示弹框',
  10. content: '支持函数调用和组件调用两种方式。',
  11. noCancelBtn: true,
  12. });

teleport 使用,挂载到指定节点

  1. <nut-dialog teleport="#app" ... />
  1. Dialog({
  2. teleport: '#app',
  3. ...
  4. });
  5. Dialog({
  6. teleport: '.demo',
  7. ...
  8. });

函数调用 proxy.&dialog(…)

  1. import { getCurrentInstance } from 'vue';
  2. setup(){
  3. const { proxy } = getCurrentInstance();
  4. proxy.$dialog({
  5. title: '基础弹框',
  6. content: '支持函数调用和组件调用两种方式。'
  7. });
  8. }

标签式组件使用

  1. <nut-dialog :title="title" :close-on-click-overlay="false" :content="content" v-model:visible="visible"></nut-dialog>
  1. import { ref } from 'vue';
  2. import { Dialog } from '@nutui/nutui';
  3. export default {
  4. setup() {
  5. const visible = ref(true);
  6. const title = '标签式使用';
  7. const content = '内容';
  8. return { visible,title,content };
  9. },
  10. };

API

字段说明类型默认值
title标题String-
content内容,支持HTMLString-
teleport指定挂载节点String“body”
closeOnClickOverlay点击蒙层是否关闭对话框Booleanfalse
noFooter是否隐藏底部按钮栏Booleanfalse
noOkBtn是否隐藏确定按钮Booleanfalse
noCancelBtn是否隐藏取消按钮Booleanfalse
cancelText取消按钮文案String”取消“
okText确定按钮文案String”确定“
okBtnDisabled禁用确定按钮Booleanfalse
cancelAutoClose取消按钮是否默认关闭弹窗Booleantrue
textAlign文字对齐方向,可选值同css的text-alignString“center”
closeOnPopstate是否在页面回退时自动关闭Booleanfalse
onUpdate更新Booleanfalse
onOk确定按钮回调Function-
onCancel取消按钮回调Function-
onOpen背景是否锁定Function-
onClosed关闭回调,任何情况关闭弹窗都会触发Function-

Props

字段说明类型默认值
title标题String-
content内容,支持HTMLString-
teleport指定挂载节点String“body”
close-on-click-overlay点击蒙层是否关闭对话框Booleanfalse
no-footer是否隐藏底部按钮栏Booleanfalse
no-ok-btn是否隐藏确定按钮Booleanfalse
no-cancel-btn是否隐藏取消按钮Booleanfalse
cancel-text取消按钮文案String”取消“
ok-text确定按钮文案String”确 定“
ok-btn-disabled禁用确定按钮Booleanfalse
cancel-auto-close取消按钮是否默认关闭弹窗Booleantrue
text-align文字对齐方向,可选值同css的text-alignString“center”
close-on-popstate是否在页面回退时自动关闭Booleanfalse
lock-scroll背景是否锁定Booleanfalse

Events

字段说明类型默认值
ok确定按钮回调Function-
cancel取消按钮回调Function-
closed关闭回调,任何情况关闭弹窗都会触发Function-

Slots

名称说明
header自定义标题区域
default自定义内容
footer自定义底部按钮区域

Dialog  对话框 - 图1