更新记录

0.1.2(2025-08-13) 下载此版本

  • fix: 修复uniappx type 类型问题

0.1.1(2025-08-13) 下载此版本

  • fix: 修复uniapp type 类型问题

0.1.0(2025-04-22) 下载此版本

  • feat: 兼容uniappx 鸿蒙next
查看更多

平台兼容性

uni-app(4.52)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- 5.0
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - -

uni-app x(4.75)

Chrome Safari Android iOS 鸿蒙 微信小程序
5.0

lime-overlay 遮罩层

一个遮罩层组件,通过遮罩层可以强调部分内容,支持自定义内容和样式。

插件依赖:lime-stylelime-sharedlime-transition

文档链接

📚 组件详细文档请访问以下站点:

安装方法

  1. 在uni-app插件市场中搜索并导入lime-overlay
  2. 首次导入可能需要重新编译
  3. 在页面使用l-overlay(组件)

代码演示

基础用法

<button @click="onClick">显示</button>
<l-overlay :visible="show" @click="onClick"></l-overlay>
const show =    refl(lflalse);
const onClick = () => {
    show.value = !show.value
}

嵌入内容

通过默认插槽可以在遮罩层上嵌入任意内容。

<button @click="onClick">显示</button>
<l-overlay :visible="show" @click="onClick">
    <view class="wrapper">
        <view class="block" />
    </view>
</l-overlay>
const show = ref(false);
const onClick = () => {
    show.value = !show.value
}

Vue2使用说明

在main.js中添加:

// main.js
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

详细配置请参考官方文档:Vue Composition API

快速预览

导入插件后,可以直接使用以下标签查看演示效果:

<!-- 代码位于 uni_modules/lime-overlay/components/lime-overlay -->
<lime-overlay />

插件标签说明

  • l-overlay:遮罩层组件
  • lime-overlay:演示标签

API文档

Props

参数 说明 类型 默认值
visible 是否展示遮罩层 boolean false
z-index z-index 层级 number 1000
duration 动画时长,单位ms,设置为 0 可以禁用动画 number 300
lStyle 自定义样式 string -
destoryOnClose 隐藏时是否销毁 boolean false

Events

事件名 说明 回调参数
click 点击遮罩层时触发 -

Slots

名称 说明
default 默认插槽,用于在遮罩层上方嵌入内容

主题定制

组件提供了下列CSS变量,可用于自定义样式。

名称 默认值 描述
--l-overlay-z-index 998 遮罩层的层级,控制显示在页面中的层级高度
--l-overlay-bg-color rgba(0, 0, 0, 0.6) 遮罩层的背景颜色和透明度
--l-overlay-blur 4px 遮罩层的模糊效果程度

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者: 支付宝赞助 微信赞助

隐私、权限声明

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

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

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

许可协议

MIT协议

暂无用户评论。