#long-image
长图加载与展示组件,支持分段懒加载,适用于超长图片的高性能渲染。
#扫码预览
#Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| className | string | - | 否 | 组件类名。 |
| decodeOverscanScreens | number | 1 | 否 | 解码窗口的预加载屏数,基于当前可视区域高度计算。 |
| id | string | - | 否 | 元素唯一标识。未传时内部自动生成。 |
| maxActiveSegments | number | 8 | 否 | 解码窗口允许同时激活的最大分段数。 用于控制单次内存峰值。 |
| onMetricsChange | (metrics: LongImageMetrics) => void | - | 否 | 指标回调,输出尺寸和当前激活窗口信息。 |
| onStateChange | (state: LongImageState) => void | - | 否 | 状态回调,输出阶段与错误信息。 |
| placeholderColor | string | 'transparent' | 否 | 非激活分段或分段图片加载失败时的占位背景色。 |
| reloadToken | number | 0 | 否 | 手动重建分段与解码窗口的触发令牌。值变化时会重新初始化。 |
| scrollEventThrottle | number | 60 | 否 | 滚动事件回调节流时间(ms)。 |
| segmentDisplayHeight | number | 600 | 否 | 单段在展示坐标系下的目标高度(px)。 值越大,单次解码像素越大;值越小,分段数量越多。 |
| src | string | - | 是 | 图片资源地址。 |
| style | CSSProperties | - | 否 | 组件样式。 - style.height:建议显式指定;未指定时默认使用 100vh。- style.width:未指定时默认使用 100%。 |