Material README

The project's README from github.com/CosmicMind/Material. As one markdown file: README.md.

Material

Material

Welcome to Material, a UI/UX framework for creating beautiful applications. Material's animation system has been completely reworked to take advantage of Motion, a library dedicated to animations and transitions.

Carthage compatible Accio supported Version License Xcode 8.2+ iOS 8.0+ Swift 4.0+ Donate

Photos Sample

Take a look at a sample Photos project to get started.

Photos

Sample Projects

Take a look at Sample Projects to get your projects started.

Features

Requirements

Communication

Installation

Embedded frameworks require a minimum deployment target of iOS 8+.

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate Material's core features into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

pod 'Material', '~> 3.1.0'

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Material into your Xcode project using Carthage, specify it in your Cartfile:

github "CosmicMind/Material"

Run carthage update to build the framework and drag the built Material.framework into your Xcode project.

Change Log

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

Icons

Icons is a library of Google and CosmicMind icons that are available for use within your iOS applications.

Icon

Learn More

Colors

Try the Material Colors app to see the wonderful colors available in Material, or use the online version at MaterialColor.com.

MaterialColors

TextField

A TextField is an excellent way to improve UX. It allows for a placeholder and additional hint details.

TextField

Button

A button is used to trigger an action through a touch event. Material comes with a foundational button, and 4 specialized buttons that can be stylized in any way.

Material Image

Switch

A switch is a control component that toggles between on and off states.

Material Image

Card

A Card is a flexible component that may be configured in any way you like. It has a Toolbar, Bar, and content area that may utilize any UIView type.

Material Image

ImageCard

An ImageCard is an expansion of the base Card. The Toolbar overlays an image area that sits above the dynamic content area.

Image Card Sample

PresenterCard

The PresenterCard is a completely new card style. It allows for a primary presentation area that may be any UIView type in addition to the content area, Toolbar, and Bar components. The options for this card are endless.

Presenter Card Sample

FABMenu

A FABMenu manages a collection of views. A new MenuItem type has been added that manages a title and button to improve UX and visual beauty.

Material Image

Toolbar

Toolbars are super flexible and add excellent control to your navigation flow. They manage a set of left and right views with auto aligning title and detail labels.

Material Image

A SearchBar is a powerful navigation tool that allows for user's input with an instant visual response. A set of left and right views may be added to expand functionality.

SearchBarController

Tabs

Tabs is a new component that links a customizable TabBar to a stack of view controllers making a powerful and visually pleasing component to have in any application.

Tabs

NavigationController

A NavigationController is a specialized view controller that manages a hierarchy of content efficiently, making it easier for users to move within an application.

Material Image

NavigationDrawer

A NavigationDrawer slides in from the left or right and contains the navigation destinations for your application.

Material Image

Snackbar

A Snackbar is a new component that is very simple in its behavior and very powerful in its message. It can be used application wide, or isolated to specific view controllers.

Material Image

Sticker Sheet

To help template your project, checkout Material Sticker Sheet.

MaterialStickerSheet

Much More...

So much more inside. Enjoy!

License

The MIT License (MIT)

Copyright (C) 2019, CosmicMind, Inc. http://cosmicmind.com. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Material (CosmicMind/Material)

Searching Database…

这是什么?Material 是一个用于构建 iOS 应用的 UI/UX 框架,提供受 Google Material Design 启发的组件,例如卡片、文本输入框、导航抽屉和 Snackbar。
这是我可以在上面搭建界面的框架,还是只是一组额外的小部件?它是一个完整的框架,提供布局工具、颜色库以及数十个现成组件(如卡片、按钮、标签页、导航控制器/抽屉),而不只是单个小部件。
如何把它添加到我的 Xcode 项目中?可以通过 CocoaPods 安装:将其添加到 Podfile 中并运行 pod install;也可以通过 Carthage 安装:将其添加到 Cartfile 中并运行 carthage update,然后把构建好的框架拖入你的项目。
我需要先安装 CocoaPods 或 Carthage 吗?需要,你要先安装两种依赖管理工具(CocoaPods 或 Carthage)中的一种,而 Carthage 本身可以通过 Homebrew 安装。
它需要哪些 iOS 和 Xcode 版本?至少需要 iOS 8.0 和 Xcode 8.0;嵌入式框架的部署目标需要为 iOS 8 或更高版本。
这只适用于 iOS,还是也支持 Android?它是一个仅适用于 iOS 的 Swift 框架;尽管受 Material Design 启发,但本仓库中并没有对应的 Android 版本。
动画系统底层使用了什么?Material 的动画系统经过重构,改为基于 Motion 构建,Motion 是一个专门用于动画和过渡效果的独立库。
有没有可以帮助我用 Material 搭建界面的设计参考?有,CosmicMind 提供了 Material Sticker Sheet,用来帮助模板项目使用 Material 的组件。
在使用之前,我在哪里可以查看颜色调色板?你可以试用 Material Colors iOS 应用,或者在 MaterialColor.com 上在线浏览调色板。
除了基础按钮,还有哪些比较突出的组件?它包含一些高级组件,例如 FABMenu(带菜单项的浮动操作按钮)、ImageCard 和 PresenterCard 变体,以及将 TabBar 与视图控制器关联起来的 Tabs 组件。
Creator
CosmicMind
Size
33.3 MB
Stars
12K
Age
11y
Commits · 90 Days