原生移动开发 / 系统课时
Composable 函数
Composable 函数
这一课聚焦 Compose 最常用的构建单元:Composable 函数。你会从调用规则、参数设计和组件拆分三个角度,把一个界面拆成可复用、状态来源清晰的小组件,而不是把所有状态和布局都堆进一个函数。
学习目标
- 掌握
@Composable函数的基本声明与调用规则 - 用参数和事件回调设计可复用组件
- 按职责拆分组件,并让状态拥有者保持清晰
Composable 的基本规则
使用 @Composable 标记的函数可以在组合阶段描述 UI,也可以调用其他 Composable。普通函数不能直接调用 Composable,因为 Composable 调用需要 Compose 提供的组合上下文。反过来,Composable 仍然可以调用普通的纯计算函数。
Composable 通常不返回 View 对象,而是通过调用其他 Composable 描述界面。它还可能被重复执行、跳过部分调用,甚至在后续重组中以不同顺序运行,因此函数体应尽量保持无副作用。
用参数表达输入,用回调表达事件
可复用组件最好把“显示什么”作为参数,把“发生了什么”通过回调交给调用方处理。这样组件无需知道状态保存在哪里,也不需要直接修改外部对象。
下面基于已启用 Compose 与 Material 3 的 Android 项目。父组件 ProfileScreen 持有状态,子组件 UserCard 只接收数据和事件回调;这种写法也称为状态提升。
package com.example.composebasics
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
ProfileScreen()
}
}
}
@Composable
fun ProfileScreen() {
var isOnline by remember { mutableStateOf(false) }
UserCard(
name = "Ada",
isOnline = isOnline,
onToggleOnline = { isOnline = !isOnline }
)
}
@Composable
fun UserCard(
name: String,
isOnline: Boolean,
onToggleOnline: () -> Unit,
modifier: Modifier = Modifier
) {
Column(modifier = modifier.padding(24.dp)) {
Text(text = "User: $name")
Text(text = if (isOnline) "Status: Online" else "Status: Offline")
Button(onClick = onToggleOnline) {
Text(text = "Toggle status")
}
}
}预期结果
初始显示 User: Ada 和 Status: Offline。
每次点击 Toggle status,状态在 Online 与 Offline 之间切换。UserCard 没有保存 isOnline,因此同一个组件既能由本地状态驱动,也能接入 ViewModel、Flow 或其他状态源。参数描述组件当前所需数据,回调让父层决定如何处理事件。
参数设计要让职责一眼可见
必需数据优先做成非空、无默认值的参数,这样调用方无法遗漏关键输入。Modifier 通常作为可选参数暴露,让外层控制尺寸、间距和点击等修饰,而不是把页面级布局策略写死在组件内部。
事件参数使用动词表达意图,例如 onToggleOnline、onRetry、onItemClick,比把整个可变状态对象传给子组件更清晰。子组件拿到事件回调后,只报告“发生了什么”,不决定业务状态应该怎样持久化。
什么时候应该拆分组件
拆分不是越细越好。一个区域具备独立职责、会被复用、需要单独预览测试,或能够形成清晰的状态边界时,拆成独立 Composable 通常有价值。反之,只包一层 Text、没有语义也不复用的函数,往往只是增加跳转成本。
组件边界确定后,继续检查状态所有权:状态应放在所有需要读写它的组件能够共同访问的最低层级,再通过参数向下传递。这样既保持单向数据流,也能避免多个组件各自保存同一份状态而产生不同步问题。
最后记住一个边界:Composable 是可重新执行的 UI 描述函数,不是“只执行一次的初始化函数”。把输入、状态和事件职责分清,再按语义拆分组件,Compose 界面会更容易复用、测试和维护。