UniApp的 uni-popup-dialog 是一个弹窗对话框组件,用于显示提示、确认或输入内容。以下是基本使用方法:
1. 引入组件
在页面或组件中引入:
<template>
<view>
<button @click="showDialog">打开弹窗</button>
<uni-popup-dialog
ref="dialogRef"
type="confirm"
title="提示"
content="确定执行此操作吗?"
@confirm="handleConfirm"
@close="handleClose"
></uni-popup-dialog>
</view>
</template>
2. 注册组件
若使用 uni_modules 方式安装,自动注册;否则需手动注册:
import uniPopupDialog from '@/components/uni-popup-dialog/uni-popup-dialog.vue'
export default {
components: { uniPopupDialog }
}
3. 控制显示/隐藏
通过 ref 调用方法:
export default {
methods: {
showDialog() {
this.$refs.dialogRef.open()
},
handleConfirm() {
console.log('用户点击确认')
this.$refs.dialogRef.close()
},
handleClose() {
console.log('弹窗关闭')
}
}
}
4. 常用属性
type: 类型(confirm/input)
title: 标题
content: 内容(type=confirm时)
value: 输入值(type=input时)
placeholder: 输入框提示文本
5. 输入框模式示例
<uni-popup-dialog
ref="inputDialog"
type="input"
title="输入内容"
placeholder="请输入"
@confirm="handleInputConfirm"
></uni-popup-dialog>
handleInputConfirm(value) {
console.log('输入内容:', value)
}
注意事项
- 确保已安装
uni-popup 插件(HBuilderX中直接导入)
- 可通过样式自定义外观
- 支持异步关闭(在确认事件中执行操作后手动调用
close())
这样即可快速实现交互弹窗功能。