Image lists
Image lists display a collection of images in an organized grid.

Usage
Image lists represent a collection of items in a repeated pattern. They help improve the visual comprehension of the content they hold.
Principles

Visual
Image lists allow users to scan content based on images.

Comparable
Image lists allow users to easily compare items within a collection.

Integrated
Image lists are responsively integrated with the surrounding content and layout.
Types

2. Quilted image lists emphasize certain items over others in a collection. They create hierarchy using varied container sizes and ratios.
3. Woven image lists facilitate the browsing of peer content. They display content in containers of varying ratios to create a rhythmic layout.
4. Masonry image lists facilitate the browsing of uncropped peer content. Container heights are sized based on the image size.
Anatomy
Image lists are comprised of containers that are set at a certain aspect ratio. Each item in an image list can display optional text and iconography below or above the image container.

The image container displays an image list item’s image or illustration.
2. Text labels (optional)
Text labels display one line of text related to an image list item.
3. Actionable iconography (optional)
Actionable iconography can represent related actions.
4. Text protection (optional)
Text protection is a semi-opaque scrim placed in front of imagery to keep text above it legible.
5. Image list item
Image list items represent individual items in an image list.
Padding
Padding can vary between images in an image list. The following padding values are recommended: 1, 2, 4, 8, 16, 20, 24, 32 dp.
Behavior
Actions
Image lists items may be tapped, dragged, filtered, or sorted.
Caution
Don't
Layout grid
Defined layout
Image list column structures don’t need to align to the layout grid. Only the perimeter of the image list itself needs to align to the layout grid.

Alignment with other components
Image lists can be placed adjacent to other components in the layout grid.

Responsive
Image lists inherit the responsive behavior of the layout grid.
Reflow
When a container increases in size, the content inside of it should also increase, or reflow, to fit the new container size appropriately. In some circumstances, the expanding container can also create space for more elements to appear.
A reflow transition can use a shared transformation to reinforce the relationship between elements. A shared transformation groups elements together and transforms them as a single unit, rather than animating each element independently. This creates a smoother visual experience and avoids the possibility of multiple transformations overlapping and competing for attention.
Grouped elements can use any of the following fading types: Fade, cross-fade, or fade through.

Scrolling
Image lists can scroll vertically or horizontally. All items in an image list must scroll together as a collection. Image cropping can be used to indicate scroll direction.
Scaling and adaptation
As screen sizes increase, there are more opportunities for variation in text and image composition. Large screens can create more space for images and text by swapping lists for image lists.

Types
Standard image list
Standard image lists are best for items of equal importance. They have a uniform container size, ratio, and padding.


1. image list with images only
2. image list with images and text labels

Quilted image list
Quilted image lists emphasize certain items over others in a collection. They use varied container sizes and ratios to create hierarchy across images.


Don't
Woven image list
Woven image lists use alternating container ratios to create a rhythmic layout. A woven image list is best for browsing peer content.

Masonry image list
Masonry image lists use dynamically sized container heights that reflect the aspect ratio of each image. This image list is best used for browsing uncropped peer content.

Theming
Crane Material Theme
This travel app’s image lists have been customized using Material Theming. Areas of customization include color, typography, and shape.

Color
Crane’s image list text uses custom color.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Surface | Surface | Color Opacity | #FFFFFF 100% |
| Text | On Surface | Color Opacity | #000000 87% |
Typography
Crane’s image list text uses custom typography.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Text | Subtitle 1 | Typeface Font Size Case | Raleway Medium 16 Title case |
Shape
Crane’s image lists have custom corner shapes on image containers.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Container | Medium component | Family Size | Round 16;16;16;16dp |
Owl Material Theme
This education app’s image list text has been customized using Material Theming.

Typography
Owl’s image list text uses custom typography.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Text | Subtitle 1 | Typeface Font Size Case | Rubik Medium 16 Title case |
Shape
Owl’s image lists have custom corner shapes on image containers.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Container | Medium component | Family Size | Round 0;0;0;0dp |
Shrine Material Theme
This retail app’s image lists have been customized using Material Theming. Areas of customization include color and typography.

Color
Shrine’s image list text uses custom color.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Surface | Surface | Color Opacity | #FFFBFA 100% |
| Text | On Surface | Color Opacity | #442C2E 100% |
Typography
Shrine’s image list text uses custom typography.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Text | Subtitle 1 | Typeface Font Size Case | Raleway Medium 16 Title case |
Shape
Shrine's image lists have custom corner shapes on image containers.

| Element | Category | Attribute | Value |
|---|---|---|---|
| Container | Medium component | Family Size | Cut 16;16;16;16dp |
Specs
Standard

Quilted

Masonry—mobile

Masonry—desktop


Masonry—tablet

Woven
