https://github.com/michael-rapp/androidmaterialviews

Provides views that are part of the Material Design guidelines
https://github.com/michael-rapp/androidmaterialviews

android chip floatingactionbutton material-design progress-bar view

Last synced: 3 months ago
JSON representation

Provides views that are part of the Material Design guidelines

• Host: GitHub
• URL: https://github.com/michael-rapp/androidmaterialviews
• Owner: michael-rapp
• License: apache-2.0
• Created: 2015-10-14T12:07:08.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2019-02-23T18:42:21.000Z (almost 6 years ago)
• Last Synced: 2024-02-26T19:49:10.364Z (12 months ago)
• Topics: android, chip, floatingactionbutton, material-design, progress-bar, view
• Language: Java
• Homepage:
• Size: 8.84 MB
• Stars: 11
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# AndroidMaterialViews - README

[![API-Level](https://img.shields.io/badge/API-14%2B-orange.svg)](https://android-arsenal.com/api?level=14) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=X75YSLEJV3DWE)

"AndroidMaterialViews" is an Android-library, which provides various views, which are part of Android's Material Design guidelines, but which are not provided by the official Android SDK. The library's views can also be used on pre-Lollipop 

devices.

![](doc/images/example.png)

The library provides the following views:

- A `CircularProgressBar`, which allows to visualize an indeterminate progress as an animated circle.

- A `FloatingActionButton`, which is a round, colored button with a shadow and an icon. The button supports to become shown or hidden in an animated manner.

- A `Chip`, which acts like a tag, containing a text and optionally an icon and a close button.

## License Agreement

This project is distributed under the Apache License version 2.0. For further information about this license agreement's content please refer to its full version, which is available at http://www.apache.org/licenses/LICENSE-2.0.txt.

Prior to version 2.0.1 this library was distributed under the GNU Lesser General Public License version 3.0 (GLPLv3).

## Download

The latest release of this library can be downloaded as a zip archive from the download section of the project's Github page, which is available [here](https://github.com/michael-rapp/AndroidMaterialViews/releases). Furthermore, the library's source code is available as a Git repository, which can be cloned using the URL https://github.com/michael-rapp/AndroidMaterialViews.git.

Alternatively, the library can be added to your Android app as a Gradle dependency by adding the following to the respective module's `build.gradle` file:

```groovy

dependencies {

    compile 'com.github.michael-rapp:android-material-views:3.0.1'

}

```

Before version 2.0.0 this project was hosted on [Sourceforge](https://sourceforge.net/projects/androidmaterialviews). These older versions used the legacy Eclipse ADT folder structure and are not available as Gradle artifacts.

## Examples

The following examples provide a quick overview on how to use the views, which are provided by the library, in your own Android app. This project also contains the source code of an example app, which implements an use case of the library for demonstration purposes, as well as a more detailed documentation in the [Wiki](https://github.com/michael-rapp/AndroidMaterialViews/wiki) and auto-generated javadoc files.

### CircularProgressBar

The XML code below shows how the view `CircularProgressBar` can be added to a XML layout resource. This example contains all of the view's custom attributes.

```xml

 

     

```

### FloatingActionButton

The following example demonstrates how a `FloatingActionButton` can be declared within a XML layout resource. The example contains all of the view's custom attributes.

```xml

 

     

```

## Chip

The following XML code shows how a `Chip` can be added to a XML resource. The example contains a text as well as an icon and a close button. By using a Chip's `addCloseListener`-method, listeners can be registered to be notified when a chip has been closed.

```xml

 

     

```

If a dark theme should be used by a `Chip`, this can be achieved by adding a `style`-tag like shown in the following:

```xml