Selects
Selects

Combobox

A text field that filters its dropdown options as you type.

ap
Apple
Apricot

Installation

caveui components are copy-paste Jetpack Compose built entirely on Material 3 — there's no caveui dependency to add. Make sure Material 3 is on your classpath (it ships with the Compose BOM), then copy the Usage snippet below into your project.

kotlin
// build.gradle.kts (module)
dependencies {
    implementation(platform("androidx.compose:compose-bom:2025.06.00"))
    implementation("androidx.compose.material3:material3")
}

Usage

kotlin
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun Combobox(all: List<String>) {
    var query by remember { mutableStateOf("") }
    var expanded by remember { mutableStateOf(false) }
    val matches = remember(query) {
        all.filter { it.contains(query, ignoreCase = true) }
    }
    ExposedDropdownMenuBox(
        expanded = expanded,
        onExpandedChange = { expanded = it },
    ) {
        OutlinedTextField(
            value = query,
            onValueChange = { query = it; expanded = true },
            label = { Text("Search fruit") },
            modifier = Modifier.menuAnchor().fillMaxWidth(),
        )
        ExposedDropdownMenu(
            expanded = expanded && matches.isNotEmpty(),
            onDismissRequest = { expanded = false },
        ) {
            matches.forEach { item ->
                DropdownMenuItem(
                    text = { Text(item) },
                    onClick = { query = item; expanded = false },
                )
            }
        }
    }
}