tbxark/tkradarchart

A customizable radar chart in Swift

TKRadarChart

A customizable radar chart in Swift

Requirements

• iOS 8.0+
• Xcode 9.0
• Swift 4.0

Installation

CocoaPods

You can use CocoaPods to install TKRadarChart by adding it to your Podfile:

platform :ios, '8.0'
use_frameworks!
pod 'TKRadarChart'

To get the full benefits import TKRadarChart wherever you import UIKit

import UIKit
import TKRadarChart

Carthage

Create a Cartfile that lists the framework and run carthage update. Follow the instructions to add $(SRCROOT)/Carthage/Build/iOS/TKRadarChart.framework to an iOS project.

github "tbxark/TKRadarChart"

Manually

1. Download and drop TKRadarChart.swift in your project.
2. Congratulations!

Usage example

Base

Base	Description	Demo
Step	Background polygon laps(min 1)
Row	Number of edges of polygon (min 3)
Section	At the same time show the number of data

TKRadarChartConfig

This structure is used for custom charts

    var radius: CGFloat    
    var minValue: CGFloat
    var maxValue: CGFloat

    var showPoint: Bool
    var showBorder: Bool
    var fillArea: Bool
    var clockwise: Bool
    var autoCenterPoint: Bool

TKRadarChartDataSource

This protocol represents the data model object. as such, it supplies no information about appearance

protocol TKRadarChartDataSource: class {
    func numberOfStepForRadarChart(_ radarChart: TKRadarChart) -> Int
    func numberOfRowForRadarChart(_ radarChart: TKRadarChart) -> Int
    func numberOfSectionForRadarChart(_ radarChart: TKRadarChart) -> Int

    func titleOfRowForRadarChart(_ radarChart: TKRadarChart, row: Int) -> String
    func valueOfSectionForRadarChart(withRow row: Int, section: Int) -> CGFloat
}

TKRadarChartDelegate

This represents the display and behaviour of the TKRadarChart.

protocol TKRadarChartDelegate: class {
    func colorOfTitleForRadarChart(_ radarChart: TKRadarChart) -> UIColor
    func colorOfLineForRadarChart(_ radarChart: TKRadarChart) -> UIColor
    func colorOfFillStepForRadarChart(_ radarChart: TKRadarChart, step: Int) -> UIColor

    func colorOfSectionFillForRadarChart(_ radarChart: TKRadarChart, section: Int) -> UIColor
    func colorOfSectionBorderForRadarChart(_ radarChart: TKRadarChart, section: Int) -> UIColor
}

Release History

• 1.4.3 Upgrade to swift 4.2

• 1.4.2 Fix bugs that can not change the title font

• 1.4.1 Fix warnign

• 1.4.0 Upgrade to swift 4.0

• 1.3.1 Upgrade framework config

• 1.3.0 Support swift 3.0

• 1.0.1 Complete basic functions, add Cocoapod and Carthage support

Contribute

We would love for you to contribute to TKRadarChart, check the LICENSE file for more info.

Meta

TBXark – @tbxark – [email protected]

Distributed under the MIT license. See LICENSE for more information.

https://github.com/TBXark

tkradarchart's Issues

Show value of each row of the chart

Is there a way to show the value or each row (e.g. 2,7) in the chart?

can not able to use diffrent colors :- colorOfLineForRadarChart

Hi,

Is there option use multiple line colors can use?.

Custom legend

Hello,

I use your spider chart, it works perfectly well, except I want to custom just a little more the legend of my chart. change the color, the number of line and the font.

If is it possible, How can I do you it ?

Two lines title

Is it possible to use two (or more) lines in titles?

Chart is too small and not centered?

I expect the chart to fill the entire space within the white border, and that it's centered?

Code:

import Reusable
import TKRadarChart
import UIKit

final class ReportSpiderChart: UITableViewCell, Reusable, NibLoadable {
  let labels = ["ARTISTS", "TRACKS", "ALBUMS"]

  @IBOutlet private var chartView: TKRadarChart!
  private var data: ReportData?

  override func awakeFromNib() {
    super.awakeFromNib()
    chartView.configuration.borderWidth = 1
    chartView.dataSource = self
    chartView.delegate = self
    chartView.layer.borderWidth = 1
    chartView.layer.borderColor = UIColor.white.cgColor
  }

  func configure(data: ReportData) {
    self.data = data
    chartView.configuration.maxValue = CGFloat(max(data.artists, data.albums, data.tracks, data.previousArtists, data.previousAlbums, data.previousTracks))
    chartView.reloadData()
  }
}

extension ReportSpiderChart: TKRadarChartDataSource {
  func numberOfStepForRadarChart(_ radarChart: TKRadarChart) -> Int {
    return 3
  }

  func numberOfRowForRadarChart(_ radarChart: TKRadarChart) -> Int {
    return 3
  }

  func numberOfSectionForRadarChart(_ radarChart: TKRadarChart) -> Int {
    return 2
  }

  func titleOfRowForRadarChart(_ radarChart: TKRadarChart, row: Int) -> String {
    return labels[row]
  }

  func valueOfSectionForRadarChart(withRow row: Int, section: Int) -> CGFloat {
    guard let data = data else {
      return 0
    }

    if row == 0 {
      return CGFloat(section == 0 ? data.artists : data.previousArtists)
    }

    if row == 1 {
      return CGFloat(section == 0 ? data.albums : data.previousAlbums)
    }

    if row == 2 {
      return CGFloat(section == 0 ? data.tracks : data.previousTracks)
    }

    return 0
  }
}

extension ReportSpiderChart: TKRadarChartDelegate {
  func colorOfLineForRadarChart(_ radarChart: TKRadarChart) -> UIColor {
    return .reportDivider
  }

  func colorOfFillStepForRadarChart(_ radarChart: TKRadarChart, step: Int) -> UIColor {
    return .black
  }

  func colorOfSectionFillForRadarChart(_ radarChart: TKRadarChart, section: Int) -> UIColor {
    return section == 0 ? UIColor.reportRed.withAlphaComponent(0.75) : UIColor.reportChartInactive.withAlphaComponent(0.75)
  }

  func fontOfTitleForRadarChart(_ radarChart: TKRadarChart) -> UIFont {
    return .systemFont(ofSize: 11, weight: .semibold)
  }

  func colorOfTitleForRadarChart(_ radarChart: TKRadarChart) -> UIColor {
    return .reportGrayText
  }
}

Better Installation Section

Hey, your library is really interesting.

The only problem I found was the README.md, which needs a better Installation Section.
I created this iOS Open source Readme Template so you can take a look on how to easily make the Installation Section better.
If you want, I can help you to organize the lib.

What are your thoughts? 😄