import{o as s,a,y as d}from"./vue-libs.b44bc779.js";const n={class:"van-doc-markdown-body"},e=d(`
\u5F39\u51FA\u6A21\u6001\u6846\uFF0C\u5E38\u7528\u4E8E\u6D88\u606F\u63D0\u793A\u3001\u6D88\u606F\u786E\u8BA4\uFF0C\u6216\u5728\u5F53\u524D\u9875\u9762\u5185\u5B8C\u6210\u7279\u5B9A\u7684\u4EA4\u4E92\u64CD\u4F5C\uFF0C\u652F\u6301\u51FD\u6570\u8C03\u7528\u548C\u7EC4\u4EF6\u8C03\u7528\u4E24\u79CD\u65B9\u5F0F\u3002
Dialog
\u662F\u4E00\u4E2A\u51FD\u6570\uFF0C\u8C03\u7528\u540E\u4F1A\u76F4\u63A5\u5728\u9875\u9762\u4E2D\u5F39\u51FA\u76F8\u5E94\u7684\u6A21\u6001\u6846\u3002
import { Dialog } from 'vant';
Dialog({ message: '\u63D0\u793A' });
Dialog \u7EC4\u4EF6\u662F\u4EE5\u51FD\u6570\u5F62\u5F0F\u63D0\u4F9B\u7684\uFF0C\u5982\u679C\u9879\u76EE\u4E2D\u4F7F\u7528 unplugin-vue-components
\u63D2\u4EF6\u6765\u81EA\u52A8\u5F15\u5165\u7EC4\u4EF6\u6837\u5F0F\uFF0C\u5219\u65E0\u6CD5\u6B63\u786E\u8BC6\u522B Dialog \u7EC4\u4EF6\uFF0C\u56E0\u6B64\u9700\u8981\u624B\u52A8\u5F15\u5165 Dialog \u7EC4\u4EF6\u7684\u6837\u5F0F\uFF1A
import 'vant/es/dialog/style';
\u4F60\u53EF\u4EE5\u5728\u9879\u76EE\u7684\u5165\u53E3\u6587\u4EF6\u6216\u516C\u5171\u6A21\u5757\u4E2D\u5F15\u5165 Dialog \u7EC4\u4EF6\u7684\u6837\u5F0F\uFF0C\u8FD9\u6837\u5728\u4E1A\u52A1\u4EE3\u7801\u4E2D\u4F7F\u7528 Dialog \u65F6\uFF0C\u4FBF\u4E0D\u518D\u9700\u8981\u91CD\u590D\u5F15\u5165\u6837\u5F0F\u4E86\u3002
\u901A\u8FC7\u7EC4\u4EF6\u8C03\u7528 Dialog \u65F6\uFF0C\u53EF\u4EE5\u901A\u8FC7\u4E0B\u9762\u7684\u65B9\u5F0F\u8FDB\u884C\u6CE8\u518C\uFF1A
import { createApp } from 'vue';
import { Dialog } from 'vant';
// \u5168\u5C40\u6CE8\u518C
const app = createApp();
app.use(Dialog);
// \u5C40\u90E8\u6CE8\u518C
export default {
components: {
[Dialog.Component.name]: Dialog.Component,
},
};
\u5728 script setup
\u4E2D\uFF0C\u53EF\u4EE5\u901A\u8FC7\u4EE5\u4E0B\u65B9\u5F0F\u4F7F\u7528\uFF1A
<script setup>
const VanDialog = Dialog.Component;
</script>
<template>
<!-- \u4E2D\u5212\u7EBF\u547D\u540D -->
<van-dialog />
<!-- \u4E5F\u652F\u6301\u5927\u9A7C\u5CF0\u547D\u540D -->
<VanDialog>
</template>
\u7528\u4E8E\u63D0\u793A\u4E00\u4E9B\u6D88\u606F\uFF0C\u53EA\u5305\u542B\u4E00\u4E2A\u786E\u8BA4\u6309\u94AE\u3002
Dialog.alert({
title: '\u6807\u9898',
message: '\u4EE3\u7801\u662F\u5199\u51FA\u6765\u7ED9\u4EBA\u770B\u7684\uFF0C\u9644\u5E26\u80FD\u5728\u673A\u5668\u4E0A\u8FD0\u884C\u3002',
}).then(() => {
// on close
});
Dialog.alert({
message: '\u751F\u547D\u8FDC\u4E0D\u6B62\u8FDE\u8F74\u8F6C\u548C\u5FD9\u5230\u6781\u9650\uFF0C\u4EBA\u7C7B\u7684\u4F53\u9A8C\u8FDC\u6BD4\u8FD9\u8FBD\u9614\u3001\u4E30\u5BCC\u5F97\u591A\u3002',
}).then(() => {
// on close
});
\u7528\u4E8E\u786E\u8BA4\u6D88\u606F\uFF0C\u5305\u542B\u53D6\u6D88\u548C\u786E\u8BA4\u6309\u94AE\u3002
Dialog.confirm({
title: '\u6807\u9898',
message:
'\u5982\u679C\u89E3\u51B3\u65B9\u6CD5\u662F\u4E11\u964B\u7684\uFF0C\u90A3\u5C31\u80AF\u5B9A\u8FD8\u6709\u66F4\u597D\u7684\u89E3\u51B3\u65B9\u6CD5\uFF0C\u53EA\u662F\u8FD8\u6CA1\u6709\u53D1\u73B0\u800C\u5DF2\u3002',
})
.then(() => {
// on confirm
})
.catch(() => {
// on cancel
});
\u5C06 theme \u9009\u9879\u8BBE\u7F6E\u4E3A round-button
\u53EF\u4EE5\u5C55\u793A\u5706\u89D2\u6309\u94AE\u98CE\u683C\u7684\u5F39\u7A97\u3002
Dialog.alert({
title: '\u6807\u9898',
message: '\u4EE3\u7801\u662F\u5199\u51FA\u6765\u7ED9\u4EBA\u770B\u7684\uFF0C\u9644\u5E26\u80FD\u5728\u673A\u5668\u4E0A\u8FD0\u884C\u3002',
theme: 'round-button',
}).then(() => {
// on close
});
Dialog.alert({
message: '\u751F\u547D\u8FDC\u4E0D\u6B62\u8FDE\u8F74\u8F6C\u548C\u5FD9\u5230\u6781\u9650\uFF0C\u4EBA\u7C7B\u7684\u4F53\u9A8C\u8FDC\u6BD4\u8FD9\u8FBD\u9614\u3001\u4E30\u5BCC\u5F97\u591A\u3002',
theme: 'round-button',
}).then(() => {
// on close
});
\u901A\u8FC7 beforeClose
\u5C5E\u6027\u53EF\u4EE5\u4F20\u5165\u4E00\u4E2A\u56DE\u8C03\u51FD\u6570\uFF0C\u5728\u5F39\u7A97\u5173\u95ED\u524D\u8FDB\u884C\u7279\u5B9A\u64CD\u4F5C\u3002
const beforeClose = (action) =>
new Promise((resolve) => {
setTimeout(() => {
if (action === 'confirm') {
resolve(true);
} else {
// \u62E6\u622A\u53D6\u6D88\u64CD\u4F5C
resolve(false);
}
}, 1000);
});
Dialog.confirm({
title: '\u6807\u9898',
message:
'\u5982\u679C\u89E3\u51B3\u65B9\u6CD5\u662F\u4E11\u964B\u7684\uFF0C\u90A3\u5C31\u80AF\u5B9A\u8FD8\u6709\u66F4\u597D\u7684\u89E3\u51B3\u65B9\u6CD5\uFF0C\u53EA\u662F\u8FD8\u6CA1\u6709\u53D1\u73B0\u800C\u5DF2\u3002',
beforeClose,
});
\u901A\u8FC7 app.use
\u5168\u5C40\u6CE8\u518C Dialog \u7EC4\u4EF6\u540E\uFF0C\u4F1A\u81EA\u52A8\u5728 app \u7684\u6240\u6709\u5B50\u7EC4\u4EF6\u4E0A\u6302\u8F7D $dialog
\u65B9\u6CD5\uFF0C\u5728\u6240\u6709\u7EC4\u4EF6\u5185\u90E8\u90FD\u53EF\u4EE5\u76F4\u63A5\u8C03\u7528\u6B64\u65B9\u6CD5\u3002
export default {
mounted() {
this.$dialog.alert({
message: '\u5F39\u7A97\u5185\u5BB9',
});
},
};
Tips: \u7531\u4E8E setup \u9009\u9879\u4E2D\u65E0\u6CD5\u8BBF\u95EE this\uFF0C\u56E0\u6B64\u4E0D\u80FD\u4F7F\u7528\u4E0A\u8FF0\u65B9\u5F0F\uFF0C\u8BF7\u901A\u8FC7 import \u5F15\u5165\u3002
\u5982\u679C\u9700\u8981\u5728\u5F39\u7A97\u5185\u5D4C\u5165\u7EC4\u4EF6\u6216\u5176\u4ED6\u81EA\u5B9A\u4E49\u5185\u5BB9\uFF0C\u53EF\u4EE5\u4F7F\u7528\u7EC4\u4EF6\u8C03\u7528\u7684\u65B9\u5F0F\u3002
<van-dialog v-model:show="show" title="\u6807\u9898" show-cancel-button>
<img src="https://fastly.jsdelivr.net/npm/@vant/assets/apple-3.jpeg" />
</van-dialog>
import { ref } from 'vue';
export default {
setup() {
const show = ref(false);
return { show };
},
};
\u65B9\u6CD5\u540D | \u8BF4\u660E | \u53C2\u6570 | \u8FD4\u56DE\u503C |
---|---|---|---|
Dialog | \u5C55\u793A\u5F39\u7A97 | options: DialogOptions | Promise<void> |
Dialog.alert | \u5C55\u793A\u6D88\u606F\u63D0\u793A\u5F39\u7A97 | options: DialogOptions | Promise<void> |
Dialog.confirm | \u5C55\u793A\u6D88\u606F\u786E\u8BA4\u5F39\u7A97 | options: DialogOptions | Promise<void> |
Dialog.setDefaultOptions | \u4FEE\u6539\u9ED8\u8BA4\u914D\u7F6E\uFF0C\u5BF9\u6240\u6709 Dialog \u751F\u6548 | options: DialogOptions | void |
Dialog.resetDefaultOptions | \u91CD\u7F6E\u9ED8\u8BA4\u914D\u7F6E\uFF0C\u5BF9\u6240\u6709 Dialog \u751F\u6548 | - | void |
Dialog.close | \u5173\u95ED\u5F39\u7A97 | - | void |
\u901A\u8FC7\u51FD\u6570\u8C03\u7528 Dialog
\u65F6\uFF0C\u652F\u6301\u4F20\u5165\u4EE5\u4E0B\u9009\u9879\uFF1A
\u53C2\u6570 | \u8BF4\u660E | \u7C7B\u578B | \u9ED8\u8BA4\u503C |
---|---|---|---|
title | \u6807\u9898 | string | - |
width | \u5F39\u7A97\u5BBD\u5EA6\uFF0C\u9ED8\u8BA4\u5355\u4F4D\u4E3A px | number | string | 320px |
message | \u6587\u672C\u5185\u5BB9\uFF0C\u652F\u6301\u901A\u8FC7 \\n \u6362\u884C | string | () => JSX.ELement | - |
messageAlign | \u5185\u5BB9\u5BF9\u9F50\u65B9\u5F0F\uFF0C\u53EF\u9009\u503C\u4E3A left right | string | center |
theme | \u6837\u5F0F\u98CE\u683C\uFF0C\u53EF\u9009\u503C\u4E3A round-button | string | default |
className | \u81EA\u5B9A\u4E49\u7C7B\u540D | string | Array | object | - |
showConfirmButton | \u662F\u5426\u5C55\u793A\u786E\u8BA4\u6309\u94AE | boolean | true |
showCancelButton | \u662F\u5426\u5C55\u793A\u53D6\u6D88\u6309\u94AE | boolean | false |
confirmButtonText | \u786E\u8BA4\u6309\u94AE\u6587\u6848 | string | \u786E\u8BA4 |
confirmButtonColor | \u786E\u8BA4\u6309\u94AE\u989C\u8272 | string | #ee0a24 |
confirmButtonDisabled v3.5.0 | \u662F\u5426\u7981\u7528\u786E\u8BA4\u6309\u94AE | boolean | false |
cancelButtonText | \u53D6\u6D88\u6309\u94AE\u6587\u6848 | string | \u53D6\u6D88 |
cancelButtonColor | \u53D6\u6D88\u6309\u94AE\u989C\u8272 | string | black |
cancelButtonDisabled v3.5.0 | \u662F\u5426\u7981\u7528\u53D6\u6D88\u6309\u94AE | boolean | false |
overlay | \u662F\u5426\u5C55\u793A\u906E\u7F69\u5C42 | boolean | true |
overlayClass | \u81EA\u5B9A\u4E49\u906E\u7F69\u5C42\u7C7B\u540D | string | Array | object | - |
overlayStyle | \u81EA\u5B9A\u4E49\u906E\u7F69\u5C42\u6837\u5F0F | object | - |
closeOnPopstate | \u662F\u5426\u5728\u9875\u9762\u56DE\u9000\u65F6\u81EA\u52A8\u5173\u95ED | boolean | true |
closeOnClickOverlay | \u662F\u5426\u5728\u70B9\u51FB\u906E\u7F69\u5C42\u540E\u5173\u95ED\u5F39\u7A97 | boolean | false |
lockScroll | \u662F\u5426\u9501\u5B9A\u80CC\u666F\u6EDA\u52A8 | boolean | true |
allowHtml | \u662F\u5426\u5141\u8BB8 message \u5185\u5BB9\u4E2D\u6E32\u67D3 HTML | boolean | false |
beforeClose | \u5173\u95ED\u524D\u7684\u56DE\u8C03\u51FD\u6570\uFF0C\u8FD4\u56DE false \u53EF\u963B\u6B62\u5173\u95ED\uFF0C\u652F\u6301\u8FD4\u56DE Promise | (action: string) => boolean | Promise<boolean> | - |
transition | \u52A8\u753B\u7C7B\u540D\uFF0C\u7B49\u4EF7\u4E8E transition \u7684 name \u5C5E\u6027 | string | - |
teleport | \u6307\u5B9A\u6302\u8F7D\u7684\u8282\u70B9\uFF0C\u7B49\u540C\u4E8E Teleport \u7EC4\u4EF6\u7684 to \u5C5E\u6027 | string | Element | body |
\u901A\u8FC7\u7EC4\u4EF6\u8C03\u7528 Dialog
\u65F6\uFF0C\u652F\u6301\u4EE5\u4E0B Props\uFF1A
\u53C2\u6570 | \u8BF4\u660E | \u7C7B\u578B | \u9ED8\u8BA4\u503C |
---|---|---|---|
v-model:show | \u662F\u5426\u663E\u793A\u5F39\u7A97 | boolean | - |
title | \u6807\u9898 | string | - |
width | \u5F39\u7A97\u5BBD\u5EA6\uFF0C\u9ED8\u8BA4\u5355\u4F4D\u4E3A px | number | string | 320px |
message | \u6587\u672C\u5185\u5BB9\uFF0C\u652F\u6301\u901A\u8FC7 \\n \u6362\u884C | string | () => JSX.Element | - |
message-align | \u5185\u5BB9\u6C34\u5E73\u5BF9\u9F50\u65B9\u5F0F\uFF0C\u53EF\u9009\u503C\u4E3A left right justify | string | center |
theme | \u6837\u5F0F\u98CE\u683C\uFF0C\u53EF\u9009\u503C\u4E3A round-button | string | default |
show-confirm-button | \u662F\u5426\u5C55\u793A\u786E\u8BA4\u6309\u94AE | boolean | true |
show-cancel-button | \u662F\u5426\u5C55\u793A\u53D6\u6D88\u6309\u94AE | boolean | false |
confirm-button-text | \u786E\u8BA4\u6309\u94AE\u6587\u6848 | string | \u786E\u8BA4 |
confirm-button-color | \u786E\u8BA4\u6309\u94AE\u989C\u8272 | string | #ee0a24 |
confirm-button-disabled v3.5.0 | \u662F\u5426\u7981\u7528\u786E\u8BA4\u6309\u94AE | boolean | false |
cancel-button-text | \u53D6\u6D88\u6309\u94AE\u6587\u6848 | string | \u53D6\u6D88 |
cancel-button-color | \u53D6\u6D88\u6309\u94AE\u989C\u8272 | string | black |
cancel-button-disabled v3.5.0 | \u662F\u5426\u7981\u7528\u53D6\u6D88\u6309\u94AE | boolean | false |
overlay | \u662F\u5426\u5C55\u793A\u906E\u7F69\u5C42 | boolean | true |
overlay-class | \u81EA\u5B9A\u4E49\u906E\u7F69\u5C42\u7C7B\u540D | string | - |
overlay-style | \u81EA\u5B9A\u4E49\u906E\u7F69\u5C42\u6837\u5F0F | object | - |
close-on-popstate | \u662F\u5426\u5728\u9875\u9762\u56DE\u9000\u65F6\u81EA\u52A8\u5173\u95ED | boolean | true |
close-on-click-overlay | \u662F\u5426\u5728\u70B9\u51FB\u906E\u7F69\u5C42\u540E\u5173\u95ED\u5F39\u7A97 | boolean | false |
lazy-render | \u662F\u5426\u5728\u663E\u793A\u5F39\u5C42\u65F6\u624D\u6E32\u67D3\u8282\u70B9 | boolean | true |
lock-scroll | \u662F\u5426\u9501\u5B9A\u80CC\u666F\u6EDA\u52A8 | boolean | true |
allow-html | \u662F\u5426\u5141\u8BB8 message \u5185\u5BB9\u4E2D\u6E32\u67D3 HTML | boolean | false |
before-close | \u5173\u95ED\u524D\u7684\u56DE\u8C03\u51FD\u6570\uFF0C\u8FD4\u56DE false \u53EF\u963B\u6B62\u5173\u95ED\uFF0C\u652F\u6301\u8FD4\u56DE Promise | (action: string) => boolean | Promise<boolean> | - |
transition | \u52A8\u753B\u7C7B\u540D\uFF0C\u7B49\u4EF7\u4E8E transition \u7684 name \u5C5E\u6027 | string | - |
teleport | \u6307\u5B9A\u6302\u8F7D\u7684\u8282\u70B9\uFF0C\u7B49\u540C\u4E8E Teleport \u7EC4\u4EF6\u7684 to \u5C5E\u6027 | string | Element | - |
\u901A\u8FC7\u7EC4\u4EF6\u8C03\u7528 Dialog
\u65F6\uFF0C\u652F\u6301\u4EE5\u4E0B\u4E8B\u4EF6\uFF1A
\u4E8B\u4EF6 | \u8BF4\u660E | \u56DE\u8C03\u53C2\u6570 |
---|---|---|
confirm | \u70B9\u51FB\u786E\u8BA4\u6309\u94AE\u65F6\u89E6\u53D1 | - |
cancel | \u70B9\u51FB\u53D6\u6D88\u6309\u94AE\u65F6\u89E6\u53D1 | - |
open | \u6253\u5F00\u5F39\u7A97\u65F6\u89E6\u53D1 | - |
close | \u5173\u95ED\u5F39\u7A97\u65F6\u89E6\u53D1 | - |
opened | \u6253\u5F00\u5F39\u7A97\u4E14\u52A8\u753B\u7ED3\u675F\u540E\u89E6\u53D1 | - |
closed | \u5173\u95ED\u5F39\u7A97\u4E14\u52A8\u753B\u7ED3\u675F\u540E\u89E6\u53D1 | - |
\u901A\u8FC7\u7EC4\u4EF6\u8C03\u7528 Dialog
\u65F6\uFF0C\u652F\u6301\u4EE5\u4E0B\u63D2\u69FD\uFF1A
\u540D\u79F0 | \u8BF4\u660E |
---|---|
default | \u81EA\u5B9A\u4E49\u5185\u5BB9 |
title | \u81EA\u5B9A\u4E49\u6807\u9898 |
footer v3.0.11 | \u81EA\u5B9A\u4E49\u5E95\u90E8\u6309\u94AE\u533A\u57DF |
\u7EC4\u4EF6\u5BFC\u51FA\u4EE5\u4E0B\u7C7B\u578B\u5B9A\u4E49\uFF1A
import type {
DialogProps,
DialogTheme,
DialogMessage,
DialogOptions,
DialogMessageAlign,
} from 'vant';
\u7EC4\u4EF6\u63D0\u4F9B\u4E86\u4E0B\u5217 CSS \u53D8\u91CF\uFF0C\u53EF\u7528\u4E8E\u81EA\u5B9A\u4E49\u6837\u5F0F\uFF0C\u4F7F\u7528\u65B9\u6CD5\u8BF7\u53C2\u8003 ConfigProvider \u7EC4\u4EF6\u3002
\u540D\u79F0 | \u9ED8\u8BA4\u503C | \u63CF\u8FF0 |
---|---|---|
--van-dialog-width | 320px | - |
--van-dialog-small-screen-width | 90% | - |
--van-dialog-font-size | var(--van-font-size-lg) | - |
--van-dialog-transition | var(--van-animation-duration-base) | - |
--van-dialog-border-radius | 16px | - |
--van-dialog-background-color | var(--van-background-color-light) | - |
--van-dialog-header-font-weight | var(--van-font-weight-bold) | - |
--van-dialog-header-line-height | 24px | - |
--van-dialog-header-padding-top | 26px | - |
--van-dialog-header-isolated-padding | var(--van-padding-lg) 0 | - |
--van-dialog-message-padding | var(--van-padding-lg) | - |
--van-dialog-message-font-size | var(--van-font-size-md) | - |
--van-dialog-message-line-height | var(--van-line-height-md) | - |
--van-dialog-message-max-height | 60vh | - |
--van-dialog-has-title-message-text-color | var(--van-gray-7) | - |
--van-dialog-has-title-message-padding-top | var(--van-padding-xs) | - |
--van-dialog-button-height | 48px | - |
--van-dialog-round-button-height | 36px | - |
--van-dialog-confirm-button-text-color | var(--van-danger-color) | - |
\u5C06 closeOnPopstate
\u5C5E\u6027\u8BBE\u7F6E\u4E3A false \u5373\u53EF\u3002
Dialog.alert({
title: '\u6807\u9898',
message: '\u5F39\u7A97\u5185\u5BB9',
closeOnPopstate: false,
}).then(() => {
// on close
});
\u8BF7\u6CE8\u610F Dialog
\u662F\u4E00\u4E2A\u51FD\u6570\uFF0CDialog.Component
\u624D\u662F Dialog \u5BF9\u5E94\u7684\u7EC4\u4EF6\u3002JSX \u8C03\u7528\u5F39\u7A97\u7684\u6B63\u786E\u59FF\u52BF\u5982\u4E0B\uFF1A
export default {
setup() {
const show = ref(false);
return () => <Dialog.Component v-model={[show, 'show']} />;
},
};