Hintsanimated

Field hint

Inline supporting text under a field that animates into an error state.

priya.codes

Enter a valid email address.

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

@Composable
fun FieldHint(value: String, onValueChange: (String) -> Unit) {
    val valid = value.contains("@")
    val showError = value.isNotEmpty() && !valid
    Column {
        OutlinedTextField(
            value = value,
            onValueChange = onValueChange,
            label = { Text("Email") },
            isError = showError,
            singleLine = true,
        )
        AnimatedVisibility(showError) {
            Text(
                "Enter a valid email address.",
                Modifier.padding(start = 16.dp, top = 4.dp),
                color = MaterialTheme.colorScheme.error,
                style = MaterialTheme.typography.labelSmall,
            )
        }
    }
}