{"id":13645080,"url":"https://github.com/drozdzynski/Steppers","last_synced_at":"2025-04-21T13:31:41.917Z","repository":{"id":139152475,"uuid":"48655337","full_name":"drozdzynski/Steppers","owner":"drozdzynski","description":"Steppers view library for Android, based on Google Material design guidelines","archived":false,"fork":false,"pushed_at":"2018-09-30T15:18:49.000Z","size":177,"stargazers_count":766,"open_issues_count":9,"forks_count":105,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-04-04T17:09:09.338Z","etag":null,"topics":["android","design","material","stepper"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drozdzynski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-12-27T18:17:52.000Z","updated_at":"2025-01-22T05:36:09.000Z","dependencies_parsed_at":"2024-01-14T11:19:26.922Z","dependency_job_id":"2815fb0f-a91e-4d51-9bd5-3d892b310d74","html_url":"https://github.com/drozdzynski/Steppers","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drozdzynski%2FSteppers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drozdzynski%2FSteppers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drozdzynski%2FSteppers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drozdzynski%2FSteppers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drozdzynski","download_url":"https://codeload.github.com/drozdzynski/Steppers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250064679,"owners_count":21368948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","design","material","stepper"],"created_at":"2024-08-02T01:02:26.011Z","updated_at":"2025-04-21T13:31:41.550Z","avatar_url":"https://github.com/drozdzynski.png","language":"Java","funding_links":["https://www.patreon.com/drozdzynski"],"categories":["StepView","Java"],"sub_categories":[],"readme":"\u003cimg src=\"https://api.travis-ci.org/drozdzynski/Steppers.svg\" /\u003e \u003ca href=\"https://android-arsenal.com/details/1/3301\"\u003e\u003cimg src=\"https://img.shields.io/badge/Android%20Arsenal-Steppers-green.svg?style=true\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.patreon.com/drozdzynski\" rel=\"Patreon\"\u003e\u003cimg src=\"https://img.shields.io/badge/donate-patreon-%23E6461A.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://gitter.im/drozdzynski/Steppers\" rel=\"Gitter\"\u003e\u003cimg src=\"https://img.shields.io/gitter/room/nwjs/nw.js.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://twitter.com/drozdzynskime\" rel=\"some text\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/drozdzynskime.svg?style=social\u0026label=Follow\" /\u003e\u003c/a\u003e\n\n# Steppers\n\n## Screen\n\n\u003cimg src=\"https://drozdzynski.me/repo/steppers/screen.gif\" /\u003e\n\n## Setup\n\n### 1. Add library to project\n\n#### Grab via Gradle:\n```groovy\ndependencies {\n    compile 'me.drozdzynski.library.steppers:steppers:1.0.0'\n}\n```\n\n#### Manual\n* Download the library folder.\n* Copy to root project folder\n* Add to your settings.gradle file the following code line: \"include ':app', ':steppers'\"\n* Rebuild the project\n* Add dependency\n    * File → Project Structure\n    * in Modules section click on \"app\"\n    * Click on tab \"Dependecies\"\n    * Click on the green plus\n    * Module Dependecy\n    * Select \":library\"\n* Done\n\n### 2. Add view in XML Layout\n```xml\n\u003cme.drozdzynski.library.steppers.SteppersView\n    android:id=\"@+id/steppersView\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"match_parent\"/\u003e\n```\n\n### 3. Setup config for SteppersView\n```java\nSteppersView.Config steppersViewConfig = new SteppersView.Config();\nsteppersViewConfig.setOnFinishAction(new OnFinishAction() {\n    @Override\n    public void onFinish() {\n        // Action on last step Finish button\n    }\n});\n\nsteppersViewConfig.setOnCancelAction(new OnCancelAction() {\n    @Override\n    public void onCancel() {\n        // Action when click cancel on one of steps\n    }\n});\n\nsteppersViewConfig.setOnChangeStepAction(new OnChangeStepAction() {\n    @Override\n    public void onChangeStep(int position, SteppersItem activeStep) {\n        // Action when click continue on each step\n    }\n});\n\n// Setup Support Fragment Manager for fragments in steps\nsteppersViewConfig.setFragmentManager(getSupportFragmentManager());\n```\n\n### 4. Create steps list\n```java\nArrayList\u003cSteppersItem\u003e steps = new ArrayList\u003c\u003e();\n\nSteppersItem stepFirst = new SteppersItem();\n\nstepFirst.setLabel(\"Title of step\");\nstepFirst.setSubLabel(\"Subtitle of step\");\nstepFirst.setFragment(new SomeFragment());\nstepFirst.setPositiveButtonEnable(false);\n\nsteps.add(stepFirst);\n```\n\n### 5. Set config, list and build view;\n```java\nSteppersView steppersView = (SteppersView) findViewById(R.id.steppersView);\nsteppersView.setConfig(steppersViewConfig);\nsteppersView.setItems(steps);\nsteppersView.build();\n```\n\n## Other functions\n\n### Enable skip step button\nSimple:\n```java\nitem.setSkippable(true);\n```\n\nWith callback:\n```java\nitem.setSkippable(true, new OnSkipStepAction() {\n    @Override\n    public void onSkipStep() {\n        // Some action after step is skipped\n    }\n});\n```\n\n### Override continue button\n```java\nitem.setOnClickContinue(new OnClickContinue() {\n    @Override\n    public void onClick() {\n        // Some action on click\n        \n        steppersView.nextStep(); // Now You must call next step\n    }\n});\n```\n\n### Change active step\n```java\nsteppersView.setActiveItem(1); // step index from 0 \n```\n\n### Disable cancel button (hide)\n```java\nsteppersViewConfig.setCancelAvailable(false);\n```\n\n## License\n```\nCopyright (C) 2015-2017 Krystian Drożdżyński\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n     http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrozdzynski%2FSteppers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrozdzynski%2FSteppers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrozdzynski%2FSteppers/lists"}