Ecosyste.ms: Awesome

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

https://github.com/Interactive-Studio/ISPageControl

A page control similar to that used in Instagram
https://github.com/Interactive-Studio/ISPageControl

indicator instagram ios page pagecontrol swift

Last synced: about 2 months ago
JSON representation

A page control similar to that used in Instagram

Lists

README 

        
# ISPageControl



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

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

![Xcode 9.0+](https://img.shields.io/badge/Xcode-9.0%2B-blue.svg)

![iOS 8.0+](https://img.shields.io/badge/iOS-8.0%2B-blue.svg)

![Swift 4.0+](https://img.shields.io/badge/Swift-4.0%2B-orange.svg)

[![License](https://img.shields.io/cocoapods/l/Hero.svg?style=flat)](https://github.com/lkzhao/Hero/blob/master/LICENSE?raw=true)



**ISPageControl** has a page control similar to that used in the Instagram






## Contents



- [Requirements](#requirements)

- [Installation](#installation)

- [Usage](#usage)

- [Communication](#communication)

- [Credits](#credits)

- [License](#license)



## Requirements



- iOS 8.0+

- Xcode 9.0+

- Swift 4.0+



## Installation



### CocoaPods



[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:



```bash

$ gem install cocoapods

```



> CocoaPods 1.1+ is required to build ISPageControl 4.0+.



To integrate ISPageControl into your Xcode project using CocoaPods, specify it in your `Podfile`:



```ruby

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

platform :ios, '8.0'

use_frameworks!



target '' do

pod 'ISPageControl', '~> 0.1.0'

end

```



Then, run the following command:



```bash

$ pod install

```



### Carthage



[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.



You can install Carthage with [Homebrew](http://brew.sh/) using the following command:



```bash

$ brew update

$ brew install carthage

```



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



```ogdl

github "Interactive-Studio/ISPageControl" ~> 0.1.0

```



Run `carthage update` to build the framework and drag the built `ISPageControl.framework` into your Xcode project.



### Manually



If you prefer not to use either of the aforementioned dependency managers, you can integrate ISPageControl into your project manually.



---



## Usage



The usage of **ISPageControl** is very simple



### Storyboard, Xib



Just drop UIView and set its class to be one of ISPageControl.






### Code



```swift

let frame = CGRect(x: 0, y: 500, width: UIScreen.main.bounds.width, height: 100)

pageControl = ISPageControl(frame: frame, numberOfPages: 4)

pageControl.radius = 10

pageControl.padding = 10

pageControl.inactiveTintColor = UIColor.purple

pageControl.borderWidth = 3

pageControl.borderColor = UIColor.red

view.addSubview(pageControl)

```



### Custom



```swift

@IBInspectable open var inactiveTintColor: UIColor



@IBInspectable open var currentPageTintColor: UIColor



@IBInspectable open var radius: CGFloat



@IBInspectable open var padding: CGFloat



@IBInspectable open var minScaleValue: CGFloat



@IBInspectable open var middleScaleValue: CGFloat



@IBInspectable open var numberOfPages: Int



@IBInspectable open var hideForSinglePage: Bool



@IBInspectable open var inactiveTransparency: CGFloat



@IBInspectable open var borderWidth: CGFloat



@IBInspectable open var borderColor: UIColor

```



If you want to know more detailed usage, please refer to Example.



## Communication



- If you **found a bug**, open an issue.

- If you **have a feature request**, open an issue.

- If you **want to contribute**, submit a pull request.



## Credits



- GwangBeom Park ([@gwangbeom](https://github.com/ParkGwangBeom))



## License



ISPageControl is released under the MIT license. See LICENSE for details.