A beautiful radar view to show nearby items (users, restaurants, ...) with ripple animation, fully customizable

Overview

HGRippleRadarView

CI Status Version License Language Supports Platform

Twitter: @GhazouaniHamza Documentation Readme Score

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 - 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

  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.
You can also install documentation locally using jazzy.

Author

HamzaGhazouani, [email protected]

License

HGRippleRadarView is available under the MIT license. See the LICENSE file for more info.

You might also like...
Simple and highly customizable iOS tag list view, in Swift.
Simple and highly customizable iOS tag list view, in Swift.

TagListView Simple and highly customizable iOS tag list view, in Swift. Supports Storyboard, Auto Layout, and @IBDesignable. Usage The most convenient

Easy to use, highly customizable gauge view
Easy to use, highly customizable gauge view

GDGauge - Customizable Gauge View Requirements Xcode 11+ Swift 5 iOS 9+ Installation Swift Package Manager .package(url: "https://github.com/saeid/GDG

The CITPincode package provides a customizable pincode view
The CITPincode package provides a customizable pincode view

The CITPincode package provides a customizable pincode view. It includes an optional resend code button with a built-in cooldown and an optional divider to be placed anywhere between the cells.

TSnackBarView is a simple and flexible UI component fully written in Swift
TSnackBarView is a simple and flexible UI component fully written in Swift

TSnackBarView is a simple and flexible UI component fully written in Swift. TSnackBarView helps you to show snackbar easily with 3 styles: normal, successful and error

TDetailBoxView is a simple and flexible UI component fully written in Swift
TDetailBoxView is a simple and flexible UI component fully written in Swift

TDetailBoxView is a simple and flexible UI component fully written in Swift. TDetailBoxView is developed to help users quickly display the detail screen without having to develop from scratch.

TSwitchLabel is a simple and flexible UI component fully written in Swift.
TSwitchLabel is a simple and flexible UI component fully written in Swift.

TSwitchLabel is a simple and flexible UI component fully written in Swift. TSwitchLabel is developed for you to easily use when you need to design a UI with Label and Switch in the fastest way without having to spend time on develop from scratch.

Show progress in your app's Dock icon
Show progress in your app's Dock icon

DockProgress Show progress in your app's Dock icon This package is used in production by the Gifski app. You might also like some of my other apps. Re

A UINavigationController subclass that support pop interactive UINavigationbar with hidden or show.
A UINavigationController subclass that support pop interactive UINavigationbar with hidden or show.

KDInteractiveNavigationController Features ✨ UINavigationController interactive with UINavigationBar hidden or show Hide all UINavigationController ba

Fetch the star wars api from all the planets and list and show details using Swift UI and Combine

Star Wars Planets Fetch the star wars planet data by using stat war api, list and show details using SwiftUI and Combine frameworks 🔖 Swift UI Framew

Comments
  • Error with pod install

    Error with pod install

    Hi, I have a problem with the installation through CocoaPods. When I run the command pod install, I receive this error: [!] Unable to find a specification for 'HGRippleRadarView'. Do you have any suggestion about that? Thanks

    question 
    opened by francesc-o 3
  • Add item to specific circle

    Add item to specific circle

    Is there a possibility or a future update to specifically add an item into a certain circle? I want to use this radar and place the items depending on the distance from the center.

    opened by diegogarciar 1
Releases(0.1.1)
Owner
Hamza Ghazouani
Hamza Ghazouani
Fully customizable Facebook reactions like control

Reactions is a fully customizable control to give people more ways to share their reaction in a quick and easy way. Requirements • Usage • Installatio

Yannick Loriot 585 Dec 28, 2022
An easy to use UI component to help display a signal bar with an added customizable fill animation

TZSignalStrengthView for iOS Introduction TZSignalStrengthView is an easy to use UI component to help display a signal bar with an added customizable

TrianglZ LLC 22 May 14, 2022
🔍 Awesome fully customize search view like Pinterest written in Swift 5.0 + Realm support!

YNSearch + Realm Support Updates See CHANGELOG for details Intoduction ?? Awesome search view, written in Swift 5.0, appears search view like Pinteres

Kyle Yi 1.2k Dec 17, 2022
🚀 Elegant Pager View fully written in pure SwiftUI.

PagerTabStripView Made with ❤️ by Xmartlabs team. XLPagerTabStrip for SwiftUI! Introduction PagerTabStripView is the first pager view built in pure Sw

xmartlabs 482 Jan 9, 2023
Show the weather effects onto view written in Swift4.2

URWeatherView What is this for? Showing some kinds of the weather effect, written in Swift4.2. This code style is the Protocol Oriented Programming. T

Urtaq 449 Dec 28, 2022
Beautiful flag icons for usage in apps and on the web.

FlagKit Beautiful flag icons for usage in apps and on the web. All flags are provided as stand-alone PNG and SVG files. FlagKit also provides an Asset

Bowtie 2.9k Dec 29, 2022
Beautiful animated placeholders for showing loading of data

KALoader Create breautiful animated placeholders for showing loading of data. You can change colors like you want. Swift 4 compatible. Usage To add an

Kirill Avery 105 May 2, 2022
Material, a UI/UX framework for creating beautiful iOS applications

Material Welcome to Material, a UI/UX framework for creating beautiful applications. Material's animation system has been completely reworked to take

Cosmicmind 12k Jan 2, 2023
Custom Beautiful UIView For Handling IDs in iOS

IDView Custom Beautiful UIView For Handling IDs in iOS Setup Set the placeholder images for the front and back faces. override func viewDidLoad()

Omar Labib 6 Aug 21, 2021
A simple, customizable view for efficiently collecting country information in iOS apps.

CountryPickerView CountryPickerView is a simple, customizable view for selecting countries in iOS apps. You can clone/download the repository and run

Kizito Nwose 459 Dec 27, 2022