Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 30 days 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-04-14T01:18:15.472Z (7 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: 106
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](http://cocoapods.org/pods/GaugeKit)
[](https://travis-ci.org/skywinder/GaugeKit)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/GaugeKit)
[](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`:
- 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:
###IB Example:
## 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.