HGRippleRadarView
A beautiful radar view to show nearby items (users, restaurants, ...) with ripple animation, fully customizable
Install / Use
/learn @HamzaGhazouani/HGRippleRadarViewREADME
HGRippleRadarView
Example

To run the example project, clone the repo, and run pod install from the Example directory first.
<br />
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 - A custom reusable circular slider control for iOS application.
- HGPlaceholders - Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project Edit
Installation
HGRippleRadarView is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'HGRippleRadarView'
HGRippleRadarView is also available through Carthage. To install it, simply add the following line to your Cartfile:
github "HamzaGhazouani/HGRippleRadarView"
Usage
- Change the class of a view from UIView to RippleView or RadarView
- 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

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.<br/> You can also install documentation locally using jazzy.
Author
HamzaGhazouani, hamza.ghazouani@gmail.com
License
HGRippleRadarView is available under the MIT license. See the LICENSE file for more info.
Related Skills
node-connect
354.3kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
112.3kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
354.3kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
354.3kQQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
