ViewPagerIndicator README

The project's README from github.com/JakeWharton/ViewPagerIndicator. As one markdown file: README.md.

Android ViewPagerIndicator

Paging indicator widgets that are compatible with the ViewPager from the Android Support Library to improve discoverability of content.

Try out the sample application on the Android Market.

ViewPagerIndicator Sample Screenshots

These widgets can also be used in conjunction with ActionBarSherlock!

Usage

For a working implementation of this project see the sample/ folder.

  1. Include one of the widgets in your view. This should usually be placed adjacent to the ViewPager it represents.

    <com.viewpagerindicator.TitlePageIndicator android:id="@+id/titles" android:layout_height="wrap_content" android:layout_width="fill_parent" />

  2. In your onCreate method (or onCreateView for a fragment), bind the indicator to the ViewPager.

    //Set the pager with an adapter
ViewPager pager = (ViewPager)findViewById(R.id.pager);
pager.setAdapter(new TestAdapter(getSupportFragmentManager()));

//Bind the title indicator to the adapter
TitlePageIndicator titleIndicator = (TitlePageIndicator)findViewById(R.id.titles);
titleIndicator.setViewPager(pager);

  3. (Optional) If you use an OnPageChangeListener with your view pager you should set it in the indicator rather than on the pager directly.

    //continued from above
titleIndicator.setOnPageChangeListener(mPageChangeListener);

Theming

There are three ways to style the look of the indicators.

  1. Theme XML. An attribute for each type of indicator is provided in which you can specify a custom style.
  2. Layout XML. Through the use of a custom namespace you can include any desired styles.
  3. Object methods. Both styles have getters and setters for each style attribute which can be changed at any point.

Each indicator has a demo which creates the same look using each of these methods.

Including In Your Project

Android-ViewPagerIndicator is presented as an Android library project. A standalone JAR is not possible due to the theming capabilities offered by the indicator widgets.

You can include this project by referencing it as a library project in Eclipse or ant.

If you are a Maven user you can easily include the library by specifying it as a dependency:

<dependency>
  <groupId>com.viewpagerindicator</groupId>
  <artifactId>library</artifactId>
  <version>2.4.1</version>
  <type>apklib</type>
</dependency>

This project depends on the ViewPager class which is available in the Android Support Library or ActionBarSherlock. Details for including one of those libraries is available on their respecitve web sites.

Developed By

Credits

License

Copyright 2012 Jake Wharton
Copyright 2011 Patrik Åkerfeldt
Copyright 2011 Francisco Figueiredo Jr.

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.

ViewPagerIndicator (JakeWharton/ViewPagerIndicator)

Searching Database…

10.1K ·GitHub
ViewPagerIndicator
archived
Что это такое?Набор виджетов-индикаторов страниц для Android, которые размещаются рядом с ViewPager из Android Support Library или ActionBarSherlock и показывают, на какой странице находится пользователь — так контент легче найти.
Это готовое приложение или то, что я добавляю в свой Android-проект?Это Android library project, который вы подключаете к своему приложению, а не отдельный JAR — JAR здесь невозможен, потому что для тем оформления нужны ресурсы библиотеки.
Как подключить её к своему проекту?Подключите её как Android library project в Eclipse или ant либо добавьте Maven-зависимость com.viewpagerindicator:library:2.4.1 (apklib). В папке sample/ репозитория лежит полностью рабочий пример.
Нужно ли моему приложению что-то ещё, чтобы индикаторы работали?Да — в проекте также должно быть то, что даёт класс ViewPager: Android Support Library или ActionBarSherlock. Как их настроить, описано на сайтах этих библиотек.
Проект до сих пор активно поддерживается?Нет — репозиторий на GitHub заархивирован и открыт только для чтения, а код относится к 2011–2012 годам и рассчитан на эпоху Eclipse/ant и Maven. Скорее всего, перед использованием в современном Android-проекте его придётся адаптировать.
Как привязать индикатор к моему ViewPager?Добавьте виджет в layout рядом с ViewPager, затем в onCreate (или onCreateView, если это фрагмент) вызовите indicator.setViewPager(pager). Если вы используете OnPageChangeListener, назначайте его индикатору, а не самому пейджеру напрямую.
Можно ли менять внешний вид индикаторов?Да, три способа: через атрибут style в XML вашей темы, через стили с кастомным namespace в layout XML либо через геттеры и сеттеры объекта индикатора во время выполнения.
Какие стили индикаторов есть в библиотеке?В примере использования показан TitlePageIndicator, а в благодарностях отмечается, что индикаторы с заголовками и кружки изначально взяты из ViewFlow Patrik Åkerfeldt. Для каждого типа индикатора предусмотрен свой атрибут, и у каждого типа есть отдельная демонстрация в примере приложения.
Поддерживаются ли фрагменты?Да — в благодарностях упомянут Francisco Figueiredo Jr. за идею и первую реализацию поддержки фрагментов через ViewPager, а в примере пейджер создаётся через getSupportFragmentManager().
What are similar projects?banner, flexbox-layout, vlayout, CircleImageView, SlidingMenu, material-dialogs, material-components-android, MaterialDrawer
Which topics is it in?pagination, xml, widgets, layout, android-library, mobile-development, ui-components, deprecated, java, mobile, ui, android
Creator
JakeWharton
Size
8.5 MB
Stars
10.1K
Updated
CommitSep 12
Age
15y
Commits · 90 Days