Magnetic

Magnetic is a customizable bubble picker like the Apple Music genre selection.

Demo Video

$ pod try Magnetic

Features

Requirements

iOS 9.0+
Xcode 9.0+
Swift 5 (Magnetic 3.x), 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 Magneticclass 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 delegatevar allowsMultipleSelection: Bool // controls whether you can select multiple nodes. defaults to truevar selectedChildren: [Node] // returns selected chidren

Nodes

A Node object is a SKShapeNode subclass.

Interaction

// add circular nodelet node = Node(text: "Italy", image: UIImage(named: "italy"), color: .red, radius: 30)
magnetic.addChild(node)// add custom nodelet node = Node(text: "France", image: UIImage(named: "france"), color: .blue, path: path, marginScale: 1.1)
magnetic.addChild(node)// remove nodenode.removeFromParent()

Properties

var text: String? // node textvar image: UIImage? // node imagevar color: UIColor // node color

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 {
            texture = image.map { SKTexture(image: $0) }
        }
    }    override func selectedAnimation() {}    override func deselectedAnimation() {}
}