更新记录
1.0.0(2026-11-19) 下载此版本
1.0.0:初始版本。基于 uni-popup 1.9.10 示例整理,页面按插件 ID 重建为 pages/lhy2024-popup/lhy2024-popup.vue;新增 lhy2024 自定义居中弹窗;补充 Vue3 编译配置与 README 使用说明。
平台兼容性
uni-app(4.66)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | - | - | - | - | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - | - | - | - |
lhy2024-popup 弹出层页面模板 · 使用说明
一、插件简介
本模板基于 uni-popup 1.9.10 的官方示例整理,在一个页面里演示 uni-popup 的全部常用形态:五个方向的普通弹窗、四种状态的消息提示、确认对话框、输入对话框、底部分享面板,以及一个可直接改文案复用的自定义居中弹窗。
适合作为弹出层功能的快速参考页,也可把整页复制到已有项目中按需删减。
二、支持平台与环境
- 建议 HBuilderX 4.x(Vue3 编译),工程已声明
"vueVersion": "3"。 - 支持 H5、App(vue 页面)、微信小程序等 uni-popup 支持的多端平台。
- 依赖组件的引擎要求为 uni-app 4.05 至 4.12,HBuilderX 版本过低可能出现组件不兼容。
- 工程根目录的
index.html是 Vue3 编译必需文件,请勿删除,删除后会报「根目录缺少 index.html」并停止运行。 - 页面样式使用 scss;首次运行若提示「插件 scss/sass 编译 未安装」,按提示安装后重新运行。
三、目录结构
├── pages/lhy2024-popup/lhy2024-popup.vue 页面模板,全部示例都在这里
├── pages.json 已注册页面路由
├── manifest.json 应用配置,未包含 appid
├── App.vue 全局样式入口,引入 uni-scss 与自定义图标
├── main.js Vue2 / Vue3 双入口
├── uni.scss 全局 scss 变量
├── index.html Vue3 H5 编译模板,必需
├── static/customicons.css 自定义图标字体样式
├── uni_modules/uni-popup 弹窗核心组件
├── uni_modules/uni-popup-dialog 对话框、输入框
├── uni_modules/uni-popup-message 消息提示
├── uni_modules/uni-popup-share 底部分享面板
├── uni_modules/uni-transition 弹窗动画依赖
├── uni_modules/uni-card、uni-section、uni-icons、uni-scss 示例页面的 UI 组件
四、快速开始
方式一:整包导入
- HBuilderX 菜单「文件 → 导入 → 从本地目录导入」,选择本模板解压后的根目录(能直接看到
manifest.json、pages.json的那一层)。 - 运行到浏览器 Chrome 或运行到手机基座即可查看效果。
manifest.json中未设置 appid,H5 预览可忽略;真机运行或云打包时按提示在 HBuilderX 中重新获取。
方式二:复制到已有项目
- 复制
pages/lhy2024-popup目录到你的项目pages下。 - 复制
uni_modules下的uni-popup、uni-popup-dialog、uni-popup-message、uni-popup-share、uni-transition到你的项目,组件已按 easycom 自动注册,无需手动 import。 - 若使用示例页面的卡片、标题栏,则同时复制
uni-card、uni-section、uni-icons、uni-scss,并把App.vue中的@import '@/uni_modules/uni-scss/index.scss';合并到你的全局样式。 - 在
pages.json注册页面。
五、页面路由
{
"path": "pages/lhy2024-popup/lhy2024-popup",
"style": {
"navigationBarTitleText": "lhy2024",
"app-plus": {
"softinputMode": "adjustResize"
}
}
}
app-plus.softinputMode 建议保留为 adjustResize,否则输入对话框弹出键盘时页面可能被整体顶起。
六、常用用法示例
1. 打开与关闭弹窗
<uni-popup ref="popup" type="center" background-color="#fff" border-radius="10px">
<view class="popup-content">
<text>弹窗内容</text>
</view>
</uni-popup>
export default {
methods: {
openPopup() {
this.$refs.popup.open('bottom')
},
closePopup() {
this.$refs.popup.close()
}
}
}
open(type) 传入的方向会覆盖组件上 type 属性,示例中的五个方向按钮就是这么实现的。
2. 消息提示
<uni-popup ref="message" type="message">
<uni-popup-message type="success" message="这是一条成功提示" :duration="2000" />
</uni-popup>
this.$refs.message.open()
type 可取 success、warn、error、info,颜色与文字样式已内置。duration 为显示毫秒数,设为 0 表示不自动关闭。
3. 确认对话框
<uni-popup ref="alertDialog" type="dialog">
<uni-popup-dialog
type="warn"
title="通知"
content="欢迎使用 lhy2024 弹出层组件!"
cancelText="关闭"
confirmText="同意"
:showClose="true"
@confirm="onConfirm"
@close="onClose" />
</uni-popup>
this.$refs.alertDialog.open()
4. 输入对话框
<uni-popup ref="inputDialog" type="dialog">
<uni-popup-dialog
mode="input"
title="输入内容"
:maxlength="10"
placeholder="请输入内容,限制10个字"
v-model="value"
@confirm="onInputConfirm" />
</uni-popup>
onInputConfirm(val) {
this.value = val
this.$refs.inputDialog.close()
}
Vue3 用 v-model,Vue2 用 :value;输入内容会通过 confirm 事件回传。
5. 底部分享面板
<uni-popup ref="share" type="share" safeArea background-color="#fff">
<uni-popup-share />
</uni-popup>
this.$refs.share.open()
分享面板默认的四个图标是 DCloud 官方的示例 CDN 图,正式使用请修改 uni-popup-share 组件内的 bottomData,换成自己的图标地址;点击某一项会抛出 select 事件。
6. 自定义居中弹窗
<uni-popup ref="customPopup" type="center" background-color="#fff" border-radius="10px">
<view class="custom-popup">
<text class="custom-title">lhy2024</text>
<text class="custom-desc">基于 uni-popup 定制的居中弹窗</text>
<button class="custom-btn" type="primary" @click="customClose">我知道了</button>
</view>
</uni-popup>
customToggle() { this.$refs.customPopup.open() },
customClose() { this.$refs.customPopup.close() }
custom-popup 使用纵向 flex、宽 280px、内边距 20px 15px,可按需要改宽度与配色。
七、组件参数速查
uni-popup
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type | String | center | top、bottom、center、left、right、message、dialog、share |
| animation | Boolean | true | 是否使用动画 |
| isMaskClick | Boolean | null | 点击遮罩是否关闭弹窗 |
| backgroundColor | String | none | 弹窗主体背景色 |
| maskBackgroundColor | String | rgba(0,0,0,0.4) | 遮罩颜色 |
| borderRadius | String | 无 | 弹窗圆角,如 10px |
| safeArea | Boolean | true | 是否适配底部安全区 |
方法:open(type)、close()
事件:change(参数含 type、show)、maskClick
uni-popup-dialog
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| mode | String | base | base 确认框,input 输入框 |
| type | String | error | success、warn、error、info |
| title | String | 无 | 标题 |
| content | String | 无 | 内容文案 |
| showClose | Boolean | true | 是否显示右上角关闭图标 |
| cancelText | String | 取消 | 取消按钮文字 |
| confirmText | String | 确定 | 确认按钮文字 |
| maxlength | Number | -1 | 输入最大长度 |
| placeholder | String | 无 | 输入框占位文字 |
| focus | Boolean | true | 输入框是否自动聚焦 |
| beforeClose | Boolean | false | 是否拦截关闭动作 |
事件:confirm(返回输入值)、close
uni-popup-message
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type | String | success | success、warn、error、info |
| message | String | 无 | 提示文字 |
| duration | Number | 3000 | 显示时长(毫秒),0 为不自动关闭 |
| maskShow | Boolean | false | 是否显示遮罩 |
uni-popup-share
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| title | String | 分享到 | 面板标题 |
| beforeClose | Boolean | false | 是否拦截关闭动作 |
事件:select(返回当前项与索引)
八、常见问题
点击按钮弹窗不出来
- 检查
ref名称与 JS 中是否完全一致。 - 弹窗组件要放在页面根层级的
view下,不要放进scroll-view或swiper-item内部,否则定位会异常。 - 若页面上有其他
position: fixed且 z-index 更高的元素,会被盖住;uni-popup 默认 z-index 为 99。
消息提示一闪而过
duration 太短或为 0 时会立即关闭,确认传入了期望的毫秒数。
弹窗关闭后页面还能滚动
在 @change 事件里根据 e.show 关闭或恢复页面滚动,或在弹窗打开时给页面加 overflow: hidden 的类名。
真机运行提示 appid 为空
打开 manifest.json,在基础配置里点击「重新获取」,登录 DCloud 账号后生成;仅 H5 预览可以不处理。
运行报「根目录缺少 index.html」
Vue3 工程根目录必须有 index.html,本模板已包含,不要删除或移动到子目录。
九、版本更新
- 1.0.0:初始版本。基于 uni-popup 1.9.10 示例整理,页面按插件 ID 重建为
pages/lhy2024-popup/lhy2024-popup.vue;新增 lhy2024 自定义居中弹窗;补充 Vue3 编译配置与本文档。

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
下载 0
赞赏 0
下载 12775795
赞赏 1960
赞赏
京公网安备:11010802035340号