This has been forked from https://github.com/Papercloud/SimpleViewPagerIndicator. However, since leaving Papercloud I don't have access to the repository anymore. Any future updates to SimpleViewPagerIndicator will be pushed here instead.
SimpleViewPagerIndicator is a small, easy to use class that you can add to your Android projects to graphically display the number of elements in a ViewPager, as well as allow users to quickly switch pages by touching the page indicators.
After checking out some existing libraries for doing similar things, I found that many were overly complicated for what I was trying to accomplish. SimpleViewPagerIndicator is designed to allow developers to specify a simple (hence the name), customisable container in an XML layout file, and add elements (in the case of the screenshot, light bulbs) on the fly. The elements have two states - normal, and highlighted. Changing pages simply changes the image state.
Included in this repository is the SimpleViewPagerIndicator class itself, as well a a sample indicator layout file and a few small images.
-
Add the SimpleViewPagerIndicator class, view_pager_indicator.xml layout file and sample images to your project.
-
Import your project's R file in SimpleViewPagerIndicator.
-
In your activity's layout file, add:
<au.com.papercloud.pager.SimpleViewPagerIndicator android:id="@+id/page_indicator" android:layout_width="match_parent" android:layout_height="wrap_content" android:gravity="center" /> -
In your activity that contains a ViewPager, just add:
SimpleViewPagerIndicator pageIndicator = (SimpleViewPagerIndicator) findViewById(R.id.page_indicator); pageIndicator.setViewPager(pager); -
Of course, you may also create the indicator in code and add it to your activity's content view.
-
Any time the view pager's data is changed, be sure to call
pageIndicator.notifyDataSetChanged(); -
Change the layout file and images to your heart's content.
If you intend to add an OnPageChangeListener to your view pager, add it to the SimpleViewPagerIndicator instead.
This is a simple set of files that I've decided to open source because I thought it'd be useful to someone else. In no way is it guaranteed to be highly optimised nor bug free. If anyone has any suggestions for improvement, please create a pull request.
This project is licenced under the Apache Licence v2. You may use and change as you wish. No attribution is required.
Developed by Jarrod Robins 2012, 2013.