Sticky 粘性布局
介绍
Sticky 组件与 CSS 中position: sticky
属性实现的效果一致,当组件在屏幕范围内时,会按照正常的布局排列,当组件滚出屏幕范围时,始终会固定在屏幕顶部。
引入
在app.json
或index.json
中引入组件,详细介绍见快速上手
"usingComponents": {
"van-sticky": "path/to/@vant/weapp/dist/sticky/index"
}
Vant Weapp 1.0 版本开始支持此组件,升级方式参见快速上手
代码演示
基础用法
将内容包裹在Sticky
组件内即可
<van-sticky>
<van-button type="primary">基础用法</van-button>
</van-sticky>
吸顶距离
通过offset-top
属性可以设置组件在吸顶时与顶部的距离
<van-sticky offset-top="{{ 50 }}">
<van-button type="info">吸顶距离</van-button>
</van-sticky>
指定容器
通过container
属性可以指定组件的容器,页面滚动时,组件会始终保持在容器范围内,当组件即将超出容器底部时,会返回原位置
<view id="container" style="height: 150px;">
<van-sticky container="{{ container }}">
<van-button type="warning">
指定容器
</van-button>
</van-sticky>
</view>
Page({
data: {
container: null
},
onReady() {
this.setData({
container: () => wx.createSelectorQuery().select('#container')
});
}
});
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
offset-top | 吸顶时与顶部的距离,单位px | number | 0 |
z-index | 吸顶时的 z-index | number | 99 |
container | 一个函数,返回容器对应的 NodesRef 节点 | function | - |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
scroll | 滚动时触发 | { scrollTop: 距离顶部位置, isFixed: 是否吸顶 } |