Skip to content

Fortune spinning wheel library built using SwiftUI, supports dynamic content.

License

Notifications You must be signed in to change notification settings

sameersyd/FortuneWheel

Repository files navigation

CI Status Version License Platform

GitHub Cards Preview

Fortune Wheel

Fortune spinning wheel 🎡 library built using SwiftUI, supports dynamic content.


Preview - Spin Wheel ⚙️

gif


CocoaPods Installation

FortuneWheel is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'FortuneWheel'

Swift Package Manager

dependencies: [
    .package(url: "https://github.com/sameersyd/FortuneWheel.git", .upToNextMajor(from: "0.1.5"))
]

Sample Code 🌟

Import Fortune Wheel in your file.

import FortuneWheel

Create a FortuneWheelModel and pass it to the view.

struct ContentView: View {

    private var players = ["Sameer", "Spikey", "Amelia", "Danny", "Karen", "Kathy"]
    
    var body: some View {
        let model = FortuneWheelModel(
            titles: players, size: 320,
            onSpinEnd: onSpinEnd,
            getWheelItemIndex: getWheelItemIndex
        )
        ZStack {
            FortuneWheel(model: model)
        }
    }

    private func onSpinEnd(index: Int) {
        // your action here - based on index
    }

    private func getWheelItemIndex() -> Int {
        return getIndexFromAPI()
    }
}

Note:

When custom animation is used, provide it's duration in animDuration parameter

Change the animDuration only if custom animation is used, or it may cause delay in pointer result.

Function getWheelItemIndex will be called everytime wheel is spinned. If it's nil or provides invalid index, random element will be selected.


Fortune Wheel properties

Parameter Optional Type Default Value
titles false [String] nil
size false CGFloat nil
onSpinEnd false (Int) -> () nil
colors true [Color] Color hex ["FBE488", "75AB53", "D1DC59", "EC9D42", "DE6037", "DA4533", "992C4D", "433589", "4660A8", "4291C8"]
pointerColor true Color Color(hex: "DA4533")
strokeWidth true CGFloat 15
strokeColor true Color Color(hex: "252D4F")
animDuration true Double 6
animation true Animation Animation.timingCurve(0.51, 0.97, 0.56, 0.99, duration: 6)
getWheelItemIndex true () -> (Int) nil

UI Design 🎨

The UI for this Fortune Wheel library was designed by @Spikeysanju


Contribute

If you want to contribute to this app, you're always welcome! See Contributing Guidelines.


Donation

If this project helped you reduce time to develop, you can buy me a cup of coffee :)

Buy Me A Coffee


Author

Sameer Nawaz, [email protected]


License

    Apache 2.0 License


    Copyright 2021 Sameer Nawaz

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.