Affix 固钉
WebH5
固钉。内容滚动到距离视口顶部指定位置时固定(position: fixed),滚回后还原。
何时使用
页面滚动时需要常驻的操作按钮、导航条、筛选栏。
何时不使用
需要底部吸附或复杂吸顶分组(如通讯录字母索引)的场景。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
offsetTop | number | 0 | 内容顶部距视口顶部多少像素时吸顶 |
Slots
| 名称 | 说明 |
|---|---|
default | 需要吸顶的内容 |
Methods
| 名称 | 签名 | 说明 |
|---|---|---|
update | update(): void | 强制重新计算吸顶状态(内容尺寸变化或 jsdom 复原后调用) |
fixed | Ref<boolean> | 当前是否处于吸顶状态的响应式引用(配合 template ref 读取) |
示例
吸顶筛选栏
示例加载中…
不同吸附偏移
示例加载中…
吸附时保留占位,内容不跳动
示例加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Affix 文档(含手机预览)。