Sticky 粘性布局
Sticky 组件与 CSS 中 position: sticky
属性实现的效果一致,当组件在屏幕范围内时,会按照正常的布局排列,当组件滚出屏幕范围时,始终会固定在屏幕顶部。
基础用法
吸顶距离
指定容器
吸底距离
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
position | 吸附位置,可选值为 bottom | string | top |
offset-top | 吸顶时与顶部的距离,支持 px vw vh rem 单位,默认 px | number | string | 0 |
offset-bottom | 吸底时与底部的距离,支持 px vw vh rem 单位,默认 px | number | string | 0 |
z-index | 吸顶时的 z-index | number | string | 99 |
container | 容器对应的 HTML 节点 | Element | - |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 当吸顶状态改变时触发 | isFixed: boolean |
scroll | 滚动时触发 | { scrollTop: number, isFixed: boolean } |
类型定义
组件导出以下类型定义:
ts
import type { StickyProps, StickyPosition } from 'ryxon'
主题定制
样式变量
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
名称 | 默认值 | 描述 |
---|---|---|
--r-sticky-z-index | 99 | - |