Magnetic
Magnetic is a customizable bubble picker like the Apple Music genre selection.
$ pod try Magnetic
Features
- Adding/Removing Nodes
- Selection/Deselection/Removed Animations
- Multiple Selection
- Images
- Multiline Label
Requirements
- iOS 9.0+
- Xcode 9.0+
- Swift 4 (Magnetic 2.x), Swift 3 (Magnetic 1.x)
Usage
A Magnetic
object is an SKScene.
To display, you present it from an SKView object.
import Magnetic
class ViewController: UIViewController {
var magnetic: Magnetic?
override func loadView() {
super.loadView()
let magneticView = MagneticView(frame: self.view.bounds)
magnetic = magneticView.magnetic
self.view.addSubview(magneticView)
}
}
Properties
var magneticDelegate: MagneticDelegate? // magnetic delegate
var allowsMultipleSelection: Bool // controls whether you can select multiple nodes. defaults to true
var selectedChildren: [Node] // returns selected chidren
Nodes
A Node
object is a circular SKShapeNode subclass.
Interaction
// add node
let node = Node(text: "Italy", image: UIImage(named: "italy"), color: .red, radius: 30)
magnetic.addChild(node)
// remove node
node.removeFromParent()
Properties
var text: String? // node text
var image: UIImage? // node image
var color: UIColor // node color. defaults to white
Animations
override func selectedAnimation() {
// override selected animation
}
override func deselectedAnimation() {
// override deselected animation
}
override func removedAnimation(completion: @escaping () -> Void) {
// override removed animation
}
Delegation
The MagneticDelegate
protocol provides a number of functions for observing the current state of nodes.
func magnetic(_ magnetic: Magnetic, didSelect node: Node) {
// handle node selection
}
func magnetic(_ magnetic: Magnetic, didDeselect node: Node) {
// handle node deselection
}
Customization
Subclass the Node for customization.
For example, a node with an image by default:
class ImageNode: Node {
override var image: UIImage? {
didSet {
sprite.texture = image.map { SKTexture(image: $0) }
}
}
override func selectedAnimation() {}
override func deselectedAnimation() {}
}
Installation
CocoaPods
To install with CocoaPods, simply add this in your Podfile
:
use_frameworks!
pod "Magnetic"
Carthage
To install with Carthage, simply add this in your Cartfile
:
github "efremidze/Magnetic"
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
https://github.com/igalata/Bubble-Picker
License
Magnetic is available under the MIT license. See the LICENSE file for more info.