Build a list using multiple item types

You can use a list with multiple item types to display mixed content types such as text, images, and interactive elements.

Version compatibility

This implementation requires that your project minSDK be set to API level 21 or higher.

Dependencies

Add multiple item types

You can specify the content type for each item of the layout when you compose a list or a grid with multiple types of items:

@Composable
fun ListWithMultipleItems(messages: List<Any>) {
    LazyColumn {
        items(
            messages.size,
            contentType = { it }
        ) {
            for (message in messages)
                when (message) {
                    is MediaStore.Audio -> AudioMessage(message)
                    is Text -> TextMessage(message)
                }
        }
    }
}

@Composable
fun AudioMessage(message: MediaStore.Audio) {
    TODO("Not yet implemented.")
}

@Composable
fun TextMessage(message: Text) {
    TODO("Not yet implemented.")
}

data class SampleMessage(val text: String, val content: Any)
ListWithMultipleItemTypes.kt

Key points about the code

• Specifies the content type for each item by setting contentType in items().
• Maps each content type to a corresponding composable. For example, Audio is a contentType that is defined elsewhere and is mapped to an AudioMessage composable.
• Compose reuses the rendered composables for each item of a given content type.

Results

Collections that contain this guide

This guide is part of these curated Quick Guide collections that cover broader Android development goals:

Have questions or feedback

Go to our frequently asked questions page and learn about quick guides or reach out and let us know your thoughts.

Go to FAQ Leave feedback