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.google.android.material:material:1.0.0'
    }
    ```

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
    <com.google.android.material.floatingactionbutton.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 com.google.android.material.floatingactionbutton.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)
    *   [View the theming](./docsite-theming.md)
    *   [Contributing](./contributing.md)
    *   [Class
        documentation](https://developer.android.com/reference/com/google/android/material/classes)
    *   [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 }