{"id":13604515,"url":"https://github.com/lalongooo/rings","last_synced_at":"2025-04-12T02:30:51.786Z","repository":{"id":70206312,"uuid":"125779321","full_name":"lalongooo/rings","owner":"lalongooo","description":"A simple chart for Android with three indicators and one more to indicate overall summary. They get highlighted if you click on the ring or text.","archived":false,"fork":false,"pushed_at":"2025-02-19T04:52:54.000Z","size":3072,"stargazers_count":167,"open_issues_count":3,"forks_count":21,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-19T10:52:23.944Z","etag":null,"topics":["android","chart"],"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/lalongooo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-03-19T00:04:40.000Z","updated_at":"2025-02-19T04:52:58.000Z","dependencies_parsed_at":"2023-03-01T00:46:04.900Z","dependency_job_id":null,"html_url":"https://github.com/lalongooo/rings","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lalongooo%2Frings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lalongooo%2Frings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lalongooo%2Frings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lalongooo%2Frings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lalongooo","download_url":"https://codeload.github.com/lalongooo/rings/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248506901,"owners_count":21115503,"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","chart"],"created_at":"2024-08-01T19:00:47.124Z","updated_at":"2025-04-12T02:30:50.563Z","avatar_url":"https://github.com/lalongooo.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"[![Android Arsenal]( https://img.shields.io/badge/Android%20Arsenal-Rings-green.svg?style=flat )]( https://android-arsenal.com/details/1/6871 )\n\n# Android Rings\nA simple chart for Android with three indicators and one more to indicate overall summary.\nThey get highlighted if you click on the ring or text.\n\n![Rings Demo](https://i.imgur.com/Khwxkyi.png)\n\n# Setup\n## 1. Provide the gradle dependency\n\nAdd the gradle dependency to your `app` module `build.gradle` file:\n\n```\ndependencies {\n    compile 'com.lalongooo:rings:1.0.0'\n}\n```\n\n## 2. Add the `Rings` custom view to your layout xml file\n\nMake sure `layout_width` and `layout_height` are equal so rings can be a perfect circle inside a square, otherwise\nit'd look like an ellipse inside a rectangle.\n\n``` xml\n\u003ccom.lalongooo.Rings\n    android:id=\"@+id/rings\"\n    android:layout_width=\"200dp\"\n    android:layout_height=\"200dp\" /\u003e\n```\n\n## 3. Add the custom attributes as needed\n\n\nText size. Default is `18sp`.\n\n``` xml\napp:rings_text_size\n```\n\nMargin left of the text. Default is `10dp`.\n\n``` xml\napp:rings_text_margin_left\n```\n\nThe three inner rings stroke width. Default is `8dp`.\n\n``` xml\napp:rings_inner_stroke_width\n```\n\nThe three inner rings stroke width when unfinished or incomplete, if value is the same as `app:rings_inner_stroke_width`, it will be invisible. Default is `10dp`.\n\n``` xml\napp:rings_inner_stroke_width_unfinished\n```\n\nThe outer ring stroke width. Default is `12dp`.\n\n``` xml\napp:rings_outer_stroke_width\n```\n\nThe outer ring stroke width when unfinished or incomplete, if value is the same as `app:rings_outer_stroke_width_unfinished`, it will be inviisble. Default is `12dp`.\n\n``` xml\napp:rings_outer_stroke_width_unfinished\n```\n\nDefault unfinished/incomplete background color for all rings.\n\n``` xml\napp:rings_unfinished_color\n```\n\nDefault finished/progress color for all the inner rings. It is overriden by  `app:rings_inner_first_color`, `app:rings_inner_second_color`, `app:rings_inner_third_color` when specified.\n\n``` xml\napp:rings_default_filled_color\n```\n\nFinished/progress color of the first inner ring.\n\n``` xml\napp:rings_inner_first_color\n```\n\nFinished/progress color of the second inner ring.\n\n``` xml\napp:rings_inner_second_color\n```\n\nFinished/progress color of the third inner ring.\n\n``` xml\napp:rings_inner_third_color\n```\n\nFinished/progress color of the outer ring.\n\n``` xml\napp:rings_overall_color\n```\n\nProgress of the first inner ring. Between 0 and 100. Default is 0.\n\n``` xml\napp:rings_inner_first_progress\n```\n\nProgress of the second inner ring. Between 0 and 100. Default is 0.\n\n``` xml\napp:rings_inner_second_progress\n```\n\nProgress of the third inner ring. Between 0 and 100. Default is 0.\n\n``` xml\napp:rings_inner_third_progress\n```\n\nProgress of the outer ring. Between 0 and 100. Default is 0.\n\n``` xml\napp:rings_overall_progress\n```\n\nText of the first inner ring.\n\n``` xml\napp:rings_inner_first_text\n```\n\nText of the second inner ring.\n\n``` xml\napp:rings_inner_second_text\n```\n\nText of the third inner ring.\n\n``` xml\napp:rings_inner_third_text\n```\n\nText of the outer ring.\n\n``` xml\napp:rings_overall_text\n```\n\n## Example\n\n``` xml\n\u003ccom.lalongooo.Rings\n    android:id=\"@+id/rings\"\n    android:layout_width=\"200dp\"\n    android:layout_height=\"200dp\"\n    app:rings_inner_first_color=\"#FF9F1C\"\n    app:rings_inner_first_progress=\"30\"\n    app:rings_inner_first_text=\"Java\"\n    app:rings_inner_second_color=\"#4BC6B9\"\n    app:rings_inner_second_progress=\"75\"\n    app:rings_inner_second_text=\"Kotlin\"\n    app:rings_inner_third_color=\"#757780\"\n    app:rings_inner_third_progress=\"85\"\n    app:rings_inner_third_text=\"Android\"\n    app:rings_overall_color=\"#EA3546\"\n    app:rings_overall_progress=\"100\"\n    app:rings_overall_text=\"Overall\"\n    app:rings_text_size=\"20sp\"\n    app:rings_unfinished_color=\"#f2f2f2\" /\u003e\n```\n\n### Result\n\n![Rings Example](https://i.imgur.com/BoP3tIy.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flalongooo%2Frings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flalongooo%2Frings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flalongooo%2Frings/lists"}