{"id":13604163,"url":"https://github.com/VictorAlbertos/BreadcrumbsView","last_synced_at":"2025-04-11T23:31:50.302Z","repository":{"id":85039958,"uuid":"70246650","full_name":"VictorAlbertos/BreadcrumbsView","owner":"VictorAlbertos","description":"A customizable Android view for paginated forms","archived":false,"fork":false,"pushed_at":"2020-08-09T10:03:01.000Z","size":137,"stargazers_count":681,"open_issues_count":1,"forks_count":101,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-01-08T09:02:22.942Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VictorAlbertos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2016-10-07T12:58:18.000Z","updated_at":"2024-10-18T14:35:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"972faf5a-9763-4e6e-a728-5e6c340cc5e2","html_url":"https://github.com/VictorAlbertos/BreadcrumbsView","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorAlbertos%2FBreadcrumbsView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorAlbertos%2FBreadcrumbsView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorAlbertos%2FBreadcrumbsView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VictorAlbertos%2FBreadcrumbsView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VictorAlbertos","download_url":"https://codeload.github.com/VictorAlbertos/BreadcrumbsView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248495011,"owners_count":21113546,"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":[],"created_at":"2024-08-01T19:00:40.903Z","updated_at":"2025-04-11T23:31:49.980Z","avatar_url":"https://github.com/VictorAlbertos.png","language":"Java","funding_links":[],"categories":["StepView","Java"],"sub_categories":[],"readme":"# BreadcrumbsView\n\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-BreadcrumbsView-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/4475)\n\nA customizable Android view which shows the current step of a given series. Its main purpose is to provide a contextual reference for paginated forms.\n\n![Screenshots](breadcrumbs.gif)\n\n## SetUp\n\nAdd to top level *gradle.build* file\n\n```gradle\nallprojects {\n    repositories {\n        maven { url \"https://jitpack.io\" }\n    }\n}\n```\n\nAdd to app module *gradle.build* file\n```gradle\ndependencies {\n    compile 'com.github.VictorAlbertos:BreadcrumbsView:0.0.4'\n}\n```\n\n## Usage\n\n### XML inflation\nDefine a `BreadcrumbsView` in xml layout as follows:\n\n```xml\n  \u003cio.victoralbertos.breadcumbs_view.BreadcrumbsView\n      android:id=\"@+id/breadcrumbs\"\n      android:layout_width=\"match_parent\"\n      android:layout_height=\"wrap_content\"\n      app:numberOfSteps=\"5\"\n      app:visitedStepBorderDotColor=\"@color/colorVisited\"\n      app:visitedStepFillDotColor=\"@color/colorVisited\"\n      app:nextStepBorderDotColor=\"@color/colorNext\"\n      app:nextStepFillDotColor=\"@color/colorNext\"\n      app:visitedStepSeparatorColor=\"@color/colorVisited\"\n      app:nextStepSeparatorColor=\"@color/colorNext\"\n      app:radiusDot=\"@dimen/radius_dot\"\n      app:sizeDotBorder=\"@dimen/size_dot_border\"\n      app:heightSeparator=\"@dimen/height_separator\"/\u003e\n ```\n \nAmong the previous custom attributes, only `app:numberOfSteps` is mandatory, requiring to be an integer value greater than 1.\n \n### Moving between steps\nOnce 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.\n\n### Survive config changes\nIn 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`.\n\n### Examples\nThe module [test-sample](https://github.com/VictorAlbertos/BreadcrumbsView/tree/master/test-sample) contains both a minimal example and a UI test driven by Espresso.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVictorAlbertos%2FBreadcrumbsView","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVictorAlbertos%2FBreadcrumbsView","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVictorAlbertos%2FBreadcrumbsView/lists"}