Jetpack Compose 动画Modifier.animateItem()

在 Jetpack Compose 中,Modifier.animateItem() 是从 Compose 1.7.0 开始引入的一个强大且常用的修饰符(它替代了早期被废弃的 animateItemPlacement)。

一、 animateItem 的核心作用

Modifier.animateItem() 专门用于 LazyColumn 或 LazyRow 中,为列表项的动态变化提供开箱即用的平滑过渡动画。它能够同时处理以下三种场景:

  1. 位置重排(Reordering /
    Placement):当列表项因为插入、删除或排序改变位置时,它们会平滑地滑动到新位置,而不是瞬间"闪现"。
  2. 出现/插入(Appearance / Fade In):当有新项被插入到列表中时,它会以淡入(Fade In)等动画形式出现。
  3. 消失/删除(Disappearance / Fade Out):当项被从列表中移除时,它会以淡出动画形式消失。

二、 使用的核心前提

必须提供稳定的 key:在 LazyColumn 的 items() 中,必须通过 key 参数为每个 item 指定一个唯一且稳定的标识(如数据的 ID)。如果使用默认的索引(index)或不传 key,Compose 将无法在数据发生变动时正确追踪身份,从而导致动画失效或混乱。

三、 完整代码例子

下面的例子展示了一个包含添加、删除和随机打乱(重排)功能的列表,完美应用了 Modifier.animateItem()

复制代码
data class Task(val id: Int, val title: String)

@Composable
fun AnimatedItemListExample() {
    // 模拟列表数据源
    var tasks by remember {
        mutableStateOf(
            listOf(
                Task(1, "学习 Jetpack Compose"),
                Task(2, "了解 animateItem 作用"),
                Task(3, "编写示例代码")
            )
        )
    }

    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(16.dp)
    ) {
        // 操作按钮区域
        Row(
            modifier = Modifier
                .fillMaxWidth()
                .padding(bottom = 16.dp),
            horizontalArrangement = Arrangement.spacedBy(8.dp)
        ) {
            Button(onClick = {
                val newId = (tasks.maxOfOrNull { it.id } ?: 0) + 1
                // 在顶部插入新项
                tasks = listOf(Task(newId, "新任务 $newId")) + tasks
            }) {
                Text("添加")
            }

            Button(onClick = {
                // 随机打乱列表顺序(测试重排动画)
                tasks = tasks.shuffled()
            }) {
                Text("打乱排序")
            }
        }

        // 列表区域
        LazyColumn(
            modifier = Modifier
                .fillMaxWidth()
                .weight(1f),
            verticalArrangement = Arrangement.spacedBy(8.dp)
        ) {
            // 【关键点】:必须提供 key,否则动画无法正确追踪目标
            items(
                items = tasks,
                key = { task -> task.id }
            ) { task ->
                Card(
                    modifier = Modifier
                        .fillMaxWidth()
                        // 【关键点】:在最外层 Modifier 中链式调用 animateItem()
                        .animateItem(
                            // 可选:自定义动画效果(不传则使用默认的优雅弹簧动画)
                            fadeInSpec = tween(durationMillis = 300),
                            fadeOutSpec = tween(durationMillis = 300),
                            placementSpec = spring(stiffness = 300f)
                        )
                ) {
                    Row(
                        modifier = Modifier
                            .fillMaxWidth()
                            .padding(16.dp),
                        horizontalArrangement = Arrangement.SpaceBetween,
                        verticalAlignment = Alignment.CenterVertically
                    ) {
                        Text(text = task.title, style = MaterialTheme.typography.bodyLarge)
                        
                        IconButton(onClick = {
                            // 删除当前项(测试删除渐隐动画)
                            tasks = tasks.filter { it.id != task.id }
                        }) {
                            Icon(Icons.Default.Delete, contentDescription = "删除")
                        }
                    }
                }
            }
        }
    }
}

四、 自定义动画效果

animateItem() 允许你传参来精确控制各个动画的贝塞尔曲线或物理弹簧效果:

  • fadeInSpec: 控制元素出现时的渐入动画(如 tween(200))。
  • fadeOutSpec: 控制元素消失时的渐出动画(如 tween(200))。
  • placementSpec: 控制元素位置移动时的滑动动画(如默认的 spring() 弹簧效果或 tween())。
相关推荐
Mr_万能胶32 分钟前
官方发布,不烧心的 AOSP 编译提速技巧
android·ci/cd·架构
booboosui1 小时前
安卓 8.1 也能装了:代价是一条黄字和两个静默 bug
android
Ehtan_Zheng4 小时前
Jetpack AppState Transform:让 Compose 的响应式状态走出 UI 层
android
yyuuuzz6 小时前
nginx 502 排查,先看上游超时那一行
android·java·运维·nginx·502
恋猫de小郭10 小时前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
alexhilton20 小时前
MVI 让屏幕一次只有一个状态
android·kotlin·android jetpack
二流小码农1 天前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
阿杰m1 天前
Android源码第十七章:PowerManager 与后台任务——锁屏后怎么跑?
android
JMchen1231 天前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup
2601_967980111 天前
python+appium自动化测试如何控制App的启动和退出
android·自动化测试·python·appium·设备调试