Skip to content

Howardw3/HamsterUIKit

Repository files navigation

HamsterUIKit

A simple and elegant UIKit(Chart) for iOS, written in Swift.

📊 Curve and bar Charts.
💡 Protocols are designed based on UIKit(UITableView).
🔟 Draw a complex but elegant graph in 10 minutes.

Installation

CocoaPods

Add to your Podfile:

use_frameworks! pod 'HamsterUIKit' 

Type in terminal:

pod install 

Import the framework

import HamsterUIKit 

Protocols

Initialize and reload

UITableView HamsCurveChart HamsBarChart
init(frame: CGRect) same same
init?(coder aDecoder: NSCoder) same same
reloadData same same

DataSource

UITableView HamsCurveChart HamsBarChart
numberOfSections(in tableView: UITableView) -> Int numberOfCharts(in curveChart: HamsCurveChart) -> Int numberOfCharts(in barChart: HamsBarChart) -> Int
tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell curveChart(_ curveChart: HamsCurveChart, pointForChart indexPath: HamsIndexPath) -> HamsCurveChartPoint barChart(_ barChart: HamsBarChart, barForChart indexPath: HamsIndexPath) -> HamsBarChartRect
tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int curveChart(_ curveChart: HamsCurveChart, numberOfValuesInChart chart: Int) -> Int barChart(_ barChart: HamsBarChart, numberOfValuesInChart chart: Int) -> Int

Delegate

HamsCurveChart HamsBarChart
curveChart(_ curveChart: HamsCurveChart, configureForCharts chart: Int) barChart(_ barChart: HamsBarChart, configureForCharts chart: Int)

Demo

Bar Chart Demo

Curve Chart Demo

Bar Chart Quick start

import UIKit import HamsterUIKit class HelloBarChartViewController: UIViewController, HamsBarChartDelegate, HamsBarChartDataSource { var barChart:HamsBarChart = HamsBarChart() var dataSets = [CGFloat]() override func viewDidLoad() { super.viewDidLoad()	barChart = HamsBarChart(frame: CGRect(x: 0, y: 0, width: view.frame.width, height: 300))	barChart.delegate = self	barChart.dataSource = self	view.addSubview(barChart) } func barChart(_ barChart: HamsBarChart, numberOfValuesInChart chart: Int) -> Int { return dataSets.count } func numberOfCharts(in barChart: HamsBarChart) -> Int { return 1 } func barChart(_ barChart: HamsBarChart, barForChart indexPath: HamsIndexPath) -> HamsBarChartRect { let rect = HamsBarChartRect()	rect.value = .plain(dataSets[indexPath.column])	rect.color = .plain(.white) return rect } override func viewWillAppear(_ animated: Bool) {	super.viewWillAppear(animated)	dataSets = [1,4,6,1]	barChart.reloadData() } func barChart(_ barChart: HamsBarChart, configureForCharts view: Int) {	barChart.title = "BarChart(plain)" } override func didReceiveMemoryWarning() { super.didReceiveMemoryWarning() } }

Todo

Advanced Configuration

Created By:

Howard Wang - Hire me

Zhiye Jin(UI Designer)

Healthy Fridge Project - Hamster Fridge Management

License

HamsterUIKit is Copyright (c) 2017 Howard Wang and released as open source under the attached Apache 2.0 license.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.