W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
彈出模態(tài)框,常用于消息提示、消息確認(rèn)、在當(dāng)前頁面內(nèi)完成特定的交互操作
彈出框組件支持函數(shù)調(diào)用和組件調(diào)用兩種方式
Dialog 是一個(gè)函數(shù)而不是組件,因此可以直接調(diào)用,展示對(duì)應(yīng)的提示彈窗
import { Dialog } from 'vant';
Dialog({ message: '提示' });
通過組件調(diào)用 Dialog 時(shí),可以通過下面的方式進(jìn)行注冊(cè)
import Vue from 'vue';
import { Dialog } from 'vant';
// 全局注冊(cè)
Vue.use(Dialog);
// 局部注冊(cè)
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)按鈕
Dialog.confirm({
title: '標(biāo)題',
message: '彈窗內(nèi)容'
}).then(() => {
// on confirm
}).catch(() => {
// on cancel
});
function beforeClose(action, done) {
if (action === 'confirm') {
setTimeout(done, 1000);
} else {
done();
}
}
Dialog.confirm({
title: '標(biāo)題',
message: '彈窗內(nèi)容',
beforeClose
});
引入 Dialog 組件后,會(huì)自動(dòng)在 Vue 的 prototype 上掛載 $dialog 方法,在所有組件內(nèi)部都可以直接調(diào)用此方法
export default {
mounted() {
this.$dialog.alert({
message: '彈窗內(nèi)容'
});
}
}
如果需要在彈窗內(nèi)嵌入組件或其他自定義內(nèi)容,可以使用組件調(diào)用的方式
<van-dialog v-model="show" title="標(biāo)題" show-cancel-button>
<img src="https://img.yzcdn.cn/vant/apple-3.jpg" rel="external nofollow" >
</van-dialog>
export default {
data() {
return {
show: false
};
}
}
方法名 | 說明 | 參數(shù) | 返回值 |
---|---|---|---|
Dialog | 展示彈窗 | options | Promise |
Dialog.alert | 展示消息提示彈窗 | options | Promise |
Dialog.confirm | 展示消息確認(rèn)彈窗 | options | Promise |
Dialog.setDefaultOptions | 修改默認(rèn)配置,對(duì)所有 Dialog 生效 | options | void |
Dialog.resetDefaultOptions | 重置默認(rèn)配置,對(duì)所有 Dialog 生效 | - | void |
Dialog.close | 關(guān)閉彈窗 | - | void |
通過函數(shù)調(diào)用 Dialog 時(shí),支持傳入以下選項(xiàng):
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
title | 標(biāo)題 | string | - |
width v2.2.7 | 彈窗寬度,默認(rèn)單位為px | number | string | 320px |
message | 文本內(nèi)容,支持通過\n 換行 | string | - |
messageAlign | 內(nèi)容對(duì)齊方式,可選值為left right | string | center |
className | 自定義類名 | any | - |
showConfirmButton | 是否展示確認(rèn)按鈕 | boolean | true |
showCancelButton | 是否展示取消按鈕 | boolean | false |
confirmButtonText | 確認(rèn)按鈕文案 | string | 確認(rèn) |
confirmButtonColor | 確認(rèn)按鈕顏色 | string | #1989fa |
cancelButtonText | 取消按鈕文案 | string | 取消 |
cancelButtonColor | 取消按鈕顏色 | string | black |
overlay | 是否展示遮罩層 | boolean | true |
overlayClass v2.2.7 | 自定義遮罩層類名 | string | - |
overlayStyle v2.2.7 | 自定義遮罩層樣式 | object | - |
closeOnPopstate v2.0.5 | 是否在頁面回退時(shí)自動(dòng)關(guān)閉 | boolean | false |
closeOnClickOverlay | 是否在點(diǎn)擊遮罩層后關(guān)閉彈窗 | boolean | false |
lockScroll | 是否鎖定背景滾動(dòng) | boolean | true |
beforeClose | 關(guān)閉前的回調(diào)函數(shù), 調(diào)用 done() 后關(guān)閉彈窗, 調(diào)用 done(false) 阻止彈窗關(guān)閉 | (action, done) => void | - |
transition v2.2.6 | 動(dòng)畫類名,等價(jià)于 transition 的name 屬性 | string | - |
getContainer | 指定掛載的節(jié)點(diǎn),用法示例 | string | () => Element | body |
通過組件調(diào)用 Dialog 時(shí),支持以下 Props:
參數(shù) | 說明 | 類型 | 默認(rèn)值 |
---|---|---|---|
v-model | 是否顯示彈窗 | boolean | - |
title | 標(biāo)題 | string | - |
width v2.2.7 | 彈窗寬度,默認(rèn)單位為px | number | string | 320px |
message | 文本內(nèi)容,支持通過\n 換行 | string | - |
message-align | 內(nèi)容對(duì)齊方式,可選值為left right | string | center |
show-confirm-button | 是否展示確認(rèn)按鈕 | boolean | true |
show-cancel-button | 是否展示取消按鈕 | boolean | false |
confirm-button-text | 確認(rèn)按鈕文案 | string | 確認(rèn) |
confirm-button-color | 確認(rèn)按鈕顏色 | string | #1989fa |
cancel-button-text | 取消按鈕文案 | string | 取消 |
cancel-button-color | 取消按鈕顏色 | string | black |
overlay | 是否展示遮罩層 | boolean | true |
overlay-class v2.2.7 | 自定義遮罩層類名 | string | - |
overlay-style v2.2.7 | 自定義遮罩層樣式 | object | - |
close-on-popstate v2.0.5 | 是否在頁面回退時(shí)自動(dòng)關(guān)閉 | boolean | false |
close-on-click-overlay | 是否在點(diǎn)擊遮罩層后關(guān)閉彈窗 | boolean | false |
lazy-render | 是否在顯示彈層時(shí)才渲染節(jié)點(diǎn) | boolean | true |
lock-scroll | 是否鎖定背景滾動(dòng) | boolean | true |
before-close | 關(guān)閉前的回調(diào)函數(shù), 調(diào)用 done() 后關(guān)閉彈窗, 調(diào)用 done(false) 阻止彈窗關(guān)閉 | (action, done) => void | - |
transition v2.2.6 | 動(dòng)畫類名,等價(jià)于 transtion 的name 屬性 | string | - |
get-container | 指定掛載的節(jié)點(diǎn),用法示例 | string | () => Element | - |
通過組件調(diào)用 Dialog 時(shí),支持以下事件:
事件 | 說明 | 回調(diào)參數(shù) |
---|---|---|
confirm | 點(diǎn)擊確認(rèn)按鈕時(shí)觸發(fā) | - |
cancel | 點(diǎn)擊取消按鈕時(shí)觸發(fā) | - |
open | 打開彈窗時(shí)觸發(fā) | - |
opened | 打開彈窗且動(dòng)畫結(jié)束后觸發(fā) | - |
close | 關(guān)閉彈窗時(shí)觸發(fā) | - |
closed | 關(guān)閉彈窗且動(dòng)畫結(jié)束后觸發(fā) | - |
通過組件調(diào)用 Dialog 時(shí),支持以下插槽:
名稱 | 說明 |
---|---|
default | 自定義內(nèi)容 |
title | 自定義標(biāo)題 |
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: