kuikly-visibility-exposure
Installation
SKILL.md
Kuikly 曝光与可见性事件
核心概念
Kuikly 提供了一套完整的组件可见性事件系统,用于监听组件在滚动容器或页面中的可见状态变化。四大要素:
- 可见窗口:最近的滚动容器(Scroller/List/WaterfallList)、ModalView 或 Pager
- 可见性状态:四种状态 + 百分比(WILL_APPEAR → DID_APPEAR → WILL_DISAPPEAR → DID_DISAPPEAR)
- 触发时机:滚动偏移变化、子视图布局完成、可见区域 margin 变化、组件被移除
- 应用场景:曝光上报、懒加载、播放控制、可见百分比监听
可见窗口查找规则
系统从组件的 parent 开始向上遍历,找到第一个匹配的祖先作为可见窗口: