用途:该技能面向 Kuikly DSL 开发,帮助实现组件曝光上报、可见百分比监听、懒加载、播放控制与列表项曝光统计。
主要能力:提供 willAppear、didAppear、willDisappear、didDisappear、appearPercentage 五种可见性事件。可见窗口为最近的滚动容器(Scroller/List/WaterfallList)、ModalView 或 Pager;可见性相对于该容器可见区域计算,而非屏幕位置。appearPercentage 的 percentage01 取值 [0,1],仅变化时回调,纵向列表按可见高度/组件高度,横向列表按可见宽度/组件宽度。状态按 WILL_APPEAR→DID_APPEAR→WILL_DISAPPEAR→DID_DISAPPEAR 迁移,组件被移除时自动触发消失且 percentage 置 0,状态变更默认异步(页面销毁除外)。
使用方式:在 event {} 中调用事件扩展函数;这些函数需显式 import,如 com.tencent.kuikly.core.base.event.didAppear、appearPercentage 等。Scroller/List/WaterfallList 支持 visibleAreaIgnoreTopMargin(margin) 与 visibleAreaIgnoreBottomMargin(margin) 缩小判定窗口,排除顶部/底部遮挡区域。
限制与注意:根节点不要用 didAppear 监听页面曝光,应使用 pageDidAppear();appearPercentage 触发频繁,曝光上报宜用 didAppear 或加阈值与去重。资料未提供收费、版本与完整示例细节。