Sonar
Simple radar style view, written in Swift, pure CoreAnimation (no images). Highly adjustable.
Usage
Just place the UIView somewhere in your controller and make it SonarView class.
SonarView copies the data source and delegate patter from UITableView.
/// Data source
public weak var dataSource: SonarViewDataSource?
/// SonarViewDelegate and SonarViewLayout
public weak var delegate: SonarViewDelegate?
There are three required methods.
public protocol SonarViewDataSource: class {
func numberOfWaves(sonarView: SonarView) -> Int
func sonarView(sonarView: SonarView, numberOfItemForWaveIndex waveIndex: Int) -> Int
func sonarView(sonarView: SonarView, itemViewForWave waveIndex: Int, atIndex: Int) -> SonarItemView
}
SonarItemView is just a UIView subclass. In order to use your custom view in radar, make your view SonarItemView subclass. The size of view is determined via layout. The layout is defined by SonarViewLayout protocol. Sonar comes with one predefined layout - SonarViewCenteredLayout. The items in a wave are placed from edges to the center, for example if we have 4 items in wave, first is placed at the left side, second at the right side, third at the left again but a right from the first one and so on. I know, the image would be better:
If you need different behaviour, you can of course create your own layout by adopting the SonarViewLayout and pass it to the SonarView. See SonarViewLayout for more information.
The last protocol is Delegate which handles selections and titles on each wave
public protocol SonarViewDelegate: class {
func sonarView(sonarView: SonarView, didSelectObjectInWave waveIndex: Int, atIndex: Int)
func sonarView(sonarView: SonarView, textForWaveAtIndex waveIndex: Int) -> String?
}
If distanceForWaveAtIndex returns nil, the label will be hidden. For more information see the Example project.
Appearance
There are 3 colours that can be adjusted.
class public var lineColor: UIColor
class public var lineShadowColor: UIColor
class public var distanceTextColor: UIColor
Contribution
If you need to expose another properties or you have ideas how to improve it, file issue or send pull request, I'll be happy to discuss it.
Requirements
iOS 8+,
Version 2.x - Swift 2.2+
Version 3.x - Swift 3.0+
Version 4.x - Swift 4.2+
Version 5.x - Swift 5.0+
Installation
Sonar is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "Sonar"
Author
Aleš Kocur, [email protected]
License
Sonar is available under the MIT license. See the LICENSE file for more info.
115 Dec 28, 2022
123 Dec 17, 2022
469 Dec 27, 2022
76 Dec 16, 2022
76 Dec 17, 2022
696 Aug 3, 2022
3.2k Jan 4, 2023
4.2k Dec 30, 2022
0 Nov 24, 2021
0 Dec 13, 2021
4 Nov 16, 2022
3 Apr 27, 2022
608 Sep 15, 2022
90 Sep 1, 2022
243 Oct 28, 2022
2 Dec 16, 2021
0 Feb 16, 2022
3.2k Dec 27, 2022