Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/sh-khashimov/SwiftFortuneWheel

The ultimate spinning wheel view that supports dynamic content and rich customization.
https://github.com/sh-khashimov/SwiftFortuneWheel

circle circular core-graphics dynamic fortune fortune-wheel ios lucky macos osx radial rotating sector slice spinning swift tvos uicontrol uiview wheel

Last synced: about 2 months ago
JSON representation

The ultimate spinning wheel view that supports dynamic content and rich customization.

Lists

README 

        



SwiftFortuneWheel



[![CI Status](https://img.shields.io/travis/sh-khashimov/SwiftFortuneWheel.svg?style=flat)](https://travis-ci.org/sh-khashimov/SwiftFortuneWheel)

[![Swift Version](https://img.shields.io/badge/Swift-5-orange.svg)]()

[![Version](https://img.shields.io/cocoapods/v/SwiftFortuneWheel.svg?label=version)](https://cocoapods.org/pods/SwiftFortuneWheel)

![Support](https://img.shields.io/badge/supports-SPM%2C%20CocoaPods-green.svg)

[![Platform](https://img.shields.io/cocoapods/p/SwiftFortuneWheel.svg?style=flat)](https://cocoapods.org/pods/SwiftFortuneWheel)

![Documentation](./docs/badge.svg?style=flat&sanitize=true)



The ultimate spinning wheel control that supports dynamic content and rich customization.



| | Main Features |

|---|---|

| 🏵 | Dynamic content, supports texts, images, and lines |

| 🎯 | Adaptive text size with support multiline, alignment and line break mode |

| 🎇 | Supports background Image for each Slice (sector) |

| 🧮 | Supports vertical and horizontal text orientation |

| 🌈 | Appearance customization |

| 🔊 | Sounds and haptic feedback |

| 🌋 | Collision callbacks and effects |

| 🎨 | Drawn and animated using CoreGraphics, CoreAnimations |

| 🔋 | High performance, low memory usage |



### Layout Preview









> _Taken from [example projects](/Examples)_



### Dynamic Content and Rotation Preview






> _Taken from [example projects](/Examples)_



### Collision Effect Preview






> _Taken from [example projects](/Examples)_



## Screenshots



  from iOS Example Project




- - -



  from macOS Example Project




- - -



  from tvOS Example Project




- - -



## Documentation



- [**Getting Started Guide**](/Documentation/GettingStarted.md)

- [**API Overview**](/Documentation/API_Overview.md)

- [**Configuration In-Depth**](/Documentation/Configuration_indepth.md)

- [**About Slice and Slice’s contents**](/Documentation/About_Slice_and_Slice_contents.md)

- [**Sound Effects and Impact Feedback**](/Documentation/sound_effects.md)

- [**pinImageView Collision effect and Collision Callbacks**](/Documentation/collision.md)

- [**About Port to Other Platforms**](/Documentation/Port_to_Other_Platforms.md)

- [**Example Projects**](/Examples)

## Installation



When you are ready to install, follow the [**Installation Guide**](/Documentation/Installation.md).



## API Documentation



You can find **the docs here**. 



Documentation is generated with [jazzy](https://github.com/realm/jazzy) and hosted on [GitHub-Pages](https://pages.github.com/).





## Requirements



| App name | Swift | Xcode | Platforms |

|---|---|---|---|

| 1.1.4 - current version | Swift 5.x | Xcode 14 | iOS 9.0 / macOS 10.13 / tvOS 9.0 |

| 1.1.x - 1.4.3 | Swift 5.0 | Xcode 11 | iOS 9.0 / macOS 10.11 / tvOS 9.0 |

| 0.x.x - 1.0.x | Swift 5.0 | Xcode 11 | iOS 9.0 |



## Migration



- [**from 1.1.x to 1.2.x**](/Documentation/Migrations/Migration_1.1.x_to_1.2.x.md)

- [**from 1.0.x to 1.1.x**](/Documentation/Migrations/Migration_1_to_1.x.md)

- [**from 0.x.x to 1.0.0**](/Documentation/Migrations/Migration_0_to_1.md)



## Changelog



See [**changelog here**](/Documentation/Changelog.md)



## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.



Please make sure to update tests as appropriate.



## Author



Sherzod Khashimov



## License

[MIT](https://choosealicense.com/licenses/mit/)