https://github.com/jfeinstein10/JazzyViewPager

An easy to use ViewPager that adds an awesome set of custom swiping animations. Just change your ViewPagers to JazzyViewPagers, two more steps, and you're good to go!
https://github.com/jfeinstein10/JazzyViewPager

Last synced: about 1 month ago
JSON representation

An easy to use ViewPager that adds an awesome set of custom swiping animations. Just change your ViewPagers to JazzyViewPagers, two more steps, and you're good to go!

• Host: GitHub
• URL: https://github.com/jfeinstein10/JazzyViewPager
• Owner: jfeinstein10
• License: apache-2.0
• Created: 2013-02-01T04:57:42.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2015-08-30T23:33:20.000Z (almost 9 years ago)
• Last Synced: 2024-04-17T21:21:35.828Z (2 months ago)
• Language: Java
• Homepage:
• Size: 972 KB
• Stars: 2,671
• Watchers: 181
• Forks: 816
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Lists

• android-awesome-libraries - JazzyViewPager
• awesome-android-person - JazzyViewPager
• awesome-stars - JazzyViewPager - An easy to use ViewPager that adds an awesome set of custom swiping animations. Just change your ViewPagers to JazzyViewPagers, two more steps, and you're good to go! (Java)

README

        
JazzyViewPager

==============

An easy to use ViewPager that adds an awesome set of custom swiping animations. 

Just change your ViewPagers to JazzyViewPagers and you're good to go!

If you're looking at the name of the library and thinking "... so what does jazz have to do with it?"

I'd like to direct you to the following definition that I found in a dictionary:

```

jazz someone or something up:

	to make someone or something more exciting or sexy;

	to make someone or something appeal more to contemporary tastes.

```

**The aim of this library is to do exactly this: jazz up the normal, everyday `ViewPager`**

	

I've included a pretty barebones `apk` to show what the `TransitionEffect.Tablet` animation does. 

The example app will get better, but this is just to get something in your hands quickly :D!

This project was inspired by CyanogenMod's Trebuchet launcher.

Animations Available

-------

The `JazzyViewPager`'s animations are encapsulated in `TransitionEffect`. I'll be adding more, but if you can think of anything 

in particular, let me know by filing an "Enhancement" in the Issues section.

```java

public enum TransitionEffect {

    	Standard,

		Tablet,

		CubeIn,

		CubeOut,

		Flip,

		Stack,

		ZoomIn,

		ZoomOut,

		RotateUp,

		RotateDown,

		Accordion

	}

```

You can select your animation by calling

```java

private JazzyViewPager mJazzy;

/* ... */

mJazzy.setTransitionEffect(TransitionEffect.*);

```

Modifying your `PagerAdapter`

-------

Due to the limitations of the `ViewPager` class (which `JazzyViewPager` is built upon) in order to get the animations to work correctly 

for more than 3 Views, you'll have to add the following to the `instantiateItem` method of your `PagerAdapter`.

```java

private JazzyViewPager mJazzy;

/* ... */

@Override

public Object instantiateItem(ViewGroup container, final int position) {

    Object obj = super.instantiateItem(container, position);

	mJazzy.setObjectForPosition(obj, position);

	return obj;

}

```

Once your `Object` is registered with the `JazzyViewPager`, you're good to go!

License

-------

    Copyright 2013 Jeremy Feinstein

    

    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.