How to use IBInspectable to adjust values in Interface Builder

Swift version: 5.6

Paul Hudson @twostraws May 28th 2019

The @IBInspectable keyword lets you specify that some parts of a custom UIView subclass should be configurable inside Interface Builder. Only some kinds of values are supported (booleans, numbers, strings, points, rects, colors and images) but that ought to be enough for most purposes.

When your app is run, the values that were set in Interface Builder are automatically set, just like any other IB value. Neat, huh?

Here's an example that creates a GradientView class. This wraps the CAGradientLayer class up in a UIView that you can place anywhere in your app. Even better, thanks to @IBInspectable you can customize the colors in your gradient right inside IB. Add this class to your project now:

@IBDesignable class GradientView: UIView {
    @IBInspectable var startColor: UIColor = UIColor.white
    @IBInspectable var endColor: UIColor = UIColor.white

    override class var layerClass: AnyClass {
        return CAGradientLayer.self
    }

    override func layoutSubviews() {
        (layer as! CAGradientLayer).colors = [startColor.cgColor, endColor.cgColor]
    }
}

Now go to IB, drop a UIView on to your storyboard, then change its class to be GradientView. Once that's done, Xcode will compile your project automatically, and then inside the attributes inspector you'll see two color selectors for the start and end color.

Note: @IBInspectable frequently does not play nicely with type inference, which is why I've explicitly declared both the type (UIColor) and default value (UIColor.white).

Sponsor Hacking with Swift and reach the world's largest Swift community!

Available from iOS 8.0