mmoamenn / LuckyWheel_Android

A custom component that displays a lucky wheel. it ⁠ features easy customize of colors, addition of items and it's very trivial to integrate in your application.
MIT License
127 stars 55 forks source link
android library ui

LuckyWheel Android

Android custom component that displays a lucky wheel. it features easy customize of colors , text and addition of items and it's very trivial to integrate in your application.

What's new in 0.3.0

Overview

The LuckyWheel shows a wheel which can spin, and a marker that indicates the selected item in the wheel. Items may be customized with text, image, or a color.

The wheel starts off stationary. Calling the setTarget() method with an integer parameter will set the wheel to spin to that section when the user taps the wheel in the UI. Calling rotateWheelTo() with an integer parameter will cause the wheel to spin to that section immediately.

The wheel spins for a few seconds, then fires the setLuckyWheelReachTheTarget callback to notify the application it has stopped moving.

Installing

Add it in your root build.gradle at the end of repositories:

    allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

Step 2. Add the dependency

  dependencies {
        implementation 'com.github.mmoamenn:LuckyWheel_Android:0.3.0'
    }

XML

<com.bluehomestudio.luckywheel.LuckyWheel
        android:id="@+id/lwv"
        android:layout_width="250dp"
        android:layout_height="250dp"
        android:layout_centerInParent="true"
        LuckyWheel:background_color="@color/colorPrimary" />

You must use the following properties in your XML

Choose the background color

LuckyWheel:background_color

Choose wheel image arrow

LuckyWheel:arrow_image

Change item image padding

LuckyWheel:image_padding

Kotlin

Functions to use after reference the Lucky wheel

Note

Last version before support AndroidX com.github.mmoamenn:LuckyWheel_Android:0.1.2