https://github.com/BCsl/GalleryLayoutManager
New way to implements ViewPager/Gallery in Android with RecycleView
https://github.com/BCsl/GalleryLayoutManager
gallery layoutmanager recyclerview viewpager
Last synced: about 1 month ago
JSON representation
New way to implements ViewPager/Gallery in Android with RecycleView
- Host: GitHub
- URL: https://github.com/BCsl/GalleryLayoutManager
- Owner: BCsl
- License: apache-2.0
- Created: 2016-12-15T08:08:33.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-08-23T03:25:22.000Z (almost 3 years ago)
- Last Synced: 2024-08-03T01:24:45.001Z (10 months ago)
- Topics: gallery, layoutmanager, recyclerview, viewpager
- Language: Java
- Homepage:
- Size: 2.91 MB
- Stars: 955
- Watchers: 16
- Forks: 141
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-github-android-ui - GalleryLayoutManager - Android中Gallery或ViewPager控件的效果 (ViewPager)
README
# GalleryLayoutManager
[中文](./README_CN.md)
A custom LayoutManager to build a Gallery or a ViewPager like RecyclerView that shows items in a center-locked and support both HORIZONTAL and VERTICAL scroll.And View Recycle Machine is also supported.
## Screenshots
## Usage
### 1、Build
#### Gradle
```groovy
implementation 'github.hellocsl:GalleryLayoutManager:{latest-release-version}'
```
### 2、In your code
#### Basis Usage
Use `GalleryLayoutManager#attach(RecycleView recycleView)` to setup `GalleryLayoutManager` for your `RecycleView` instead of `RecycleView#setLayoutManager(LayoutManager manager)`
```java
GalleryLayoutManager layoutManager = new GalleryLayoutManager(GalleryLayoutManager.HORIZONTAL);
//layoutManager.attach(mPagerRecycleView); // default selected position is 0
layoutManager.attach(mPagerRecycleView, 30);
//...
//setup adapter for your RecycleView
mPagerRecycleView.setAdapter(imageAdapter);
```
#### Listen to selection change
```java
layoutManager.setCallbackInFling(true);//should receive callback when flinging, default is false
layoutManager.setOnItemSelectedListener(new GalleryLayoutManager.OnItemSelectedListener() {
@Override
public void onItemSelected(RecyclerView recyclerView, View item, int position) {
//.....
}
});
```
#### Apply ItemTransformer just like ViewPager
Implements your `ItemTransformer`
```java
public class ScaleTransformer implements GalleryLayoutManager.ItemTransformer {
@Override
public void transformItem(GalleryLayoutManager layoutManager, View item, float fraction) {
item.setPivotX(item.getWidth() / 2.F);
item.setPivotY(item.getHeight() / 2.F);
float scale = 1 - 0.3F * Math.abs(fraction);
item.setScaleX(scale);
item.setScaleY(scale);
}
}
```
```java
// Apply ItemTransformer just like ViewPager
layoutManager.setItemTransformer(new ScaleTransformer());
```
## License
```
Copyright [2017] [Hello Csl]
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
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.
```