Skip to content

TvRecyclerView--针对TV端特性进行的适配与开发

Notifications You must be signed in to change notification settings

Jasperben/TvRecyclerView

 
 

Repository files navigation

欢迎使用 TvRecyclerView

群 号:484790001 群二维码

首先感谢lucasr开发出杰出的作品TwoWayView,TvRecyclerView就是在TwoWayView的基础上进行的延伸,即:

  • 修复了一些小bug
  • 针对TV端的特性进行了适配与开发

效果

Android Studio 集成

compile 'com.tv.boost:tv-recyclerview:1.1.0'

特性

  • 支持焦点快速移动

  • 支持Item选中放大时不被叠压(无需手动调用bringChildToFront())

  • 支持横/竖排列

    android:orientation="horizontal"
  • 支持布局指定LayoutManager

    app:tv_layoutManager="SpannableGridLayoutManager"
  • 支持设置选中Item边缘距离/居中

    setSelectedItemAtCentered(boolean isCentered)
    setSelectedItemOffset(int offsetStart, int offsetEnd)
  • 支持设置横竖间距

    setSpacingWithMargins(int verticalSpacing, int horizontalSpacing)
  • Item监听回调

    //item选中、点击监听
    mRecyclerView.setOnItemListener(new TvRecyclerView.OnItemListener() {
        @Override
        public void onItemPreSelected(TvRecyclerView parent, View itemView, int position) {
                //上次选中
        }
    
        @Override
        public void onItemSelected(TvRecyclerView parent, View itemView, int position) {
                //当前选中
        }
    
        @Override
        public void onItemClick(TvRecyclerView parent, View itemView, int position) {
                //点击
        }
    });
    
    //边界监听
    mRecyclerView.setOnInBorderKeyEventListener(new TvRecyclerView.OnInBorderKeyEventListener() {
                @Override
                public boolean onInBorderKeyEvent(int direction, int keyCode, KeyEvent event) {
                    switch (keyCode) {
                        case KeyEvent.KEYCODE_DPAD_DOWN:
                            // do anything
                            return true;
                        case KeyEvent.KEYCODE_DPAD_RIGHT:
                            // do anything
                            return true;
                    }
                    return false;
                }
            });
    
    //加载更多
    mRecyclerView.setOnLoadMoreListener(new TvRecyclerView.OnLoadMoreListener() {
                @Override
                public boolean onLoadMore() {
                    mRecyclerView.setLoadingMore(true); //正在加载数据
                    mLayoutAdapter.appendDatas(); //加载数据
                    mRecyclerView.setLoadingMore(false); //加载数据完毕
                    return true; //是否还有更多数据
                }
            });
           

版本说明

  • 1.0.1 解决item点击无效问题
  • 1.0.2 解决移动边框错位问题
  • 1.0.3 优化了一些细节,删除无用资源
  • 1.0.4 优化了一些细节,删除无用资源
  • 1.0.5 1)修复在adapter内为item设置监听无效的问题; 2)可自由设置是否拦截key事件; 3)增加焦点移动边缘监听; 4)增加菜单模式; 5)自定义属性统一增加前缀tv;
  • 1.0.5.1 1)修复菜单模式下的bug;
  • 1.0.5.2 1)修复菜单模式下的bug;
  • 1.0.6 自动记忆历史焦点,默认选中上次离开时的position;
  • 1.0.6.1 微调;
  • 1.0.6.2 1)增加加载更多监听; 2)修复加载更多数据更新时焦点错乱问题;
  • 1.0.6.3 1)处理onSaveInstanceState,onRestoreInstanceState;
  • 1.0.6.4 1)修复glide加载图片焦点错位问题; 2)增加tv_isSelectFirstVisiblePosition自定义参数;
  • 1.0.6.5 1)修复IsSelectFirstVisiblePosition参数失效问题; 2)增加tv_loadMoreBeforehandCount自动定义参数;
  • 1.0.6.6 1)修复加载更多监听偶然失效的问题;
  • 1.0.6.7 1)处理removeItem后的焦点问题; 2)处理初始化焦点问题;
  • 1.0.6.8 1)优化removeItem后的焦点问题; 2)优化初始化焦点问题;
  • 1.0.6.9 1)暂时去掉初始化焦点;
  • 1.0.7 1)verticalSpacing和horizontalSpacing对调;
  • 1.0.7.1 1)修复追加更多数据偶尔不显示的问题;
  • 1.0.7.2 1)增加setItemActivated方法;
  • 1.0.7.3 修复重新setAdapter后第一条被遮挡的问题
  • 1.0.7.5 1)优化setSelection方法; 2)注释log打印;
  • 1.0.7.6 1)增加scrollToPositionWithOffsetStart(int position); 2)增加scrollToPositionWithOffset(int position, int offset); 3)修复removeItem为0时,报异常的bug; 4)修复系统回收后重建报异常的bug; 5)优化菜单模式下selector的状态切换;
  • 1.0.7.7 1) 增加setHasMore方法;
  • 1.0.7.8 1) 尝试修复系统回收后重建报异常的bug;
  • 1.0.7.11 1)优化setSelection方法; 2) 修复在ViewPager中移除重新添加后滚动实效的问题;
  • 1.1.0 1)部分代码优化重构; 2)增加MetroGridLayoutManager;

更详细的使用请见exmaple


作者 owen

About

TvRecyclerView--针对TV端特性进行的适配与开发

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%