uni.createIntersectionObserver(component, options)
创建并返回一个 IntersectionObserver 对象实例
createIntersectionObserver 兼容性
参数
| 名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
|---|
| component | any | 是 | - | - | - |
| options | CreateIntersectionObserverOptions | 是 | - | - | - |
| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
|---|
| thresholds | Array<any> | 否 | - | - | 所有阈值 | | initialRatio | number | 否 | - | - | 初始的相交比例 | | observeAll | boolean | 否 | - | - | 是否同时观测多个参照节点（而非一个） |
|
返回值
IntersectionObserver 的方法
relativeTo(selector: string, margins?: any): IntersectionObserver;
使用选择器指定一个节点，作为参照区域之一
relativeTo 兼容性
参数
| 名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
|---|
| selector | string | 是 | - | - | - |
| margins | any | 否 | - | - | - |
返回值
relativeToViewport(margins?: any): IntersectionObserver;
指定页面显示区域作为参照区域之一
relativeToViewport 兼容性
参数
| 名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
|---|
| margins | any | 否 | - | - | - |
返回值
observe(targetSelector: string, callback: ObserveCallback): void;
指定目标节点并开始监听相交状态变化情况
observe 兼容性
参数
| 名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
|---|
| targetSelector | string | 是 | - | - | - |
| callback | (result: ObserveResult) => void | 是 | - | - | - |
ObserveResult 的属性值
| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
|---|
| intersectionRatio | number | 是 | - | - | 相交比例 |
| intersectionRect | any | 是 | - | - | 相交区域的边界 |
| boundingClientRect | ObserveNodeRect | 是 | - | - | 目标节点布局区域的边界 |
| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
|---|
| left | number | 是 | - | - | left | | right | number | 是 | - | - | right | | top | number | 是 | - | - | top | | bottom | number | 是 | - | - | bottom |
|
| relativeRect | ObserveNodeRect | 是 | - | - | 参照区域的边界 |
| time | number | 是 | - | - | 相交检测时的时间戳 |
disconnect(): void;
停止监听
disconnect 兼容性
参见
通用类型
GeneralCallbackResult
| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
|---|
| errMsg | string | 是 | - | - | 错误信息 |
