Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/drozdzynski/Steppers

Steppers view library for Android, based on Google Material design guidelines
https://github.com/drozdzynski/Steppers

android design material stepper

Last synced: about 1 month ago
JSON representation

Steppers view library for Android, based on Google Material design guidelines

Awesome Lists containing this project

README

        




# Steppers

## Screen

## Setup

### 1. Add library to project

#### Grab via Gradle:
```groovy
dependencies {
compile 'me.drozdzynski.library.steppers:steppers:1.0.0'
}
```

#### Manual
* Download the library folder.
* Copy to root project folder
* Add to your settings.gradle file the following code line: "include ':app', ':steppers'"
* Rebuild the project
* Add dependency
* File → Project Structure
* in Modules section click on "app"
* Click on tab "Dependecies"
* Click on the green plus
* Module Dependecy
* Select ":library"
* Done

### 2. Add view in XML Layout
```xml

```

### 3. Setup config for SteppersView
```java
SteppersView.Config steppersViewConfig = new SteppersView.Config();
steppersViewConfig.setOnFinishAction(new OnFinishAction() {
@Override
public void onFinish() {
// Action on last step Finish button
}
});

steppersViewConfig.setOnCancelAction(new OnCancelAction() {
@Override
public void onCancel() {
// Action when click cancel on one of steps
}
});

steppersViewConfig.setOnChangeStepAction(new OnChangeStepAction() {
@Override
public void onChangeStep(int position, SteppersItem activeStep) {
// Action when click continue on each step
}
});

// Setup Support Fragment Manager for fragments in steps
steppersViewConfig.setFragmentManager(getSupportFragmentManager());
```

### 4. Create steps list
```java
ArrayList steps = new ArrayList<>();

SteppersItem stepFirst = new SteppersItem();

stepFirst.setLabel("Title of step");
stepFirst.setSubLabel("Subtitle of step");
stepFirst.setFragment(new SomeFragment());
stepFirst.setPositiveButtonEnable(false);

steps.add(stepFirst);
```

### 5. Set config, list and build view;
```java
SteppersView steppersView = (SteppersView) findViewById(R.id.steppersView);
steppersView.setConfig(steppersViewConfig);
steppersView.setItems(steps);
steppersView.build();
```

## Other functions

### Enable skip step button
Simple:
```java
item.setSkippable(true);
```

With callback:
```java
item.setSkippable(true, new OnSkipStepAction() {
@Override
public void onSkipStep() {
// Some action after step is skipped
}
});
```

### Override continue button
```java
item.setOnClickContinue(new OnClickContinue() {
@Override
public void onClick() {
// Some action on click

steppersView.nextStep(); // Now You must call next step
}
});
```

### Change active step
```java
steppersView.setActiveItem(1); // step index from 0
```

### Disable cancel button (hide)
```java
steppersViewConfig.setCancelAvailable(false);
```

## License
```
Copyright (C) 2015-2017 Krystian Drożdżyński

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.
```