Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/macabeus/TvLightSegments
🗂 Apple TV | Clean, simple, and beautiful segment bar for your AppleTv app
https://github.com/macabeus/TvLightSegments
stalkr-internals swift tvos ui-components
Last synced: 3 months ago
JSON representation
🗂 Apple TV | Clean, simple, and beautiful segment bar for your AppleTv app
- Host: GitHub
- URL: https://github.com/macabeus/TvLightSegments
- Owner: macabeus
- License: mit
- Created: 2017-04-27T03:19:38.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-07-23T07:20:25.000Z (over 7 years ago)
- Last Synced: 2024-07-28T03:06:31.317Z (3 months ago)
- Topics: stalkr-internals, swift, tvos, ui-components
- Language: Swift
- Homepage: https://cocoapods.org/pods/TvLightSegments
- Size: 181 KB
- Stars: 20
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://cocoapods.org/pods/TvLightSegments)
[](http://cocoapods.org/pods/TvLightSegments)
[](http://cocoapods.org/pods/TvLightSegments)
# TvLightSegments
💜 Clean, simple and beautiful segment bar for your AppleTv app
You can download this repository and see this example app.
# How to use
## Install
In `Podfile` add
```
pod 'TvLightSegments'
```
and use `pod install`.
## Setup
Create a new CollectionView and set `TvLightSegments` as a custom class
You need create create a class that subscriber `TvLightSegmentsDisplay`. When a segment's focus change, this class notified.
```swift
class ViewDetails: UIViewController, TvLightSegmentsDisplay {
@IBOutlet weak var name: UILabel!
@IBOutlet weak var textDetails: UITextView!
@IBOutlet weak var image: UIImageView!
// Oh! A segments' focus was changed! Then, execute this method ⚡️
func didChangeSegment(_ segmentItem: TvLightSegmentsItem) {
let pokemon = segmentItem as! Pokemon
name.text = pokemon.name
textDetails.text = pokemon.desc
image.image = pokemon.image
}
}
```
Also, you need create a class that subscriber `TvLightSegmentsItem`. The objects of this class will be the segments.
```swift
class Pokemon: TvLightSegmentsItem {
let name: String
let desc: String
init(name: String, desc: String) {
self.name = name
self.desc = desc
}
// Text that will show in segment
func tvLightSegmentsName() -> String {
return name
}
}
```
Now, in `ViewController`, we need setup the TvLightSegments, with the `setup(viewDisplay:)`:
```swift
class ViewMain: UIViewController {
@IBOutlet weak var segments: TvLightSegments!
...
override func viewDidLoad() {
// The parameter need be a TvLightSegmentsDisplay
segments.setup(viewDisplay: self.containerViewDetails!)
```
Then, set the segments, with the `set(segmentsItems:)`:
```swift
class ViewMain: UIViewController {
...
override func viewDidLoad() {
...
// The parameter need be a [TvLightSegmentsItem]
segments.set(segmentsItems: [
Pokemon(
name: "Pikachu",
desc: "Pikachu are small, chubby..."
),
Pokemon(
name: "Charmander",
desc: "Charmander is a small, bipedal..."
),
Pokemon(
name: "Bulbasaur",
desc: "Bulbasaur resembles a small..."
)
])
```
Awesome! Now, our TvLightSegments work! 😆
## Optional configs
### Colors
You can change the colors.
Hey! Change the colors **before** the `setup(viewDisplay:)` method!!
```swift
segments.labelColorSelected = UIColor.red
segments.labelColorNotSelected = UIColor.blue
segments.viewFooterColorSelected = UIColor.green
segments.viewFooterColorNotSelected = UIColor.black
```
### Transition
Set a transition animation when a segment's focus is changes.
Hey! Set the transitions **before** the `set(segmentsItems:)` method!!
```swift
segments.transitionConfig = TransitionConfig(
transitionStart: { display in
return { (display as! UIViewController).view!.alpha = 0 }
},
transitionStartTime: 0.5,
transitionEnd: { display in
return { (display as! UIViewController).view!.alpha = 1 }
},
transitionEndTime: 0.5
)
```
**Maintainer**:
> [macabeus](http://macalogs.com.br/) ·
> GitHub [@macabeus](https://github.com/macabeus)