RecyclerViewRenderers - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #typescript #golang #android #machine-learning #awesome #cli #kubernetes #vue #pytorch #mcp #ios

RecyclerViewRenderers

(★ 135)

RecyclerView made easy

파일 탐색기

최종 버전 다운로드 (.zip)

- Screenshot.png
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- proguard-rules.pro
- recyclerview-renderers-demo.iml
- .gitignore
- build.gradle
- proguard-rules.pro
- recyclerview-renderers-lib.iml
.gitignore
build.gradle
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/alexrs/RecyclerViewRenderers

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd RecyclerViewRenderers

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

RecyclerViewRenderers
=====================
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-RecyclerViewRenderers-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1086)

![image](https://raw.githubusercontent.com/alexrs/RecyclerViewRenderers/master/art/Screenshot.png)

Creating adapters each time you want to use a `RecyclerView` is boring. Everybody knows it.
Also, creating an adapter that accepts different types of data, with its corresponding views, and manage them generates adapters with lines and lines of code that are difficult to maintain.

`RecyclerViewRenderers` is a library whose main objective is to reduce the time you spend fighting against `RecyclerView`	.

It has been designed to help you have your code separated and decoupled.

Thanks to [Sefford](https://github.com/Sefford) for his great library [Brender](https://github.com/Sefford/brender), that has inspired me to write this one.

#### Download
```GROOVY
compile 'me.alexrs:recyclerview-renderers:1.0.4'
```

## Usage
First, we have to declare a RecyclerView in the layout:
```XML
<android.support.v7.widget.RecyclerView
	android:id="@+id/recyclerView"
	android:layout_width="match_parent"
	android:layout_height="match_parent" />
```
Then, in the Activity or Fragment:
```JAVA
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);

//If we are going to have different items, we have to indicate it
recyclerView.setHasFixedSize(false);

//LayoutManager
LinearLayoutManager layoutManager = new LinearLayoutManager(this);
layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
recyclerView.setLayoutManager(layoutManager);

//Adapter (Where magic happens!)
RendererAdapter adapter = new RendererAdapter(items, new RendererBuilder(new Factory()));
recyclerView.setAdapter(adapter);
```

#### Renderables
This classes should contain the data and must implement Renderable. The method `getRenderableId` returns the ID of the layout that will display the data.

```JAVA
public class ItemBender implements Renderable {

private String title;

private String summary;

public ItemBender(String title, String summary) {
        this.title = title;
        this.summary = summary;
    }

public String getTitle() {
        return title;
    }

public String getSummary() {
        return summary;
    }

@Override
    public int getRenderableId() {
        return R.layout.item_bender;
    }
}
```
#### ViewHolder

The `ViewHolder` pattern was used in ListViews to recycle the views and reduce the usage of `findViewById`. In the new `RecyclerView` the `ViewHolder` is used to indicate the `Adapter` how to set the data to the views.
You can indicate here the action that should be performed when this item is clicked in the `RecyclerView` and you can also use [ButterKnife](https://github.com/JakeWharton/butterknife)!

```JAVA
public class ViewHolderBender extends RenderViewHolder<ItemBender> implements View.OnClickListener {

@InjectView(R.id.title)
    TextView title;
    @InjectView(R.id.summary)
    TextView summary;

public ViewHolderBender(View itemView) {
        super(itemView);
        ButterKnife.inject(this, itemView);
        itemView.setOnClickListener(this);
    }

@Override
    public void onBindView(ItemBender renderable) {
        title.setText(renderable.getTitle());
        summary.setText(renderable.getSummary());
    }
    
    @Override
    public void onClick(View v) {
        Intent intent = new Intent(getContext(), OtherClass.class);
        getContext().startActivity(intent);
    }

}
```

#### Renderer
The `Renderer` is the class responsible for creating the `ViewHolder` of each `Renderable`. The method `onCreateViewHolder` should return the `ViewHolder`.

```JAVA
public class ItemBenderRenderer extends Renderer {

public ItemBenderRenderer(int id) {
        super(id);
    }

@Override
    public RenderViewHolder onCreateViewHolder(ViewGroup viewGroup, int id) {
        View itemView = LayoutInflater.from(viewGroup.getContext())
                .inflate(id, viewGroup, false);
        return new ViewHolderBender(itemView);
    }
}
```

#### Factory
You have to create a class that implements `RendererFactory`. The method `getRenderer` will be implemented. It will receive as parameter the id of the layout returned by `getRenderableId` in your `Renderable`.

```JAVA
public class Factory implements RendererFactory {

@Override
    public Renderer getRenderer(int id) {
        switch (id) {
            case R.layout.item_bender:
                return new ItemBenderRenderer(id);
            case R.layout.item_zoidberg:
                return new ItemZoidbergRenderer(id);
            case R.layout.item_fry:
                return new ItemFryRenderer(id);
        }
        return null;
    }
}
```
#### TODO
* Test

License
-------
	Copyright (C) 2014 Alejandro Rodriguez Salamanca.

Licensed under the Apache License, Version 2.0 (the "License");
	you may not use this file except in compliance with the License.
	You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.