主题
Sticky 吸顶容器
滚动页面时将指定内容固定在顶部,也可限制在指定内容范围内。
支持平台
以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。
| App-vue | App-nvue | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 | H5 | PC | 快手小程序 | 钉钉小程序 |
|---|---|---|---|---|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
基础用法
vue
<!-- 滚动时保持在顶部的内容 -->
<fui-sticky :top="0">
<view>吸顶内容</view>
</fui-sticky>属性
| 属性 | 类型 | 说明 | 官网默认值 |
|---|---|---|---|
| top | Number / String | 吸顶后距顶部距离,单位 px | 0 |
| range | Boolean | 是否仅在 content 插槽的内容范围内吸顶 | false |
| scrollTop | Number | 页面垂直滚动距离,单位 px,由页面滚动事件提供 | 0 |
| zIndex | Number / String | 吸顶元素层级,nvue 不支持 | 999 |
| width | Number / String | 宽度,单位 rpx,仅 nvue 支持 | 750 |
| param | Number / String | 事件携带的自定义参数 | 0 |
事件
| 事件 | 说明 | 回调参数 |
|---|---|---|
| sticky | 传入 scrollTop 时,吸顶状态变化触发 | { isFixed, param } |
插槽
| 插槽 | 说明 |
|---|---|
| default | 需要吸顶的内容 |
| content | range 为 true 时限制吸顶范围的内容 |
平台说明
百度、QQ、字节小程序在 range 为 false 时需要传入 scrollTop;nvue 页面可使用原生 list 等组件处理滚动,元素顺序影响层级。