Appearance
简介
介绍:qt-waterfall
是由tv-list
而实现的瀑布流内容组件,常用于应用详情页、播放页等。支持横向纵向排列,支持数据分页。
注意,最低支持SDK版本
2.1
注意,
qt-waterfall
组件中默认item样式使用qt-poster
, 在构建数据中可查看其使用方式。也可自定义item。
效果预览
属性
参数 | 说明 | 类型 | 可选值 | 说明 |
---|---|---|---|---|
:initPosition | Map | 无 | 否 | focusPosition:请求焦点的位置,可以不传,不传不会请求焦点;scrollToPosition:首次滚动的位置,可以不传;scrollOffset:首次滚动的偏移量,可以不传。示例如下。 |
:listenBoundEvent | Boolean | false | 否 | 是否开启view绑定监听回调,开启分页时必须设置该参数为true |
:disableScrollOnFirstScreen | Boolean | false | 否 | 是否开启列表在展示第一屏数据时切换焦点不滑动 |
:checkScrollOffsetOnStateChanged | Boolean | false | 否 | 是否开启grid-view滑动事件onScrollStateChanged监听回调 |
:scrollEventThrottle | Int | 400 | 否 | grid-view滑动事件onScrolled监听回调间隔时间,配合onScrollEnable属性使用,单位:毫秒 |
:onScrollEnable | Boolean | false | 否 | 是否开启grid-view滑动事件onScrolled监听回调 |
:scrollYLesserReferenceValue | Int | -1 | 否 | grid-view向上滑动偏移量,配合onScrollEnable属性使用 |
:scrollYGreaterReferenceValue | Int | -1 | 否 | grid-view向下滑动偏移量,配合onScrollEnable属性使用 |
:layoutTargetPosition | Int | -1 | 否 | 指定某个item更新外部定义方法,详情请见TriggerTaskModule |
:makeChildVisibleType | String | "center" | 否 | 指定某个子视图显示在屏幕中位置的类型,共分为:center:居中显示;normal:默认显示; none:只显示viewgroup矩形区域 |
:makeChildVisibleClampBackward | Int | 0 | 否 | 焦点向下,列表上滑到屏幕中最后一个元素时的向上滑动偏移量(只有在:makeChildVisibleType 属性不为center时有效) |
:makeChildVisibleClampForward | Int | 0 | 否 | 焦点向上,列表下滑到屏幕中最后一个元素时的向下滑动偏移量(只有在:makeChildVisibleType 属性不为center时有效) |
:scrollThresholdHorizontal | Int | 300 | 否 | 列表水平滑动时触发item显示在屏幕正中间位置的阀值(超过阀值则触发,只有在:makeChildVisibleType 属性为center时有效) |
:scrollThresholdVertical | Int | 50 | 否 | 列表垂直滑动时触发item显示在屏幕正中间位置的阀值(超过阀值则触发,只有在:makeChildVisibleType 属性为center时有效) |
:cachePool | Map | 无 | 否 | 设置adapter的缓存池;示例cachePool:{ name:"tvList"+Date.now(), size:{ 10000:10, } }, |
:cachePoolName | String | 无 | 否 | 设置当前使用缓存池名称 |
:focusMemory | Boolean | true | 否 | 是否开启焦点强制移动(寻焦速度更快) |
:setSelectChildPosition | Int | 0 | 否 | 设置选中的子view,此属性只在view已经显示出来才有效 |
:shakePreCheckNumber | Int | 2 | 否 | 设置列表滑动到底部触发回弹动画时的提前量(横向滑动时是滑动到最右) |
:endHintEnabled | Boolean | true | 否 | 是否开启列表回弹动画 |
:listenFocusSearchOnFail | Boolean | true | 否 | 是否开启当焦点寻焦失败时的事件回调 |
:enableSelectOnFocus | Boolean | true | 否 | 是否开启指定获取焦点 |
:useAdvancedFocusSearch | Boolean | true | 否 | 是否关闭recyclerView的默认焦点搜索 |
:enableKeepFocus | Boolean | false | 否 | 是否开启焦点预处理 |
:initFocusPositionAfterLayout | Int | -1 | 否 | 设置焦点初始默认位置 |
:blockFocusDirections | Array | 无 | 否 | 在某个方向锁住焦点 |
:headBlank | Number | 无 | 90 | waterfall距离顶部的距离 |
:isLoadMore | Boolean | 无 | true | |
:prevLoadNumber | Number | 无 | 3 | 加载更多预加载数量 |