Vant3 Dialog 彈出框

Dialog 彈出框

介紹

彈出模態(tài)框，常用于消息提示、消息確認(rèn)，或在當(dāng)前頁面內(nèi)完成特定的交互操作，支持函數(shù)調(diào)用和組件調(diào)用兩種方式。

實(shí)例演示

函數(shù)調(diào)用

Dialog 是一個(gè)函數(shù)，調(diào)用后會直接在頁面中彈出相應(yīng)的模態(tài)框。

import { Dialog } from 'vant';

Dialog({ message: '提示' });

組件調(diào)用

通過組件調(diào)用 Dialog 時(shí)，可以通過下面的方式進(jìn)行注冊：

import { createApp } from 'vue';
import { Dialog } from 'vant';

// 全局注冊
const app = createApp();
app.use(Dialog);

// 局部注冊
export default {
  components: {
    [Dialog.Component.name]: Dialog.Component,
  },
};

代碼演示

消息提示

用于提示一些消息，只包含一個(gè)確認(rèn)按鈕。

Dialog.alert({
  title: '標(biāo)題',
  message: '彈窗內(nèi)容',
}).then(() => {
  // on close
});

Dialog.alert({
  message: '彈窗內(nèi)容',
}).then(() => {
  // on close
});

消息確認(rèn)

用于確認(rèn)消息，包含取消和確認(rèn)按鈕。

Dialog.confirm({
  title: '標(biāo)題',
  message: '彈窗內(nèi)容',
})
  .then(() => {
    // on confirm
  })
  .catch(() => {
    // on cancel
  });

圓角按鈕風(fēng)格

將 theme 選項(xiàng)設(shè)置為 round-button 可以展示圓角按鈕風(fēng)格的彈窗。

Dialog.alert({
  title: '標(biāo)題',
  message: '彈窗內(nèi)容',
  theme: 'round-button',
}).then(() => {
  // on close
});

Dialog.alert({
  message: '彈窗內(nèi)容',
  theme: 'round-button',
}).then(() => {
  // on close
});

異步關(guān)閉

通過 beforeClose 屬性可以傳入一個(gè)回調(diào)函數(shù)，在彈窗關(guān)閉前進(jìn)行特定操作。

const beforeClose = (action) =>
  new Promise((resolve) => {
    setTimeout(() => {
      if (action === 'confirm') {
        resolve(true);
      } else {
        // 攔截取消操作
        resolve(false);
      }
    }, 1000);
  });

Dialog.confirm({
  title: '標(biāo)題',
  message: '彈窗內(nèi)容',
  beforeClose,
});

全局方法

通過 app.use 全局注冊 Dialog 組件后，會自動在 app 的所有子組件上掛載 $dialog 方法，在所有組件內(nèi)部都可以直接調(diào)用此方法。

export default {
  mounted() {
    this.$dialog.alert({
      message: '彈窗內(nèi)容',
    });
  },
};

Tips: 由于 setup 選項(xiàng)中無法訪問 this，因此不能使用上述方式，請通過 import 引入。

組件調(diào)用

如果需要在彈窗內(nèi)嵌入組件或其他自定義內(nèi)容，可以使用組件調(diào)用的方式。

<van-dialog v-model:show="show" title="標(biāo)題" show-cancel-button>
  <img src="https://img.yzcdn.cn/vant/apple-3.jpg" rel="external nofollow"  />
</van-dialog>

import { ref } from 'vue';

export default {
  setup() {
    const show = ref(false);
    return { show };
  },
};

API

方法

DialogOptions

通過函數(shù)調(diào)用 Dialog 時(shí)，支持傳入以下選項(xiàng)：

Props

通過組件調(diào)用 Dialog 時(shí)，支持以下 Props：

Events

通過組件調(diào)用 Dialog 時(shí)，支持以下事件：

Slots

通過組件調(diào)用 Dialog 時(shí)，支持以下插槽：

樣式變量

組件提供了下列 CSS 變量，可用于自定義樣式，使用方法請參考 ConfigProvider 組件。

常見問題

在 beforeRouteLeave 里調(diào)用 Dialog 無法展示？

將 closeOnPopstate 屬性設(shè)置為 false 即可。

Dialog.alert({
  title: '標(biāo)題',
  message: '彈窗內(nèi)容',
  closeOnPopstate: false,
}).then(() => {
  // on close
});

在 JSX 中渲染 Dialog 組件無法展示？

請注意 Dialog 是一個(gè)函數(shù)，Dialog.Component 才是 Dialog 對應(yīng)的組件。JSX 調(diào)用彈窗的正確姿勢如下：

export default {
  setup() {
    const show = ref(false);
    return () => <Dialog.Component v-model={[show, 'show']} />;
  },
};