/material

A library to bring fully animated Material Design components to pre-Lolipop Android.

Primary LanguageJavaApache License 2.0Apache-2.0

Material

Maven Central Android Arsenal

MaterialLibrary is an Open Source Android library that back-port Material Design components to pre-Lolipop Android. MaterialLibrary's original author is Rey Pham.

##Features

Demo

Get it on Google Play

Or try it here.

Getting Started

Add Gradle dependency:

dependencies {
   compile 'com.github.rey5137:material:1.2.1'
}

You can try the SNAPSHOT version:

dependencies {
   compile 'com.github.rey5137:material:1.2.1.6-SNAPSHOT'
}

Make sure to add the snapshot repository:

repositories {
    maven {
        url "https://oss.sonatype.org/content/repositories/snapshots"
    }
}

AppCompat and CardView library is required by Material library.

dependencies {
   compile 'com.android.support:appcompat-v7:22.2.1'
   compile 'com.android.support:cardview-v7:22.2.1'
}

Now you can use any widget in com.rey.material.widget package as you wish. For styling, please view Wiki. Note that default style of widgets depend on theme of AppCompat. Here is an example:

     <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->

        <!-- colorPrimary is used for the default action bar background -->
        <item name="colorPrimary">@color/colorPrimary</item>

        <!-- colorPrimaryDark is used for the status bar -->
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>

        <!-- colorAccent is used as the default value for colorControlActivated
             which is used to tint widgets -->
        <item name="colorAccent">@color/colorAccent</item>

        <!-- You can also set colorControlNormal, colorControlActivated
             colorControlHighlight & colorSwitchThumbNormal. -->
    </style>

Donation

You can support the project and thank the author for his hard work.

Click here to lend your support to: Support Material Library project. and make a donation at pledgie.com !

PayPal

Contributing

Want to contribute? You are welcome! Note that all pull request should go to dev branch.

Developed By

License

Copyright 2015 Rey Pham.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.