更新记录

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 组件

四、快速开始

方式一:整包导入

  1. HBuilderX 菜单「文件 → 导入 → 从本地目录导入」,选择本模板解压后的根目录(能直接看到 manifest.json、pages.json 的那一层)。
  2. 运行到浏览器 Chrome 或运行到手机基座即可查看效果。
  3. manifest.json 中未设置 appid,H5 预览可忽略;真机运行或云打包时按提示在 HBuilderX 中重新获取。

方式二:复制到已有项目

  1. 复制 pages/lhy2024-popup 目录到你的项目 pages 下。
  2. 复制 uni_modules 下的 uni-popup、uni-popup-dialog、uni-popup-message、uni-popup-share、uni-transition 到你的项目,组件已按 easycom 自动注册,无需手动 import。
  3. 若使用示例页面的卡片、标题栏,则同时复制 uni-card、uni-section、uni-icons、uni-scss,并把 App.vue 中的 @import '@/uni_modules/uni-scss/index.scss'; 合并到你的全局样式。
  4. 在 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 编译配置与本文档。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。