更新记录
0.2.1(2025-07-18) 下载此版本
- fix: 修复因隐藏还存在页面导致无法点击问题
0.1.9(2025-05-30) 下载此版本
- fix: 修复演示demo问题
0.1.8(2025-05-14) 下载此版本
- feat: 关闭icon 单位由rpx改成px
平台兼容性
uni-app(4.62)
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | - | 5.1 | √ | √ |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | - | - | - | - | - | - | - | - | - | - |
uni-app x(4.75)
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
√ | √ | 5.1 | √ | √ | √ |
lime-popup 弹出层
弹出层容器,用于展示弹窗、信息提示等内容,支持多种弹出位置和动画效果,兼容uniapp/uniappx。
插件依赖:
lime-style
、lime-shared
、lime-overlay
、lime-transition
、lime-icon
。 注意:lime-svg
为收费插件,若不需要svg功能可删除依赖。
文档链接
📚 组件详细文档请访问以下站点:
安装方法
- 在uni-app插件市场中搜索并导入
lime-popup
- 导入后可能需要重新编译项目
- 在页面中使用
l-popup
组件(组件)或lime-popup
(演示) ::: tip 注意🔔 本插件依赖的【lime-svg】是原生插件,如果购买(收费为6元)则需要自定义基座,才能使用, 若不需要删除即可 :::
代码演示
基础用法
通过 v-model
控制弹出层是否展示。
<button @click="show = true">展示弹出层</button>
<l-popup v-model="show">
<view style="padding: 100px;"></view>
</l-popup>
const show = ref(false);
弹出位置
通过 position
属性设置弹窗的弹出位置,默认为居中弹出,可以设置为 top
、bottom
、left
、right
、center
。
- 当弹窗从顶部或底部弹出时,默认宽度与屏幕宽度保持一致,弹窗高度取决于内容的高度。
- 当弹窗从左侧或右侧弹出时,默认不设置宽度和高度,弹窗的宽高取决于内容的宽高。
<!-- 顶部弹出 -->
<l-popup v-model"showTop" position="top">
<view style="padding: 100px;"></view>
</l-popup>
<!-- 左边弹出 -->
<l-popup v-model"showTop" position="left">
<view style="padding: 100px;"></view>
</l-popup>
<!-- 底部弹出 -->
<l-popup v-model"showTop" position="bottom">
<view style="padding: 100px;"></view>
</l-popup>
<!-- 右边弹出 -->
<l-popup v-model"showTop" position="right">
<view style="padding: 100px;"></view>
</l-popup>
关闭图标
设置 closeable
属性后,会在弹出层的右上角显示关闭图标,并且可以通过 close-icon
属性自定义图标。
<l-popup v-model"showTop" :closeable="true">
<view style="padding: 100px;"></view>
</l-popup>
监听点击事件
Popup 支持以下点击事件:
click-overlay
: 点击遮罩层时触发。click-close
: 点击关闭图标时触发。
<button @click="show = true">展示弹出层</button>
<l-popup
v-model"show"
position="bottom"
:closeable="true"
@click-overlay="onClickOverlay"
@click-close="onClickClose"
/>
const onClickOverlay = () => {
console.log('click-overlay');
};
const onClickClose = () => {
console.log('click-close');
};
监听显示事件
当 Popup 被打开或关闭时,会触发以下事件:
open
: 打开弹出层时立即触发。opened
: 打开弹出层且动画结束后触发。close
: 关闭弹出层时立即触发。closed
: 关闭弹出层且动画结束后触发。
<button @click="show = true">展示弹出层</button>
<l-popup
v-model="show"
position="bottom"
@open="handlePopupOpen"
@opened="handlePopupOpened("
@close="handlePopupClose"
@closed="handlePopupClosed"
/>
const show = ref(false);
const handlePopupOpen = () => {
// 处理弹出框打开前的逻辑
}
const handlePopupOpened = () => {
// 处理弹出框打开后的逻辑
}
const handlePopupClose = () => {
// 处理弹出框关闭前的逻辑
}
const handlePopupClosed = () => {
// 处理弹出框关闭后的逻辑
}
快速预览
导入插件后,可以直接使用以下标签查看演示效果:
<!-- 代码位于 uni_modules/lime-popup/components/lime-popup -->
<lime-popup />
插件标签说明
l-popup
: 组件标签,用于实际开发中lime-popup
: 演示标签,用于查看示例效果
Vue2使用说明
本插件使用了composition-api
,如需在Vue2项目中使用,请按照官方教程配置。
关键配置代码(在main.js中添加):
// vue2
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
API文档
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 是否显示弹出层 | boolean | false |
overlay | 是否显示遮罩层 | boolean | true |
position | 弹出位置,可选值为 top bottom right left |
string | center |
duration | 动画时长,单位毫秒,设置为 0 可以禁用动画 | number | 300 |
z-index | 将弹窗的 z-index 层级设置为一个固定值 | number | 999 |
preventScrollThrough | 是否锁定背景滚动 | boolean | true |
closeOnClickOverlay | 是否在点击遮罩层后关闭 | boolean | true |
destroyOnClose | 关闭后是否销毁 | boolean | false |
closeable | 是否显示关闭图标 | boolean | false |
closeIcon | 关闭图标名称或图片链接,等同于 Icon 组件的 name 属性 | string | cross |
bgColor | 背景色 | string | - |
iconColor | 图标色 | string | - |
lStyle | 自定义样式 | string|object | - |
radius | 圆角,可以是字符,数值,数组 | string|number|Array\<string|number> | - |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
click-overlay | 点击遮罩层时触发 | - |
click-close | 点击关闭图标时触发 | - |
open | 打开弹出层时立即触发 | - |
close | 关闭弹出层时立即触发 | - |
opened | 打开弹出层且动画结束后触发 | - |
closed | 关闭弹出层且动画结束后触发 | - |
Slots
名称 | 说明 |
---|---|
default | 弹窗内容 |
close-btn | 关闭按钮 |
主题定制
组件提供了下列 CSS 变量,可用于自定义样式。
名称 | 默认值 | 描述 |
---|---|---|
--l-popup-bg-color | #fff | 弹出层背景颜色 |
--l-popup-close-icon-color | rgba(0,0,0,0.6) | 关闭图标颜色 |
--l-popup-border-radius | $border-radius | 弹出层边框圆角 |
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者: | 支付宝赞助 | 微信赞助 |
---|---|---|
![]() |
![]() |