{"id":13396327,"url":"https://github.com/tangqi92/WaveLoadingView","last_synced_at":"2025-03-13T22:32:11.704Z","repository":{"id":47372151,"uuid":"48028229","full_name":"tangqi92/WaveLoadingView","owner":"tangqi92","description":" An Android library providing to realize wave loading effect.","archived":false,"fork":false,"pushed_at":"2022-10-15T19:47:40.000Z","size":6309,"stargazers_count":1730,"open_issues_count":33,"forks_count":313,"subscribers_count":44,"default_branch":"master","last_synced_at":"2024-10-08T10:51:29.978Z","etag":null,"topics":["android-library","loading","loading-animations","waveview"],"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/tangqi92.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}},"created_at":"2015-12-15T07:58:57.000Z","updated_at":"2024-09-20T12:31:10.000Z","dependencies_parsed_at":"2023-01-20T04:04:33.935Z","dependency_job_id":null,"html_url":"https://github.com/tangqi92/WaveLoadingView","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/tangqi92%2FWaveLoadingView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangqi92%2FWaveLoadingView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangqi92%2FWaveLoadingView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangqi92%2FWaveLoadingView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tangqi92","download_url":"https://codeload.github.com/tangqi92/WaveLoadingView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243494345,"owners_count":20299802,"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-library","loading","loading-animations","waveview"],"created_at":"2024-07-30T18:00:44.990Z","updated_at":"2025-03-13T22:32:11.040Z","avatar_url":"https://github.com/tangqi92.png","language":"Java","readme":"# WaveLoadingView\n\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-WaveLoadingView-green.svg?style=true)](https://android-arsenal.com/details/1/2908)\n[![License](https://img.shields.io/badge/license-Apache%202-green.svg)](https://www.apache.org/licenses/LICENSE-2.0)  \n\n**WaveLoadingView** - An Android library that provides a realistic wave-loading effect.\n\n## Sample\n\n\u003cimg src=\"http://7xikfc.com1.z0.glb.clouddn.com/waveloadingview.png\" alt=\"sample\" title=\"sample\" width=\"400\" height=\"680\" /\u003e\n\n\n\n## Usage\n\n**For a working implementation of this project see the `sample/` folder.**\n\n### Step 1\n\nInclude the library as a local library project or add the dependency in your build.gradle.\n\n```groovy\ndependencies {\n    implementation 'me.itangqi.waveloadingview:library:0.3.5'\n    // I have uploaded v0.3.5 on 2017-01-06, if it doesn't take effect or your\n    // gradle cannot find it in maven central, you may try v0.3.4.\n}\n```\t\nOr\n\nImport the library, then add it to your /settings.gradle and /app/build.gradle. If you don't know how to do this, you can read my blog for help.\n\n### Step 2\n\nInclude the WaveLoadingView widget in your layout. And you can customize it like this.\n   \n```xml\n\u003cme.itangqi.waveloadingview.WaveLoadingView\n    android:id=\"@+id/waveLoadingView\"\n    android:layout_width=\"wrap_content\"\n    android:layout_height=\"wrap_content\"\n    app:wlv_borderColor=\"@color/colorAccent\"\n    app:wlv_borderWidth=\"3dp\"\n    app:wlv_progressValue=\"40\"\n    app:wlv_shapeType=\"circle\"\n    app:wlv_round_rectangle=\"true\"\n    app:wlv_triangle_direction=\"north\"\n    app:wlv_titleCenterStrokeColor=\"@android:color/holo_blue_dark\"\n    app:wlv_titleCenterStrokeWidth=\"3dp\"\n    app:wlv_titleCenter=\"Center Title\"\n    app:wlv_titleCenterColor=\"@android:color/white\"\n    app:wlv_titleCenterSize=\"24sp\"\n    app:wlv_waveAmplitude=\"70\"\n    app:wlv_waveColor=\"@color/colorAccent\"/\u003e   \n```\n\n### Step 3\n\nYou can write some animation codes to the callbacks such as setOnCheckedChangeListener, onProgressChanged, etc in your Activity.\n\n\n```java\n    WaveLoadingView mWaveLoadingView = (WaveLoadingView) findViewById(R.id.waveLoadingView);\n    mWaveLoadingView.setShapeType(WaveLoadingView.ShapeType.CIRCLE);\n    mWaveLoadingView.setTopTitle(\"Top Title\");\n    mWaveLoadingView.setCenterTitleColor(Color.GRAY);\n    mWaveLoadingView.setBottomTitleSize(18);\n    mWaveLoadingView.setProgressValue(80);\n    mWaveLoadingView.setBorderWidth(10);\n    mWaveLoadingView.setAmplitudeRatio(60);\n    mWaveLoadingView.setWaveColor(Color.GRAY);\n    mWaveLoadingView.setBorderColor(Color.GRAY);\n    mWaveLoadingView.setTopTitleStrokeColor(Color.BLUE);\n    mWaveLoadingView.setTopTitleStrokeWidth(3);\n    mWaveLoadingView.setAnimDuration(3000);\n    mWaveLoadingView.pauseAnimation();\n    mWaveLoadingView.resumeAnimation();\n    mWaveLoadingView.cancelAnimation();\n    mWaveLoadingView.startAnimation();\n```\n\n## Customization\n\nPlease feel free to :)\n\n|name|format|description|\n|:---:|:---:|:---:|\n| wlv_borderWidth | dimension |Border width, default is 0\n| wlv_borderColor | color | Border color\n| wlv_progressValue | integer | Pprogress value, default is 50\n| wlv_shapeType | enum | Shape type, default is circle\n| wlv_triangle_direction | enum | Triangle direction, default is north\n| wlv_round_rectangle | boolean | Is round rectangle, default is false\n| wlv_round_rectangle_x_and_y | integer | Round Rectangle corners, default is 30\n| wlv_waveColor | color | Wave color\n| wlv_wave_background_Color | color | Wave background color\n| wlv_waveAmplitude | float | Wave amplitude\n| wlv_titleTop | string | Top title content, default is null\n| wlv_titleCenter | string | Center title content, default is null\n| wlv_titleBottom | string | Bottom title content, default is null\n| wlv_titleTopSize | dimension | Top title size, default is 18 \n| wlv_titleCenterSize | dimension | Center title size, default is 22\n| wlv_titleBottomSize | dimension | Bottom size, default is 18\n| wlv_titleTopColor | color | Top title color\n| wlv_titleCenterColor | color | Center title color \n| wlv_titleBottomColor | color | Bottom title color\n| wlv_titleTopStrokeColor | color | Top title stroke color \n| wlv_titleCenterStrokeColor | color | Center title stroke color \n| wlv_titleBottomStrokeColor | color | Bottom title stroke color\n| wlv_titleTopStrokeWidth | dimension | Top title stroke width \n| wlv_titleCenterStrokeWidth | dimension | Center title stroke width \n| wlv_titleBottomStrokeWidth | dimension | Bottom title stroke width  \n\n\n**All attributes have their respective getters and setters to change them at runtime.**\n\n\n## Change Log\n\n### 0.3.5（2017-01-06）\n\n#### Update:\n\n- Support change the frequency of the waves. [#13](https://github.com/tangqi92/WaveLoadingView/issues/13) / [#23](https://github.com/tangqi92/WaveLoadingView/issues/23)\n\n### 0.3.4（2017-01-05）\n\n#### Update:\n\n- Support pause/resume wave. [#28](https://github.com/tangqi92/WaveLoadingView/issues/28) / [#26](https://github.com/tangqi92/WaveLoadingView/issues/26)\n\n#### Plan:\n\n- Support change the frequency of the waves\n\n\n### 0.3.3（2016-10-14）\n\n### 0.3.2（2016-07-29）\n\n#### Update:\n\n- Support change the background of waveview [#18](https://github.com/tangqi92/WaveLoadingView/issues/18). [by GreatGarlic](https://github.com/GreatGarlic)\n\n### 0.3.1（2016-07-23）\n\n#### Update:\n\n- Added stroke feature to all titles. Strokes are disabled by default. [by shayanzoro](https://github.com/shayanzoro)\n\n### 0.3.0 (2016-06-07)\n\n#### Fixed bugs:\n\n- How to set match_parent width? [#12](https://github.com/tangqi92/WaveLoadingView/issues/12)\n\n### 0.2.3（2016-05-25）\n\n#### Update:\n\n- Support the `minSdkVersion` to 14 \n\n### 0.2.2（2016-05-23）\n\n#### Fixed bugs:\n\n- Default amplitude value [#12](https://github.com/tangqi92/WaveLoadingView/issues/12)\n\n### 0.2.1 (2016-05-21)\n\n#### Update:\n\n- Update more shape types like: Rectangle, Round Rectangle, Triangle...etc [#7](https://github.com/tangqi92/WaveLoadingView/issues/7)\n- Update `build.gradle`\n- Update Sample\n\n#### Plan:\n\n- Title position fit shape size\n\n### 0.2.0 (2016-02-17)\n\n#### Implemented enhancements:\n\n- Prefix the attributes with \"wlv\"\n\n#### Fixed bugs:\n\n- setProgressValue() increase doesn't conform to logic [#8](https://github.com/tangqi92/WaveLoadingView/issues/8)\n\n#### Update:\n\n- Update `build.gradle`\n- Update Sample\n\n### 0.1.5 (2016-01-14)\n\n#### Fixed bugs:\n\n- IllegalArgumentException: width and height must be \u003e 0 while loading Bitmap from View [#6](https://github.com/tangqi92/WaveLoadingView/issues/6)\n\n### 0.1.4 (2015-12-17)\n\n#### Fixed bugs:\n\n- setProgressValue() doesn't change the value of mProgressValue [#4](https://github.com/tangqi92/WaveLoadingView/issues/4)\n\n\n### 0.1.3\n\n#### Fixed bugs:\n\n- Attribute \"borderWidth\" has already been defined [#2](https://github.com/tangqi92/WaveLoadingView/issues/2)\n\n\n## Demo\n\n[Download](https://github.com/tangqi92/WaveLoadingView/releases/download/v0.2.1/sample-release-unsigned.apk)\n\n## Apps using the WaveLoadingView\n\nFeel free to send me new projects\n\n- [Easy Fit Calorie Counter](https://play.google.com/store/apps/details?id=com.marioherzberg.swipeviews_tutorial1)\n- [Kebthung](https://play.google.com/store/apps/details?id=skesw12.kebthung)\n\n\n## Community\n\nLooking for contributors, feel free to fork !\n\nTell me if you're using my library in your application, I'll share it in this README.\n\n\n## Thanks\n\nInspired by \n\n- [WaveView](https://github.com/gelitenight/WaveView) created by [gelitenight](https://github.com/gelitenight)\n- [CircularFillableLoaders](https://github.com/lopspower/CircularFillableLoaders) created by [lopspower](https://github.com/lopspower)\n\n\n## Contact Me\n\nBorn in 1992, now a student of Southeast University, master of Software Engineering. Loving technology, programming, reading and sports.\n\nI will graduate in June 2017, expect the internship or full-time job in Android or iOS.\n\nIf you have any questions or want to make friends with me, please feel free to contact me : [imtangqi#gmail.com](mailto:imtangqi@gmail.com \"Welcome to contact me\")\n\n\n## License\n\n    Copyright 2016 Qi Tang\n\n\tLicensed under the Apache License, Version 2.0 (the \"License\");\n\tyou may not use this file except in compliance with the License.\n\tYou may obtain a copy of the License at\n\n     http://www.apache.org/licenses/LICENSE-2.0\n\n\tUnless required by applicable law or agreed to in writing, software\n\tdistributed under the License is distributed on an \"AS IS\" BASIS,\n\tWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\tSee the License for the specific language governing permissions and\n\tlimitations under the License.\n\n","funding_links":[],"categories":["Index `(light-weight pages)`","进度条","Index"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangqi92%2FWaveLoadingView","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftangqi92%2FWaveLoadingView","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangqi92%2FWaveLoadingView/lists"}