ShadowView - SwiftGit

Framework Views

ShadowView

September 10, 2023

ShadowView is an iOS Shadow library that makes view’s shadow implementation easy and sweet 🎉 🎊.

Add simple shadows to add a gaussian blurred projection (as a shadow) to any UIView.

Features

Add shadow easily from the storyboard and programmatically.
Add a gaussian blurred projection of your view (like iOS 10 music app).
Customize the border width and border color of any view from storyboard .

Requirements

iOS 9.0+
Xcode 8

Installation

CocoaPods

You can use CocoaPods to install ShadowView by adding it to your Podfile:


                                              
                                                source ‘https://github.com/CocoaPods/Specs.git’

platform :ios, ‘9.0’

use_frameworks!
target ‘<Your Target Name>’ do

pod ‘ShadowView’

end

Carthage

Install Carthage via Homebrew


                                              
                                                $ brew update

$ brew install carthage

Add github "PierrePerrin/ShadowView" to your Cartfile.
Run carthage update.
Drag ShadowView.framework from the Carthage/Build/iOS/ directory to the Linked Frameworks and Libraries section of your Xcode project’s General settings.
Add $(SRCROOT)/Carthage/Build/iOS/ShadowView.framework to Input Files of Run Script Phase for Carthage.

Manually

Download and drop all files in ShadowView directory in your project.
Nice Job the best shadow library is now installed! 🎉 🎊 🎈

Import

To get the full benefits import ShadowView wherever you import UIKit


                                              
                                                import UIKit

import ShadowView

How it works

Normal Shadows

This shadow framework uses default CoreGraphics shadows by adding it the the layer of the view.


                                              
                                                layer.shadowColor : CGColor

layer.shadowRadius : CGFloat

layer.shadowOffset : CGSize

layer.shadowOpacity : Float

layer.shadowPath : CGPath?

Projected Gaussian Shadows

Here the implemation is different. A shadow container need to be added and all views that needs a blurred shadow need to be subviews of this container. The container takes a screen of all it’s subviews and then apply blur on it.

Usage example

With Storyboard

Normal Shadows

Any view has new paramerters in the storyboar that you can change in order to add a customize shadow to your view.

Projected Gaussian Shadows

Add an UIView to you ViewController, change it class to ShadowView and insert in it all view that needs a blurred shadow.

Programmatically

Normal Shadows

Set the shadows parameters to your view and it the shadow will appear! 🌟


                                              
                                                view.shadowRadius = 5

view.shadowOffset = CGSize.zero

view.shadowColor = UIColor.black.cgColor

view.shadowOpacity = 0.3

Projected Gaussian Shadows

Create you container ShadowView and then add views that need Shadows inside of it.


                                              
                                                let exampleShadowContainerView = ShadowView()

let imageView = UIImageView(image: #imageLiteral(resourceName: “sample.jpg”))
override func loadView() {

super.loadView()
exampleShadowContainerView.frame = self.view.bounds

exampleShadowContainerView.autoresizingMask = [.flexibleWidth,.flexibleHeight]

exampleShadowContainerView.shadowOffset = CGSize(width: 0, height: 10)

exampleShadowContainerView.shadowRadius = 20
self.view.addSubview(exampleShadowContainerView)

self.exampleShadowContainerView.addSubview(imageView)

imageView.center = exampleShadowContainerView.center

}
override func viewDidLayoutSubviews() {

super.viewDidLayoutSubviews()

imageView.frame.size = CGSize(width: 200, height: 200)

imageView.center = exampleShadowContainerView.center

self.exampleShadowContainerView.updateShadow()

}

Please see the example for more prescisions.

Parameters


                                              
                                                //Shared Paramerters
@IBInspectable public var shadowRadius : CGFloat
@IBInspectable public var shadowOffset : CGSize
@IBInspectable public var shadowColor : UIColor?
@IBInspectable public var shadowOpacity : Float
//Normal Shadow
@IBInspectable var shadowPath : CGPath?
//ShadowView only
///It changes the size of the projected shadow view.

@IBInspectable var shadowScale : CGFloat
///Changes the tint color of the blurred image

@IBInspectable var shadowTintColor : UIColor
///Changes the saturation of the blurred image (default:1)

@IBInspectable var shadowSaturation : CGFloat