https://github.com/milosmns/circular-slider-android
Circular Slider UI Control for Android
https://github.com/milosmns/circular-slider-android
android border circle java round seek slider thumb
Last synced: 5 months ago
JSON representation
Circular Slider UI Control for Android
- Host: GitHub
- URL: https://github.com/milosmns/circular-slider-android
- Owner: milosmns
- License: gpl-3.0
- Archived: true
- Created: 2015-03-25T22:46:23.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2017-04-07T11:27:54.000Z (about 8 years ago)
- Last Synced: 2024-05-01T15:28:55.017Z (12 months ago)
- Topics: android, border, circle, java, round, seek, slider, thumb
- Language: Java
- Homepage:
- Size: 904 KB
- Stars: 307
- Watchers: 9
- Forks: 53
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-ui - https://github.com/milosmns/circular-slider-android
- awesome-android-ui - https://github.com/milosmns/circular-slider-android
README
Circular Slider
===============
[](http://androidweekly.net/issues/issue-184)
[](http://android-arsenal.com/details/1/3417)
What is this?
-------------
Circular Slider is a custom-built Android View used for choosing numbers. It works similarly to the regular slider control (SeekBar), just goes around in a circular fashion - simple enough.
**Note** that the thumb scroller (the thing you drag around) can be either a solid-color circle or a custom drawable (like a PNG image).
Requirements
------------
- Android 3.0 or later (Minimum SDK level 11)
- Android Studio (to compile and use)
- **Eclipse is not supported**
Getting Started
---------------
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio
1. Start your new project
1. Open your project's main Gradle file, in root directory (**/build.gradle**)
1. Make sure you are using **jcenter()** in the repository block (**mavenCentral()** should work too)
1. Open your app module Gradle file, for example **/app/build.gradle**
1. In **dependencies** block, add the following line: `compile 'me.angrybyte.slider:slider:1.4.2'`
1. Click **Tools/Android/Sync Project with Gradle Files** or click on the *Sync* icon in the top toolbar
1. Click **Run/Run 'app'** to see if it's resolved correctly
This will run the app on your device. You may need to download a newer version of Gradle, which will be available in the Android Studio UI if compile fails.
What does it look like?
----------------------
A dark variant
Sample usage
------------
```xml
```
Explanation of attributes
-------------------------
Here are some short explanations for the attributes provided by the view. You can leave out any of them, values will get set to default ones.
- `angle`: (**float**) The current position of the slider thumb, a pi-based value of the angle (radians).
- `start_angle`: (**float**) The starting position of the slider thumb, a pi-based valued of the angle (radians).
- `border_thickness`: (**dimension**) How thick should the slider border be (this can be a 0-dimension).
- `border_color`: (**color**) Recolors the slider border to the specified color.
- `border_gradient_colors`: (**string**) Creates a gradient on the slider's circular edge. Format: "#f05151;#4a90e2;#4a90e2"
- `thumb_size`: (**dimension**) Radius of the slider thumb (thumb is the slider's movable part).
- `thumb_image`: (**reference**) Set this to use an image instead of a colored circle for the slider thumb.
- `thumb_color`: (**color**) Set this to use a colored circle instead of an image for the slider thumb.
**Note** that `thumb color` and `thumb image` are mutually exclusive, you can't use both.
Support
-------
If you've found an error while using the library, please [file an issue](https://github.com/milosmns/circular-slider-android/issues/new).
All patches are encouraged, and may be submitted by [forking this project](https://github.com/milosmns/circular-slider-android/fork) and
submitting a pull request through GitHub.
Some more help can be found here:
- StackOverflow [here](http://stackoverflow.com/questions/tagged/circular-slider-android) or [here](http://stackoverflow.com/questions/tagged/circular-slider)
- [On my blog](http://angrybyte.me)