Awesome
MaterialKit
NOTE: This project is unmaintained.
Material design components (inspired by Google Material Design) for iOS written in Swift
Please feel free to make pull requests.
Features
-
Highly customizable
-
Complete example
-
Supports @IBDesignable to live-render the component in the Interface Builder
-
By supporting @IBInspectable, the class properties can be exposed in the Interface Builder, and you can edit these properties in realtime
-
MKButton: floating action button, raised button, flat button, ripple effect
-
MKTextField: ripple effect, floating placeholder
-
MKTableViewCell
-
MKLabel
-
MKImageView
-
MKLayer
-
MKColor
-
MKActivityIndicator
-
MKRefreshControl
-
MKNavigationBar
Components
MKButton
<p align="center"> <img style="-webkit-user-select: none;" src="./Assets/MKButton.gif" width="320" height="628"> </p>- There are 3 types of main buttons:
Floating Action Button
,Raised Button
,Flat Button
- Customizable attributes: color, ripple location, animation timing function, animation duration...
let button = MKButton(frame: CGRect(x: 10, y: 10, width: 100, height: 35))
button.maskEnabled = true
button.rippleLocation = .TapLocation
button.rippleLayerColor = UIColor.MKColor.LightGreen
MKTextField
<p align="center"> <img style="-webkit-user-select: none;" src="https://dl.dropboxusercontent.com/u/8556646/MKTextField.gif" width="365" height="568"> </p> <p align="center"> <img style="-webkit-user-select: none;" src="https://dl.dropboxusercontent.com/u/8556646/MKTextField_bottomborder.gif" width="365" height="111"> </p>- Single-line text field
- Floating placeholder
- Ripple Animation
- Customizable attributes: color, ripple location, bottom border, animation timing function, animation duration...
textField.rippleLocation = .Left
textField.floatingPlaceholderEnabled = true
textField.placeholder = "Description"
textField.layer.borderColor = UIColor.MKColor.Green.CGColor
textField.rippleLayerColor = UIColor.MKColor.LightGreen
MKTableViewCell
<p align="center"> <img style="-webkit-user-select: none;" src="./Assets/MKTableViewCell.gif" width="320" height="628"> </p>- Customizable attributes: color, ripple location, animation timing function, animation duration...
var cell = tableView.dequeueReusableCellWithIdentifier("MyCell") as MyCell
cell.rippleLocation = .Center
cell.rippleLayerColor = UIColor.MKColor.Blue
MKRefreshControl
<p align="center"> <img style="-webkit-user-select: none;" src="./Assets/MKRefreshControl.gif" width="320" height="628"> </p>- Customizable attributes: color, height
var refreshControl = MKRefreshControl()
refreshControl.addToScrollView(self.tableView, withRefreshBlock: { () -> Void in
self.tableViewRefresh()
})
refreshControl.beginRefreshing()
MKImageView (BarButtonItem), MKActivityIndicator
<p align="center"> <img style="-webkit-user-select: none;" src="./Assets/MKImageView+MKActivityIndicator.gif" width="328" height="628"> </p>-
Customizable attributes: color, ripple location, animation timing function, animation duration...
-
Play ripple animation whenever you want by calling
animateRipple
method or by settinguserInteractionEnabled = true
ripple animation will be played when the label/imageview is tapped -
Easy to customize UIBarButtonItem or UITabBarButton by using MKLabel or MKImageView
// customize UIBarButtonItem by using MKImageView
let imgView = MKImageView(frame: CGRect(x: 0, y: 0, width: 44, height: 32))
imgView.image = UIImage(named: "uibaritem_icon.png")
imgView.rippleLocation = .Center
imgView.userInteractionEnabled = true
let rightBarButton = UIBarButtonItem(customView: imgView)
self.navigationItem.rightBarButtonItem = rightBarButton
MKLayer
A subclass of CALayer.
MKColor
A category for UIColor that adds some methods to get flat colors designed by Google
// get color from UIColor
let lightBlueColor = UIColor.MKColor.LightBlue
MKNavigationBar
A custom UINavigationBar which supports elevation and adding a tint above itself
- Customizable attributes: color, dark color, elevation, shadow opacity, tint color...
- Set the class of the navigation bar in the storyboard designer to MKNavigationBar and set the custom properties
MKSwitch
On/off switches toggle the state of a single settings option. The option that the switch controls, as well as the state it’s in, should be made clear from the corresponding inline label. Switches take on the same visual properties of the radio button.
Installation
- Installation with CocoaPods
pod 'MaterialKit', '~> 0.4'
- Copying all the files into your project
- Using submodule
Requirements
- iOS 8.0+
- Xcode 6.1
License
MaterialKit is released under the MIT license. See LICENSE for details.