Home

Awesome

BreadcrumbsView

Android Arsenal

A customizable Android view which shows the current step of a given series. Its main purpose is to provide a contextual reference for paginated forms.

Screenshots

SetUp

Add to top level gradle.build file

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

Add to app module gradle.build file

dependencies {
    compile 'com.github.VictorAlbertos:BreadcrumbsView:0.0.4'
}

Usage

XML inflation

Define a BreadcrumbsView in xml layout as follows:

  <io.victoralbertos.breadcumbs_view.BreadcrumbsView
      android:id="@+id/breadcrumbs"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      app:numberOfSteps="5"
      app:visitedStepBorderDotColor="@color/colorVisited"
      app:visitedStepFillDotColor="@color/colorVisited"
      app:nextStepBorderDotColor="@color/colorNext"
      app:nextStepFillDotColor="@color/colorNext"
      app:visitedStepSeparatorColor="@color/colorVisited"
      app:nextStepSeparatorColor="@color/colorNext"
      app:radiusDot="@dimen/radius_dot"
      app:sizeDotBorder="@dimen/size_dot_border"
      app:heightSeparator="@dimen/height_separator"/>

Among the previous custom attributes, only app:numberOfSteps is mandatory, requiring to be an integer value greater than 1.

Moving between steps

Once instantiated the instance of BreadcrumbsView, use breadcrumbs.nextStep() to move to the next step, and breadcrumbs.prevStep() to move to the previous one. If not steps are left to move backward or forward, an IndexOutOfBoundsException is thrown.

Survive config changes

In order to retain the current step between config changes, use breadcrumbs.setCurrentStep(int). You must call it before the view is measured. Otherwise, it throws an IllegalStateException.

Examples

The module test-sample contains both a minimal example and a UI test driven by Espresso.