Flexible progress bar written in Swift.
Clone or download
Latest commit 022f6b1 Jun 29, 2018

README.md

KYCircularProgress

CocoaPods Compatible Carthage Compatible License Platform Language Percentage of issues still open Average time to resolve an issue

Flexible progress bar written in Swift.

Features

  • Gradation Color
  • Progress Closure
  • UIBezierPath Progress Bar
  • Progress Gauge Guide
  • Customizable on Storyboard
  • Progress Change Animation

Demo

Requirement

  • Swift4

Usage

Create KYCircularProgress

// create KYCircularProgress
let circularProgress = KYCircularProgress(frame: view.bounds)

// create KYCircularProgress with gauge guide
let circularProgress = KYCircularProgress(frame: view.bounds, showGuide: true)

Gradation Color

// support Hex color to RGBA color
circularProgress.colors = [UIColor(rgba: 0xA6E39D11), UIColor(rgba: 0xAEC1E355), UIColor(rgba: 0xAEC1E3AA), UIColor(rgba: 0xF3C0ABFF)]

// combine Hex color and UIColor
circularProgress.colors = [.purple, UIColor(rgba: 0xFFF77A55), .orange]

Progress Closure

circularProgress.progressChanged {
    (progress: Double, circularProgress: KYCircularProgress) in
    print("progress: \(progress)")
}

UIBezierPath Progress Bar

// create "Star progress bar"
let path = UIBezierPath()
path.move(to: CGPoint(x: 50.0, y: 2.0))
path.addLine(to: CGPoint(x: 84.0, y: 86.0))
path.addLine(to: CGPoint(x: 6.0, y: 33.0))
path.addLine(to: CGPoint(x: 96.0, y: 33.0))
path.addLine(to: CGPoint(x: 17.0, y: 86.0))
path.close()
starProgress.path = path

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects.

To integrate KYCircularProgress into your Xcode project using CocoaPods, specify it in your podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

pod 'KYCircularProgress'

Then, run the following command:

$ pod install

Carthage (iOS 8+)

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate KYCircularProgress into your Xcode project using Carthage, specify it in your Cartfile:

github "kentya6/KYCircularProgress" >= 1.2.0

Manually

Add KYCircularProgress.swift into your Xcode project.

Licence

The MIT License (MIT)

Copyright (c) 2014-2018 Kengo YOKOYAMA

Author

kentya6