ViewPager
适用于 ReactLynx 的分页横向内容导航组件,支持屏外页面懒加载。Info
你可以查看源码来了解它的运行原理,也欢迎大家提 PR 来丰富其能力。
基础用法
基于数据渲染页面,并通过切换事件跟踪当前页。
示例
自动高度
不显式设置高度,让页面内容决定分页器的自然高度。
动态高度
在不同高度的页面切换时,通过主线程连续插值分页器高度。
懒渲染
按曝光范围懒渲染页面,并通过命令式控件切换页面。
嵌套列表
组合横向分页与各自独立滚动的垂直列表。
结构
组件 API
ViewPager
bouncesiOSAndroid
在支持的平台启用原生回弹效果。
childreniOSAndroid
渲染页面内容。此函数有意不传入选中状态,因此原生滑动无需让 React 重新渲染页面内容。
classNameiOSAndroidHarmony
类名
dataiOSAndroid
页面数据。ViewPager 为每条数据创建一个直接的原生 viewpager-item 子节点。
enableScrolliOSAndroid
启用水平滑动手势。
getItemKeyiOSAndroid
返回条目的稳定唯一键。不传时使用条目索引;当条目可能插入、删除或重排时请提供此函数。
getItemPropsiOSAndroid
单个自动生成条目的原生属性。类名与 itemClassName 合并;样式覆盖 itemStyle 的同名属性。条目的 key、ref 和 children 由 ViewPager 管理。
idiOSAndroid
应用于原生 ViewPager 根节点的标识符。
initialSelectIndexiOSAndroid
初始页面索引,后续修改不生效。使用 ref.scrollToPage 切换页面。
itemClassNameiOSAndroid
应用于每个自动生成的 viewpager-item 的类名。
itemStyleiOSAndroid
应用于每个自动生成的 viewpager-item 的样式。
lazyOptionsiOSAndroid
基于曝光的懒渲染。初始页面立即渲染,其他页面在占位节点进入配置的曝光区域时渲染;已渲染页面保持挂载。不传时渲染全部页面。
main-thread:onOffsetChangeiOSAndroid
主线程滚动进度回调,需使用主线程函数。
main-thread:onPageChangeiOSAndroid
主线程页面切换完成回调,需使用主线程函数。
main-thread:onPageWillChangeiOSAndroid
主线程页面即将切换回调,需使用主线程函数。
onOffsetChangeiOSAndroid
原生滚动进度事件,从 event.detail 读取数据。
onPageChangeiOSAndroid
原生页面切换完成事件,从 event.detail.index 读取选中索引。
onPageWillChangeiOSAndroid
原生页面切换完成前事件,从 event.detail 读取数据。
styleiOSAndroidHarmony
样式
viewpagerPropsiOSAndroid
组件未管理的原生分页器属性。
ViewPagerRef
scrollToPageiOSAndroid
通过原生节点引用切换页面,默认使用动画。索引限制在有效范围内,空列表忽略请求。onPageChange 表示切换完成,success 表示调用成功。
辅助类型
ViewPagerItemProps
ViewPagerItemProps
ViewPagerExposureMargin
ViewPagerExposureMargin
ViewPagerLazyOptions
ViewPagerLazyOptions
禁用懒渲染。
ViewPagerChangeEvent
ViewPagerChangeEvent
ViewPagerWillChangeEvent
ViewPagerWillChangeEvent
ViewPagerOffsetChangeEvent
ViewPagerOffsetChangeEvent