jasperben/tvrecyclerview

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

欢迎使用 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