Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/szugyi/Android-CircleMenu
Menu with items on a rotating circle
https://github.com/szugyi/Android-CircleMenu
Last synced: about 6 hours ago
JSON representation
Menu with items on a rotating circle
- Host: GitHub
- URL: https://github.com/szugyi/Android-CircleMenu
- Owner: szugyi
- License: other
- Created: 2013-03-10T14:39:03.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-01-30T10:04:48.000Z (almost 2 years ago)
- Last Synced: 2024-11-06T22:43:33.734Z (14 days ago)
- Language: Java
- Homepage:
- Size: 2.08 MB
- Stars: 298
- Watchers: 28
- Forks: 112
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-android-ui - https://github.com/szugyi/Android-CircleMenu
- awesome-android-ui - https://github.com/szugyi/Android-CircleMenu
README
Circle Menu
==========
This is a simple implementation of a circle menu for Android applications.
Deprecated
-----------
ConstraintLayout 1.1.0 is now supporting [circular positioning](https://developer.android.com/reference/android/support/constraint/ConstraintLayout.html#CircularPositioning), which makes the use of this library deprecated.
Screenshots
-----------
[](#Screenshot)
Download
-----------
Grab via Maven
```xml
com.github.szugyi
Android-CircleMenu
2.0.0
```
or Gradle:
```groovy
compile 'com.github.szugyi:Android-CircleMenu:2.0.0'
```
Snapshots of the development version are available in [Sonatype's `snapshots` repository](https://oss.sonatype.org/content/repositories/snapshots/).
Android-CircleMenu requires Android 4.0.
Attributes
-----------
* `firstChildPosition` ([`East`, `South`, `West`, `North`]) - The angle where the first child of the CircleLayout will be put. Possible values are: `East` - to the right, `South` - to the bottom, `West` - to the left, `North` - to the top. Default: `South`
* `isRotating` (boolean) - Determines wether the child views are rotatable or not. Default: true
* `speed` (integer) - You can set the speed of the rotation. NOTE: The higher the value, the faster the rotation. It must be greater than 0. Values between 10 - 100 should work well. Default: 25
* `radius` (dimension) - The radius of the circle can be defined using dps or pixels.
EventListeners
--------------
* `OnItemClickListener` - Called when a child view is tapped. If the `isRotating` attribute is set to true, then called only if the tapped view is already on the `firstChildPosition`.
* `OnItemSelectedListener` - If the `isRotating` attribute is set to true, then it is called when the view is rotated to the `firstChildPosition`. Otherwise it is called with the `OnItemClickListener` when the child is tapped.
* `OnCenterClickListener` - Called when the center of the CircleLayout is tapped.
* `OnRotationFinishedListener` - If the `isRotating` attribute is set to true, then it is called when the rotation is finished, and passes the view which is on the `firstChildPosition`. Otherwise it is never called.
Changelog
---------
Description about the changes made to each version of the project can be found in the [CHANGELOG.md](./CHANGELOG.md) file.
Credits
-------
Special thanks to [Balázs Varga](https://github.com/warnyul), who helped me during the implementation of this custom view.
A lot of code snippets have been used from this great tutorial:
http://mobile.tutsplus.com/tutorials/android/android-sdk-creating-a-rotating-dialer/
The icons used in the example app are from:
http://flaticons.net/