Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bravoborja/focusresize

A custom animation with scroll listener to recycler views
https://github.com/bravoborja/focusresize

android android-library custom custom-animation java recyclerview

Last synced: about 4 hours ago
JSON representation

A custom animation with scroll listener to recycler views

Awesome Lists containing this project

README

        

# FocusResize

A custom animation with scroll listener to recycler views

![GIF of its use](https://github.com/bravoborja/FocusResize/blob/master/resources/focusResize.gif)

Based in UltraVisual example of [Ray Wenderlich](http://www.raywenderlich.com/99087/swift-expanding-cells-ios-collection-views).

## Download
To add the FocusResize library to your Android Studio project, simply add the following gradle dependency, with min sdk version of 19:

```java
compile 'com.borjabravo:focusresize:1.0.0'
```

## Usage

To use the FocusResize on your app, you should create a custom adapter that extends from FocusResizeAdapter. For example:
```java
public class DefaultAdapter extends FocusResizeAdapter {

private List items;

public DefaultAdapter(Context context, int height) {
super(context, height);
items = new ArrayList<>();
}

@Override
public int getFooterItemCount() {
// Return items size
return items.size();
}

@Override
public RecyclerView.ViewHolder onCreateFooterViewHolder(ViewGroup parent, int viewType) {
// Inflate your custom item layout
View v = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_custom, parent, false);
return new DefaultCustomViewHolder(v);
}

@Override
public void onBindFooterViewHolder(RecyclerView.ViewHolder holder, int position) {
// Set your data into your custom layout
CustomObject customObject = items.get(position);
fill((DefaultCustomViewHolder)holder, customObject);
}

private void fill(DefaultCustomViewHolder holder, CustomObject customObject) {
holder.titleTextView.setText(customObject.getTitle());
holder.subtitleTextView.setText(customObject.getSubTitle());
holder.image.setImageResource(customObject.getDrawable());
}

@Override
public void onItemBigResize(RecyclerView.ViewHolder viewHolder, int position, int dyAbs) {
// The focused item will resize to big size while is scrolling
}

@Override
public void onItemBigResizeScrolled(RecyclerView.ViewHolder viewHolder, int position, int dyAbs) {
// The focused item resize to big size when scrolled is finished
}

@Override
public void onItemSmallResizeScrolled(RecyclerView.ViewHolder viewHolder, int position, int dyAbs) {
// All items except the focused item will resize to small size when scrolled is finished
}

@Override
public void onItemSmallResize(RecyclerView.ViewHolder viewHolder, int position, int dyAbs) {
// All items except the focused item will resize to small size while is scrolling
}

@Override
public void onItemInit(RecyclerView.ViewHolder viewHolder) {
// Init first item when the view is loaded
}
```
After this, you'll add FocusResizeScrollListener to recycler view:

```java
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
DefaultAdapter defaultAdapter = new DefaultAdapter(this, (int) getResources().getDimension(R.dimen.custom_item_height));
defaultAdapter.addItems(addItems());
if (recyclerView != null) {
recyclerView.setLayoutManager(linearLayoutManager);
recyclerView.setHasFixedSize(true);
recyclerView.setAdapter(defaultAdapter);
recyclerView.addOnScrollListener(new FocusResizeScrollListener<>(defaultAdapter, linearLayoutManager));
}
```

**Important**: In this version, the library only works with LinearLayoutManager.VERTICAL

## License

Copyright 2016 Borja Bravo Álvarez

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.