# Material Card A card is a sheet of material that may contain a photo, text, and a link about a single subject. They may display content containing elements of varying size, such as photos with captions of variable length. `MaterialCardView` is a customizable component based on [`CardView`](https://developer.android.com/reference/android/support/v7/widget/CardView.html) from the Android Support Library. `MaterialCardView` provides all of the features of `CardView`, but adds attributes for customizing the stroke and uses an updated Material style by default. Note: `MaterialCardView` is an _in-progress_ implementation, and will continue to receive new features and updates. The majority of these updates will be style-based with additional options for the layout of content inside of a card (for example: dividers, images, actions, and text treatments). Updates will also include functionality for card behavior in groups of cards. ## Design & API Documentation - [Material Design guidelines: Cards](https://material.io/guidelines/components/cards.html) - [Class definition](https://github.com/material-components/material-components-android/tree/master/lib/java/android/support/design/card/MaterialCardView.java) - [Superclass overview](https://developer.android.com/reference/android/support/v7/widget/CardView.html) ## Usage Example code of how to include the component in your layout is listed here for reference. Note that the margins around the card (its "gutters") need to be listed in the layout of the card and cannot be included in a `style` tag. ```xml ``` ### Material Styles Using `MaterialCardView` with an updated Material theme (`Theme.MaterialComponents`) will provide the correct updated Material styles to your cards by default. If you need to use an updated Material card and your application theme does not inherit from an updated Material theme, you can apply the `Widget.MaterialComponents.CardView` style directly to your widget in XML. #### Updated Material Style The updated `MaterialCardView` style consists of updated elevation and background color. ```xml ``` #### Legacy Material Style ```xml ``` ### Attributes `MaterialCardView` supports all of the standard attributes that can be changed for a [`CardView`](https://developer.android.com/reference/android/support/v7/widget/CardView.html). The following additional attributes can be changed for a `MaterialCardView`: Feature | Relevant attributes :------ | :------------------ Border | `app:strokeColor` | `app:strokeWidth`