更新记录

0.0.1(2025-08-23)

  • init

平台兼容性

云端兼容性

阿里云 腾讯云 支付宝云

uni-app(4.65)

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

uni-app x(4.76)

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

lime-sticky 粘性布局组件

粘性布局组件,实现元素在页面滚动过程中的吸顶或吸底效果。当组件在屏幕范围内时,会按照正常的布局排列,当组件滚出屏幕范围时,始终会固定在屏幕顶部或底部。

插件依赖:lime-sharedlime-style

文档链接

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

安装方法

  1. 在uni-app插件市场中搜索并导入lime-sticky
  2. 导入后可能需要重新编译项目
  3. 在页面中使用l-sticky组件

代码演示

基础用法

将内容包裹在 l-sticky 组件内即可实现吸顶效果。

<l-sticky>
  <button>基础吸顶</button>
</l-sticky>

吸顶距离

通过 offset-top 属性可以设置组件在吸顶时与顶部的距离。

<l-sticky :offset-top="40">
  <button>吸顶距离</button>
</l-sticky>

容器中吸顶

l-sticky 组件放在 l-sticky-box 容器内,可以实现在容器内的吸顶效果。

<l-sticky-box style="height: 300px; background-color: #f5f5f5;">
  <l-sticky>
    <button>容器中吸顶</button>
  </l-sticky>
</l-sticky-box>

吸底距离

通过设置 offset-bottom 属性可以设置组件在吸底时与底部的距离。

<l-sticky :offset-bottom="44">
  <button>吸底距离</button>
</l-sticky>

容器中吸底

l-sticky 组件放在 l-sticky-box 容器内,并设置 offset-bottom 属性,可以实现在容器内的吸底效果。

<l-sticky-box style="height: 200px; background-color: #f5f5f5; justify-content: flex-end;">
  <l-sticky :offset-bottom="44">
    <button>容器中吸底</button>
  </l-sticky>
</l-sticky-box>

快速预览

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

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

插件标签说明

标签名 说明
l-sticky 粘性布局组件标签
l-sticky-box 粘性布局容器标签
lime-sticky 演示标签

Vue2使用说明

main.js中添加以下代码:

// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

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

API文档

l-sticky Props 属性说明

属性名 说明 类型 默认值
offset-top 吸顶时与顶部的距离,支持 px rpx 单位,默认 px number | string 0
offset-bottom 吸底时与底部的距离,支持 px rpx 单位,默认 px number | string 0
z-index 吸顶时的 z-index number 99
l-class 自定义类名 string -
l-style 自定义样式 string | object -

l-sticky-box Props 属性说明

属性名 说明 类型 默认值
l-class 自定义类名 string -
l-style 自定义样式 string | object -

Events 事件

事件名 说明 回调参数
change 当吸顶状态改变时触发 isFixed: boolean

Slots 插槽

名称 说明
default 默认插槽,用于放置需要吸顶/吸底的内容

主题定制

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

变量名称 默认值 描述
--l-sticky-z-index 99 粘性布局的层级

支持与赞赏

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

支付宝赞助 微信赞助

隐私、权限声明

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

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

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

暂无用户评论。