{"id":13418825,"url":"https://github.com/Todd-Davies/ProgressWheel","last_synced_at":"2025-03-15T04:30:48.656Z","repository":{"id":2388437,"uuid":"3354338","full_name":"Todd-Davies/ProgressWheel","owner":"Todd-Davies","description":"A progress wheel for android, intended for use instead of the standard progress bar.","archived":false,"fork":false,"pushed_at":"2019-11-02T16:26:54.000Z","size":384,"stargazers_count":2647,"open_issues_count":9,"forks_count":710,"subscribers_count":147,"default_branch":"master","last_synced_at":"2024-07-31T22:44:16.305Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Todd-Davies.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-02-04T18:13:30.000Z","updated_at":"2024-07-13T15:50:43.000Z","dependencies_parsed_at":"2022-09-09T16:00:11.070Z","dependency_job_id":null,"html_url":"https://github.com/Todd-Davies/ProgressWheel","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Todd-Davies%2FProgressWheel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Todd-Davies%2FProgressWheel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Todd-Davies%2FProgressWheel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Todd-Davies%2FProgressWheel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Todd-Davies","download_url":"https://codeload.github.com/Todd-Davies/ProgressWheel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243685505,"owners_count":20330980,"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-07-30T22:01:07.568Z","updated_at":"2025-03-15T04:30:48.651Z","avatar_url":"https://github.com/Todd-Davies.png","language":"Java","funding_links":[],"categories":["Java","进度条","Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"![Project frozen](https://img.shields.io/badge/status-frozen-blue.png) ![Project unmaintained](https://img.shields.io/badge/project-unmaintained-red.svg)\n\n\nDeprecation warning\n===================\n\nThis project is no-longer maintained, and has not been maintained for a few years now. If you're looking for an alternative library, consider the below options:\n\n- https://github.com/pnikosis/materialish-progress\n- https://github.com/ybq/Android-SpinKit\n- https://github.com/zekapp/Android-ProgressViews\n\nIf, on the other hand, you'd like to take over maintinance of the project or modernise it, feel free to do so; just send me pull requests or an email (at todd434@gmail.com).\n\nProgress Wheel\n=============\n\nThis is a custom component for Android intended for use instead of a progress bar.\n\n![Sample Image](https://github.com/Todd-Davies/ProgressWheel/raw/master/sample_image.png \"An example implementation\")\n![Sample Image 3](https://github.com/Todd-Davies/ProgressWheel/raw/master/sample_image_3.png \"Another example implementation\")\n![Sample Image 4](https://github.com/Todd-Davies/ProgressWheel/raw/master/sample_image_4.png \"Another example implementation\")\n\nCompare it side by side with the Android 2x progress wheel:\n\n![Sample Image 5](https://github.com/Todd-Davies/ProgressWheel/raw/master/sample_image5.png \"Side by side comparison\")\n\nA complete walkthrough of how to use this component in your app\n-------------\n\n**XML:**   \nTo implement the view in your xml layout do the following:\n\n1. Add the following to your attrs.xml file (in res/values):\n``` xml\n\u003cdeclare-styleable name=\"ProgressWheel\"\u003e\n        \u003cattr name=\"pwText\" format=\"string\" /\u003e\n        \u003cattr name=\"pwTextColor\" format=\"color\" /\u003e\n        \u003cattr name=\"pwTextSize\" format=\"dimension\" /\u003e\n        \u003cattr name=\"pwBarColor\" format=\"color\" /\u003e\n        \u003cattr name=\"pwRimColor\" format=\"color\" /\u003e\n        \u003cattr name=\"pwRimWidth\" format=\"dimension\" /\u003e\n        \u003cattr name=\"pwSpinSpeed\" format=\"dimension\" /\u003e\n        \u003cattr name=\"pwDelayMillis\" format=\"integer\" /\u003e\n        \u003cattr name=\"pwCircleColor\" format=\"color\" /\u003e\n        \u003cattr name=\"pwRadius\" format=\"dimension\" /\u003e\n        \u003cattr name=\"pwBarWidth\" format=\"dimension\" /\u003e\n        \u003cattr name=\"pwBarLength\" format=\"dimension\" /\u003e\n        \u003cattr name=\"pwContourColor\" format=\"color\"/\u003e\n        \u003cattr name=\"pwContourSize\" format=\"dimension\"/\u003e\n\u003c/declare-styleable\u003e\n```\n\n2. Add the following code to the root view of your layout:\n`xmlns:ProgressWheel=\"http://schemas.android.com/apk/res/com.visualdenim.schooltraq\"`\n\n3. Add the widget code in the appropriate place in your xml file. Here's a sample implementation:\n``` xml\n\u003ccom.todddavies.components.progressbar.ProgressWheel   \n    android:id=\"@+id/pw_spinner\"     \n    android:layout_width=\"200dp\"    \n    android:layout_height=\"200dp\"   \n    android:layout_centerInParent=\"true\"   \n    ProgressWheel:pwText=\"Authenticating...\"    \n    ProgressWheel:pwTextColor=\"#222\"   \n    ProgressWheel:pwTextSize=\"14sp\"   \n    ProgressWheel:pwRimColor=\"#330097D6\"   \n    ProgressWheel:pwBarLength=\"60dp\"    \n    ProgressWheel:pwBarColor=\"#0097D6\"   \n    ProgressWheel:pwBarWidth=\"5dp\"   \n    ProgressWheel:pwRimWidth=\"2dp\" /\u003e \n```\n\t\n**Java:**   \nFirst you need to either get a ProgressWheel from a layout file, or initalise one. Do this by:\n\n-  `ProgressWheel pw = new ProgressWheel(myContext, myAttributes);`\n-  `ProgressWheel pw = (ProgressWheel) findViewById(R.id.pw_spinner);`\n\nTo spin the progress wheel, you just call .`startSpinning()` and to stop it spinning, you call `.stopSpinning()`\n\nIncrementing the progress wheel is slightly more tricky, you call `.incrementProgress()`. However, this is out of 360,  \n(because a circle has 360 degrees), and will automatically reset once you get past 360. A percentage display is   \nautomatically displayed.\n\nUsing as a dependency\n--------------------------\n\nAdd this to your build.gradle:\n\n```gradle\n\trepositories {\n\t    maven { url \"https://jitpack.io\" }\n\t}\n\t\n\tdependencies {\n\t    compile 'com.github.Todd-Davies:ProgressWheel:1.2'\n\t}\n```\n\nUsing as a library project\n--------------------------\n\nTo use it as a library in Android Studio, please edit build.gradle.\n\nModify:\n\n    apply plugin: 'android'\n\nInto:\n\n    apply plugin: 'android-library'\n\nSince Android SDK Tools revision 17 (released March 2012), this component can\nbe used as a library project. In this case, you do *not* need to copy anything\ninto your project's attrs.xml, and you must use the following namespace URI,\ninstead of the above:\n\n`xmlns:ProgressWheel=\"http://schemas.android.com/apk/res-auto\"`\n\nOtherwise, usage should be the same.\n\n\n[Todd Davies](http://todddavies.co.uk) - [@Todd__Davies](http://twitter.com/todd__davies) - 2012\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTodd-Davies%2FProgressWheel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTodd-Davies%2FProgressWheel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTodd-Davies%2FProgressWheel/lists"}