Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/skywinder/gaugekit

Kit for building custom gauges + easy reproducible Apple's style ring gauges.
https://github.com/skywinder/gaugekit

carthage cocoapods gauge gauge-plugin gaugekit gauges graphics ios-sdk swift

Last synced: about 14 hours ago
JSON representation

Kit for building custom gauges + easy reproducible Apple's style ring gauges.

Host: GitHub
URL: https://github.com/skywinder/gaugekit
Owner: skywinder
License: mit
Created: 2015-06-19T09:59:47.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2022-04-10T17:09:05.000Z (over 2 years ago)
Last Synced: 2024-10-29T17:51:08.220Z (about 2 months ago)
Topics: carthage, cocoapods, gauge, gauge-plugin, gaugekit, gauges, graphics, ios-sdk, swift
Language: Swift
Homepage: https://www.cocoacontrols.com/controls/gaugekit
Size: 9.1 MB
Stars: 1,025
Watchers: 35
Forks: 100
Open Issues: 2
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        [![Version](https://img.shields.io/cocoapods/v/GaugeKit.svg?style=flat)](http://cocoapods.org/pods/GaugeKit)

[![Build Status](https://travis-ci.org/skywinder/GaugeKit.svg)](https://travis-ci.org/skywinder/GaugeKit)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

![language](https://img.shields.io/badge/Language-%20Swift%20-orange.svg)

[![License](https://img.shields.io/cocoapods/l/GaugeKit.svg?style=flat)](http://cocoapods.org/pods/GaugeKit)

[![Platform](https://img.shields.io/cocoapods/p/GaugeKit.svg?style=flat)](http://cocoapods.org/pods/GaugeKit)



# GaugeKit

##Kit for building custom gauges + easy reproducible Apple's style ring gauges.



->



## Example Usage

Open `GaugeKit.xcworkspace` and change the scheme to 'Example' and run Example project.

## Installation

### CocoaPods

[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects.

GaugeKit is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '8.0'

use_frameworks!

pod "GaugeKit"

```

### Carthage

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

```ogdl

github "skywinder/GaugeKit" >= 0.2

```

#### Embedded Framework

Add GaugeKit as a [submodule](http://git-scm.com/docs/git-submodule) by opening the Terminal, `cd`-ing into your top-level project directory, and entering the following command:

```bash

$ git submodule add https://github.com/skywinder/GaugeKit.git

```

### Manually

If you prefer not to use either of the aforementioned dependency managers, you can simply add swift files into your project manually.

## Features :sparkles:

- Flexible and high-customizible gauges

- Auto-resized views

- Support `@IBInspectable` & `@IBDesignable`

- Written with vanilla `Swift` flavor :baby_chick:

## Usage :rainbow:

- Put on storyboard `UIView`, and set them class `Gauge` and module `GaugeKit`:

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/IB_class.png)

- Select type of gauge (property `type` in class or `gaugeTypeInt` for changes directly in Interface builder)

       - case `Circle`

       - case `Left`

       - case `Right`

       - case `Line`

##Example:

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/GaugeKit_sreenshot.png)

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/SWGauge_example.gif)

###IB Example:

![GaugeKit](https://raw.githubusercontent.com/skywinder/GaugeKit/master/Images/ib_example_1.gif)

## Requirements

- iOS SDK **7.0** or **later** (iOS SDK **8.0** if you use it as a Framework)

- **Swift 1.2** and **Xcode 6.3** or later

- **Swift 2.x.x** is also supported!

## Communication :speaker:

Bug reports, feature requests, patches, well-wishes are always welcome!

- If you need help, [open an issue](https://github.com/skywinder/GaugeKit/issues/new).

- If you found a bug, [open an issue](https://github.com/skywinder/GaugeKit/issues/new).

- If you have a feature request, [open an issue](https://github.com/skywinder/GaugeKit/issues/new).

- If you want to contribute, see [Contributing](https://github.com/skywinder/GaugeKit#contributing-octocat) section.

## Contributing :octocat:

I'd love to see your ideas for improving this library.

The best way to contribute is by submitting a pull request.

## Contributors

### Code Contributors

This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].























## License

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