Panel

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #golang #docker #macos #nodejs #windows #awesome #vue #pytorch #ios #open-source

(★ 23)

A Snapchat inspired ScrollView Controller Written in Swift

Panel 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Panel</h1>

## Overview

Panel is a a simple, Snapchat inspired ViewController subclass. Panel allows you to add you own custom ViewControllers to an embedded ScrollView. Panel allows complete control over the presentaion of the panels.

## Requirements

* iOS 8.0+
* Swift 3.0+

## License

Panel is available under the BSD license. See the LICENSE file for more info.

## Installation

### Cocoapods:

Panel is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod "Panel"
```

### Manual Installation:

Simply copy the contents of the Source folder into your project.

## Usage

Using Panel is very simple.

### Getting Started:

If you have installed via Cocoapods, be sure to include

```swift
import Panel
```

Create a View Controller, and set its subclass to be `PanelViewController`:

```swift
class MyViewController: PanelViewController {
    ...
    
}
```

### Adding View Controllers:

To add your own ViewControllers, your container ViewController must conform to the `PanelViewControllerDataSource` protocol:

```swift
class MyViewController: PanelViewController, PanelViewControllerDataSource {   
    ...
    
}
```

The container ViewController must also set itself as the dataSource delegate in `ViewDidLoad`:

```swift
override func viewDidLoad() {
    super.viewDidLoad()
        
    // Datasource to set our ViewControllers
    dataSource = self
}
```
    
`PanelViewControllerDataSource` has one required protocol functions which must be implemented: `PanelViewDidSetViewControllers()`. `PanelViewDidSetViewControllers()` expects a return type of `[UIViewController]`. Panel requires three ViewControllers be returned in this array, in the order you wish to have them displayed:

```swift
func PanelViewDidSetViewControllers() -> [UIViewController] {
    
  // Add your own custom View Controllers here 
     
  	viewController1 = UIViewController()
    viewController2 = UIViewController()
    viewController3 = UIViewController()
        
    let panelArray = [viewController1, viewController2, viewController3]
        
    // Will be displayed in order: [LeftPanel, CenterPanel, RightPanel]
        
    return panelArray
}
```
    
### Manually Moving to Panel

If you wish to animate to particular panel from inside your container ViewController, you can use the `animateTo(panel:)` function:

```swift
moveTo(panel: .left)
```
 
 Additionally, if you wish to have one of the panel ViewControllers animate to another panel, you can use the `PanelViewControllerDelegate` property. 
 
 Within the panel ViewController's decleration, add a delegate property of optional type `PanelViewControllerDelegate`:
 
```swift
var delegate: PanelViewControllerDelegate?
```

When declaring the container ViewControllers dataSource, set the panel's delegate to the container ViewController:

```swift
func PanelViewDidSetViewControllers() -> [UIViewController] {
     
   viewController1 = CustomViewController()
     
   // set the ViewController's delegate to the 
   // container ViewController
   
   viewContoller1.delegate = self
        
    ...
}
```

Once the delegate is set, you can animate the panels by calling the delegate function `PanelViewControllerAnimateTo(panel:)`:

```swift   
delegate?.PanelViewControllerAnimateTo(panel: .left)
```

### Miscellaneous

If you wish to know the position of the container ScrollView as it scrolls, you can implement the optional `PanelViewControllerDataSource` function `PanelViewControllerDidScroll(offSet:)`. This will return the offSet `CGFloat` between -1.0 and 1.0:

```swift   
func PanelViewControllerDidScroll(offSet: CGFloat) {
     // Offset is a float between -1.0 to 1.0 
     // depending on the position of ScrollView. 
     // -1.0 is centered on left panel
     // 0.0 is centered on central panel
     // 1.0 is centered on right panel
}
```

### Contact

If you have any questions, requests, or enhancements, feel free to submit a pull request, create an issue, or contact me in person:

**Andrew Walz** - **andrewjwalz@gmail.com**

Panel

Panel 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Panel

Panel 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README