Charts
Chartsanimated

Pictograph

An isotype pictograph where filled person glyphs encode a proportion.

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 Pictograph(
    total: Int = 10,
    filled: Int = 7,
    accent: Color = Color(0xFF6366F1),
    modifier: Modifier = Modifier,
) {
    val progress = remember { Animatable(0f) }
    LaunchedEffect(Unit) { progress.animateTo(filled.toFloat(), tween(1000, easing = EaseOutCubic)) }
    val empty = MaterialTheme.colorScheme.surfaceVariant
    Row(modifier, horizontalArrangement = Arrangement.spacedBy(6.dp)) {
        repeat(total) { i ->
            val on = i < progress.value
            Icon(
                Icons.Filled.Person,
                contentDescription = null,
                tint = if (on) accent else empty,
                modifier = Modifier.size(22.dp),
            )
        }
    }
}