material-components_material-components-android/docs/docsite-index.md

<!--docs:
# This file is used by the docsite to generate the platform index page.
title: "Material Components for Android"
layout: "homepage"
path: /
-->

{% contentfor benefits %}

<ul class="benefits-list">
  <li class="benefits-list-item">
    <h3>Accurate &amp; up to date</h3>
    <p>Implement <a href="https://material.io/guidelines">Material Design</a> with pixel-perfect components, maintained by Google engineers and designers</p>
  </li>
  <li class="benefits-list-item">
    <h3>Latest Android APIs</h3>
    <p>Access components that use of the latest Android APIs and features, with graceful degradation for older Android versions</p>
  </li>
  <li class="benefits-list-item">
    <h3>Industry standards</h3>
    <p>Take advantage of the same components used in Google’s Android apps, which meet industry standards for internationalization and accessibility</p>
  </li>
</ul>

{% endcontentfor %}

# Material Components for Android

Material Components for Android provides modular and customizable UI components
to help developers easily create beautiful apps.

## Getting Started

1.  {: .step-list-item } ### Modify build.gradle
    To use the Material Components library with the Gradle build system, include
    the library in the build.gradle dependencies for your app.

    ```groovy
    dependencies {
      compile 'com.android.support:design:[Library version code]'
    }
    ```

2.  {: .step-list-item } ### Update your Layout
    Add a reference to the component (widget) that you want to use in your XML
    layout. (You can also dynamically instantiate a widget in Java.)

    ```xml
    <android.support.design.widget.FloatingActionButton android:id="@id/fab" />
    ```

3.  {: .step-list-item } ### Use the Component
    You can then reference that widget in your Java class. First import it,

    ```java
    import android.support.design.widget.FloatingActionButton;
    ```

    then use it.

    ```java
    FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
    fab.setOnClickListener(new View.OnClickListener() {
      public void onClick(View v) {
        // Do something!
      }
    });
    ```

4.  {: .step-list-item } ### What's next?

    * [View the components](./docsite-components.md)
    * [Contributing](./contributing.md)
    * [Class documentation](https://developer.android.com/reference/android/support/design/widget/package-summary.html)
    * [MDC-Android on Stack Overflow](https://www.stackoverflow.com/questions/tagged/material-components+android)
    * [Android Developer’s Guide](https://developer.android.com/training/material/index.html)
    * [Material.io](https://www.material.io)
    * [Material Design Guidelines](https://material.google.com)
{: .step-list }