Skip to content

简介

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

注意,最低支持SDK版本2.1

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

效果预览

Waterfall

属性

参数说明类型可选值说明
:initPositionMapfocusPosition:请求焦点的位置,可以不传,不传不会请求焦点;scrollToPosition:首次滚动的位置,可以不传;scrollOffset:首次滚动的偏移量,可以不传。示例如下。
:listenBoundEventBooleanfalse是否开启view绑定监听回调,开启分页时必须设置该参数为true
:disableScrollOnFirstScreenBooleanfalse是否开启列表在展示第一屏数据时切换焦点不滑动
:checkScrollOffsetOnStateChangedBooleanfalse是否开启grid-view滑动事件onScrollStateChanged监听回调
:scrollEventThrottleInt400grid-view滑动事件onScrolled监听回调间隔时间,配合onScrollEnable属性使用,单位:毫秒
:onScrollEnableBooleanfalse是否开启grid-view滑动事件onScrolled监听回调
:scrollYLesserReferenceValueInt-1grid-view向上滑动偏移量,配合onScrollEnable属性使用
:scrollYGreaterReferenceValueInt-1grid-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在某个方向锁住焦点
:headBlankNumber90waterfall距离顶部的距离
:isLoadMoreBooleantrue
:prevLoadNumberNumber3加载更多预加载数量