uni.createIntersectionObserver(component, options)

创建并返回一个 IntersectionObserver 对象实例

createIntersectionObserver 兼容性

Web	微信小程序	Android	iOS
4.0	4.41	x	x

参数

名称	类型	必填	默认值	兼容性	描述
component	any	是	-	-	-
options	CreateIntersectionObserverOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 thresholds Array<any> 否 - Web 微信小程序 Android iOS - 4.41 - - 所有阈值 initialRatio number 否 - Web 微信小程序 Android iOS - 4.41 - - 初始的相交比例 observeAll boolean 否 - Web 微信小程序 Android iOS - 4.41 - - 是否同时观测多个参照节点（而非一个） nativeMode boolean 否 - Web 微信小程序 Android iOS - 4.41 - - 需要基础库： 3.5.7 是否使用原生观察器模式。

返回值

类型
IntersectionObserver

IntersectionObserver 的方法

relativeTo(selector: string, margins?: any): IntersectionObserver;

使用选择器指定一个节点，作为参照区域之一

relativeTo 兼容性

Web	微信小程序	Android	iOS
-	4.41	-	-

参数

名称	类型	必填	默认值	兼容性	描述
selector	string	是	-	-	-
margins	any	否	-	-	-

返回值

类型
IntersectionObserver

relativeToViewport(margins?: any): IntersectionObserver;

指定页面显示区域作为参照区域之一

relativeToViewport 兼容性

Web	微信小程序	Android	iOS
-	4.41	-	-

参数

名称	类型	必填	默认值	兼容性	描述
margins	any	否	-	-	-

返回值

类型
IntersectionObserver

observe(targetSelector: string, callback: ObserveCallback): void;

指定目标节点并开始监听相交状态变化情况

observe 兼容性

Web	微信小程序	Android	iOS
-	4.41	-	-

参数

名称	类型	必填	默认值	兼容性	描述
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 兼容性

Web	微信小程序	Android	iOS
-	4.41	-	-

参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

通用类型

GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	Web 微信小程序 Android iOS - 4.41 - -	错误信息