TvRecyclerView

A custom RecyclerView for Android TV end.中文说明

ScreenShot

Usage

1.First you can add gradle dependency with command :

dependencies {
    ......
    compile 'com.henryblue.library:tvrecyclerview:1.0.9'
   }

To add gradle dependency you need to open build.gradle (in your app folder,not in a project folder) then copy and add the dependencies there in the dependencies block;

2.Add TvRecyclerView in your layout

<app.com.tvrecyclerview.TvRecyclerView
        android:id="@+id/tv_recycler_view"
        android:layout_width="match_parent"
        android:layout_height="580dp"
        app:focusDrawable="@drawable/default_focus"/>

3.Set the LayoutManager and Adapter

 mTvRecyclerView = (TvRecyclerView) findViewById(R.id.tv_recycler_view);
 GridLayoutManager manager = new GridLayoutManager(NormalFocusActivity.this, 3);
 manager.setOrientation(LinearLayoutManager.HORIZONTAL);
 mTvRecyclerView.setLayoutManager(manager);

 int itemSpace = getResources().
                getDimensionPixelSize(R.dimen.recyclerView_item_space);
 mTvRecyclerView.addItemDecoration(new SpaceItemDecoration(itemSpace));
        
 NormalAdapter mAdapter = new NormalAdapter(this);
 mTvRecyclerView.setAdapter(mAdapter);

 mTvRecyclerView.setOnItemStateListener(new TvRecyclerView.OnItemStateListener() {
      @Override
      public void onItemViewClick(View view, int position) {
          Log.i(TAG, "you click item position: " + position);
      }

      @Override
      public void onItemViewFocusChanged(boolean gainFocus, View view, int position) {
      }
 });
 mTvRecyclerView.setSelectPadding(35, 34, 35, 38);

XML attributes

    <app.com.tvrecyclerview.TvRecyclerView
        ...
        app:scrollMode="followScroll"
        app:isAutoProcessFocus="false"
        app:focusScale="1.04f"
        app:focusDrawable="@drawable/default_focus"
        ...
        />

Name	Type	Default	Description
scrollMode	enum	normalScroll	Set the way to slide
isAutoProcessFocus	boolean	true	Sets the focus of the control
focusScale	Float	1.04f	Set the focus scale. If 'isAutoProcessFocus' is true, this property has no effect, always equal 1.0f
focusDrawable	reference	null	set focus drawable, If 'isAutoProcessFocus' is true, this property has no effect

Public Methods

Name	Description
setSelectedScale(float)	change value of focusScale
setIsAutoProcessFocus(boolean)	sets the focus of the control
setFocusDrawable(Drawable)	sets the focus of the drawable
setItemSelected(int)	sets the position of item gets focus
setSelectPadding(int,int,int,int)	sets the focus of the drawable padding, make the drawable include item

Note: Because I extended RecyclerView you can use all RecyclerView public methods too.

License