Skip to content

简介 ​

介绍:qt-waterfall是由tv-list 而实现的瀑布流内容组件,常用于应用详情页、播放页等。支持横向纵向排列,支持数据分页。

注意,最低支持SDK版本2.1

注意,qt-waterfall组件中默认item样式使用qt-poster, 在构建数据中可查看其使用方式。也可自定义item。

效果预览 ​

Waterfall

属性 ​

参数说明类型可选值说明
:initPositionMap无否focusPosition:请求焦点的位置,可以不传,不传不会请求焦点;scrollToPosition:首次滚动的位置,可以不传;scrollOffset:首次滚动的偏移量,可以不传。示例如下。
:listenBoundEventBooleanfalse否是否开启view绑定监听回调,开启分页时必须设置该参数为true
:disableScrollOnFirstScreenBooleanfalse否是否开启列表在展示第一屏数据时切换焦点不滑动
:checkScrollOffsetOnStateChangedBooleanfalse否是否开启grid-view滑动事件onScrollStateChanged监听回调
:scrollEventThrottleInt400否grid-view滑动事件onScrolled监听回调间隔时间,配合onScrollEnable属性使用,单位:毫秒
:onScrollEnableBooleanfalse否是否开启grid-view滑动事件onScrolled监听回调
:scrollYLesserReferenceValueInt-1否grid-view向上滑动偏移量,配合onScrollEnable属性使用
:scrollYGreaterReferenceValueInt-1否grid-view向下滑动偏移量,配合onScrollEnable属性使用
:layoutTargetPositionInt-1否指定某个item更新外部定义方法,详情请见TriggerTaskModule
:makeChildVisibleTypeString"center"否指定某个子视图显示在屏幕中位置的类型,共分为:center:居中显示;normal:默认显示; none:只显示viewgroup矩形区域
:makeChildVisibleClampBackwardInt0否焦点向下,列表上滑到屏幕中最后一个元素时的向上滑动偏移量(只有在:makeChildVisibleType属性不为center时有效)
:makeChildVisibleClampForwardInt0否焦点向上,列表下滑到屏幕中最后一个元素时的向下滑动偏移量(只有在:makeChildVisibleType属性不为center时有效)
:scrollThresholdHorizontalInt300否列表水平滑动时触发item显示在屏幕正中间位置的阀值(超过阀值则触发,只有在:makeChildVisibleType属性为center时有效)
:scrollThresholdVerticalInt50否列表垂直滑动时触发item显示在屏幕正中间位置的阀值(超过阀值则触发,只有在:makeChildVisibleType属性为center时有效)
:cachePoolMap无否设置adapter的缓存池;示例cachePool:{ name:"tvList"+Date.now(), size:{ 10000:10, } },
:cachePoolNameString无否设置当前使用缓存池名称
:focusMemoryBooleantrue否是否开启焦点强制移动(寻焦速度更快)
:setSelectChildPositionInt0否设置选中的子view,此属性只在view已经显示出来才有效
:shakePreCheckNumberInt2否设置列表滑动到底部触发回弹动画时的提前量(横向滑动时是滑动到最右)
:endHintEnabledBooleantrue否是否开启列表回弹动画
:listenFocusSearchOnFailBooleantrue否是否开启当焦点寻焦失败时的事件回调
:enableSelectOnFocusBooleantrue否是否开启指定获取焦点
:useAdvancedFocusSearchBooleantrue否是否关闭recyclerView的默认焦点搜索
:enableKeepFocusBooleanfalse否是否开启焦点预处理
:initFocusPositionAfterLayoutInt-1否设置焦点初始默认位置
:blockFocusDirectionsArray无否在某个方向锁住焦点
:headBlankNumber无90waterfall距离顶部的距离
:isLoadMoreBoolean无true
:prevLoadNumberNumber无3加载更多预加载数量