Skip to content

An animation and graphics framework for Material Design in Swift.

License

Notifications You must be signed in to change notification settings

roselind/Material

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Material

Welcome to Material

An animation and graphics framework for Material Design in Swift.

MaterialApp

Features

  • Fully Configurable UI Components
  • Grid System For Complex UIs
  • Layout Library To Simplify AutoLayout
  • Base Material Layers & Material Views To Create New UI Components
  • Navigation Controls
  • Material Buttons
  • Material Switch
  • Material Card Views
  • Material Icons
  • Menu Toolset To Create Animated Menus
  • Camera / Video Extension With Extensive Functionality
  • Animation Extension To Create Intricate Animations
  • Complete Material Color Library
  • Example Projects
  • And More...

Requirements

  • iOS 8.0+ / Mac OS X 10.9+
  • Xcode 7.3+

Communication

  • If you need help, use Stack Overflow. (Tag 'cosmicmind')
  • If you'd like to ask a general question, use Stack Overflow.
  • If you found a bug, and can provide steps to reliably reproduce it, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.

Installation

Embedded frameworks require a minimum deployment target of iOS 8 or OS X Mavericks (10.9).

Visit the Installation page to learn how to install Material using CocoaPods and Carthage.

Changelog

Material is a growing project and will encounter changes throughout its development. It is recommended that the Changelog be reviewed prior to updating versions.

Examples

  • Visit the Examples directory to see example projects using Material.
  • The Installation page has documentation on how to run the example projects.

Sticker Sheet

To help template your project, checkout our latest addition, Material Sticker Sheet.

MaterialStickerSheet

Get the Sticker Sheet

Quick Access

Colors

Icons

Filters

Base Layers & Views

Text

Buttons

Control

Collection Management

Layout

  • Grid
  • MaterialLayout

Collections

Cards

Navigation Controls

Photo / Video Camera

Explore

MaterialColor

MaterialColor is a complete Material Design color library available within Material. To help with color choices, visit MaterialColor.io.

MaterialMaterialColorPalette

MaterialIcon

MaterialIcon is a library of Google and CosmicMind icons that are available for use within your iOS applications. To help with icon choices, visit MaterialIcon.io.

MaterialMaterialIcon

Filters

Material will be expanding its library to add image filters. The initial filter is blur.

MaterialFilterBlur

MaterialLayer

MaterialLayer is a lightweight CAShapeLayer used throughout Material. It is designed to easily take shape, depth, and animations.

MaterialMaterialLayer

Learn More About MaterialLayer

MaterialView

MaterialView is the base UIView class used throughout Material. Like MaterialLayer, it is designed to easily take shape, depth, and animations. The major difference is that MaterialView has all the added features of the UIView class.

MaterialMaterialView

Learn More About MaterialView

MaterialPulseView

MaterialPulseView is at the heart of all pulse animations. Any view that subclasses MaterialPulseView instantly inherits the pulse animation with full customizability.

MaterialMaterialPulseView

Learn More About MaterialPulseView

TextField

A TextField is an excellent way to improve UX. TextFields offer details that describe the usage and input results of text. For example, when a user enters an incorrect email, it is possible to display an error message under the TextField.

MaterialTextField

Learn More About TextField

TextView

A TextView is an excellent way to improve UX. TextViews offer details that describe the usage of text. In addition, TextViews may easily match any regular expression pattern in a body of text. Below is an example of the default hashtag pattern matching.

MaterialTextView

Learn More About TextView

FlatButton

A FlatButton is simple, clean, and very effective. Below is an example of a FlatButton in action.

MaterialFlatButton

Learn More About FlatButton

RaisedButton

A RaisedButton is sure to get attention. Take a look at the following animation example.

MaterialRaisedButton

Learn More About RaisedButton

FabButton

A FabButton is essential to Material Design's overall look. Below showcases its beauty.

MaterialFabButton

Learn More About FabButton

MaterialSwitch

MaterialSwitch is a fully customizable UIControl. It has auto centre alignment when using AutoLayout, and makes for a great addition to the UIControl family of components.

MaterialMaterialSwitch

Learn More About MaterialSwitch

Menu

A Menu manages a group of UIViews that may be animated open in the Up, Down, Left, and Right directions. The animations are fully customizable.

Below is an example using FlatButtons.

MaterialFlatMenu

Below is an example using FlatButtons with images.

MaterialFlashMenu

Learn More About Menu

Grid

Grid is an extension of UIView that enables any collection of subviews to be managed in a flexible grid system, independent of other views that would need to be freely moving. Below are examples of using Grid. In the Examples/Programmatic directory, there are examples using this wonderful feature.

Below is an example of a small CardView using Grid.

MaterialSmallCardView

Below is an example of a medium CardView using Grid.

MaterialGridMediumCardView

Below is an example of a large CardView using Grid.

MaterialGridLargeCardView

Learn More About Grid

MaterialTableViewCell

UITableViewCell is a popular and widely used view in iOS. Now the pulse animation and core Material features have been made available for the UITableViewCell.

MaterialMaterialTableViewCell

Learn More About MaterialTableViewCell

CardView

Right out of the box to a fully customizable configuration, CardView always stands out. Take a look at a few examples in action.

MaterialCardView

Easily remove the pulse animation and add a background image for an entirely new feel.

MaterialCardViewFavorite

Add any UIView as the detail to a CardView. For example, a UITableView.

MaterialTableCardView

CardViews are so flexible they create entirely new components by removing all but certain elements. For example, bellow is a button bar by only setting the button values of the CardView.

MaterialCardViewButtonBar

Learn More About CardView

ImageCardView

Bold and attractive, ImageCardView is the next step from a CardView. Below are some animations to give you an idea of the possibilities the ImageCardView has to offer.

MaterialImageCardView

Remove elements, such as details to create a fresh look for your images.

MaterialImageCardViewBackgroundImage

Learn More About ImageCardView

Navigation Controls

Navigation controls create smooth transitions between UIViewControllers. They may be used individually or stacked. Transitions are customizable and dimensions are flexible with auto management for both Portrait and Landscape modes.

MenuView

A MenuView is a UIView wrapper around a Menu control. It allows a stack of UIViews to be coordinated by a single view. This is good for Menus that are within flexible view hierarchies.

Below is an example using FabButtons.

MaterialFabMenu

MenuViewController

A MenuViewController manages UIViewControllers using a MenuView component.

MaterialMenuViewController

Toolbar

A Toolbar is a fully featured navigation bar that supports orientation changes, background images, title and detail labels, both left and right UIControl sets, and status bar settings.

MaterialToolbar

Learn More About Toolbar

ToolbarController

A ToolbarController manages UIViewControllers using a NavigationBar component.

MaterialToolbarController

SearchBar

A SearchBar is a fully featured search bar that supports orientation changes, background images, title and detail labels, both left and right UIControl sets, and status bar settings.

MaterialSearchBar

Learn More About SearchBar

SearchBarController

A SearchBarController manages UIViewControllers using a SearchBar component.

MaterialSearchBarController

SideNavigationController

A SideNavigationController manages UIViewControllers that are available as hidden drawers on the left and right of the view port.

MaterialSideNavigationController

CaptureView

Add a new dimension of interactivity with CaptureView. CaptureView is a fully functional camera that is completely customizable.

MaterialCaptureView

Learn More About CaptureView

Upcoming

  • TabBar
  • TabBarController
  • Scrolling Techniques
  • Snackbar
  • BottomNavigationController with Snackbar.
  • Bottom Sheets
  • Dialogs
  • Collapsing Toolbar
  • Pull to Refresh
  • RTL Support
  • Advanced Camera / Audio Toolset & Views
  • More Examples

License

Copyright (C) 2015 - 2016, Daniel Dahan and CosmicMind, Inc. http://cosmicmind.io. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this
    list of conditions and the following disclaimer.

  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

  • Neither the name of Material nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

About

An animation and graphics framework for Material Design in Swift.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 99.5%
  • Other 0.5%