Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hamzaghazouani/hgrippleradarview
A beautiful radar view to show nearby items (users, restaurants, ...) with ripple animation, fully customizable
https://github.com/hamzaghazouani/hgrippleradarview
animation loading location near nearby pulse radar radarview ripple uiview wave
Last synced: 1 day ago
JSON representation
A beautiful radar view to show nearby items (users, restaurants, ...) with ripple animation, fully customizable
- Host: GitHub
- URL: https://github.com/hamzaghazouani/hgrippleradarview
- Owner: HamzaGhazouani
- License: mit
- Created: 2018-01-28T23:51:36.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-10-13T20:27:29.000Z (about 5 years ago)
- Last Synced: 2024-11-07T01:02:45.194Z (8 days ago)
- Topics: animation, loading, location, near, nearby, pulse, radar, radarview, ripple, uiview, wave
- Language: Swift
- Homepage:
- Size: 15 MB
- Stars: 382
- Watchers: 12
- Forks: 46
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# HGRippleRadarView
[](https://travis-ci.org/HamzaGhazouani/HGRippleRadarView)
[](http://cocoapods.org/pods/HGRippleRadarView)
[](http://cocoapods.org/pods/HGRippleRadarView)
[]()
[]()
[](http://cocoapods.org/pods/HGRippleRadarView)
[](https://twitter.com/GhazouaniHamza)
[](https://hamzaghazouani.github.io/HGRippleRadarView/)
[](http://clayallsopp.github.io/readme-score?url=https://github.com/hamzaghazouani/hgrippleradarview)
## Example
  
To run the example project, clone the repo, and run `pod install` from the Example directory first.
This project is inspired by: https://dribbble.com/shots/2242921-Find-Nearby-Users-Concept
## Requirements
- iOS 8.0+
- Xcode 9.2
## You also may like
* **[HGCircularSlider](https://github.com/HamzaGhazouani/HGCircularSlider)** - A custom reusable circular slider control for iOS application.
* **[HGPlaceholders](https://github.com/HamzaGhazouani/HGPlaceholders)** - Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project Edit
## Installation
HGRippleRadarView is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'HGRippleRadarView'
```
HGRippleRadarView is also available through [Carthage](https://github.com/Carthage/Carthage). To install
it, simply add the following line to your Cartfile:
``` ruby
github "HamzaGhazouani/HGRippleRadarView"
```
## Usage
1. Change the class of a view from UIView to RippleView or RadarView
2. Programmatically:
```
let rippleView = RippleView(frame: myFrame)
```
```
let radarView = RadarView(frame: myFrame)
```
## Customization
#### RippleView
##### diskRadius
The radius of the central disk in the view, if you would like to hide it, you can set the radius to 0
##### diskColor
The color of the central disk in the view, the default color is ripplePink color
##### minimumCircleRadius
This property make distance between the first circle and the central disk
##### numberOfCircles
The number of circles to draw around the disk, the default value is 3
##### paddingBetweenCircles
The padding between circles, circles could be drawn outside the frame
##### circleOffColor
The color of the off status of the circle, used for animation
##### circleOnColor
The color of the on status of the circle, used for animation
##### animationDuration
The duration of the animation, the default value is 0.9
You can start/ stop the animation at any time by calling `startAnimation()` & `stopAnimation()`
#### RadarView
##### paddingBetweenItems
The padding between items, the default value is 10
#### Add items
If you would like to add one item, use the method `add(item:using:)`
If you would like to add multiple items, it's recommended to use the method `add(items:using:)`
#### remove item
If you would like to remove an item, use the method `remove(item:)`
#### Custom item
If you would like to customize items, use the protocol `RadarViewDataSource` and implement:
```
radarView?.dataSource = self
...
func radarView(radarView: RadarView, viewFor item: Item, preferredSize: CGSize) -> UIView {
let myCustomItemView = UIView(frame: CGRect(x: 0, y: 0, width: preferredSize.width, height: preferredSize.height))
return myCustomItemView
}
```
#### CallBack
If you would like to receive action on items, use the protocol `RadarViewDelegate` and implement:
```
radarView?.delegate = self
...
func radarView(radarView: RadarView, didSelect item: Item) {
print(item.uniqueKey)
}
```
## Documentation
Full documentation is available on [CocoaDocs](http://cocoadocs.org/docsets/HGRippleRadarView/).
You can also install documentation locally using [jazzy](https://github.com/realm/jazzy).
## Author
HamzaGhazouani, [email protected]
## License
HGRippleRadarView is available under the MIT license. See the LICENSE file for more info.