原生移动开发 / 系统课时
输入组件与表单校验
输入组件与表单校验
表单不是把几个输入控件摆在一起就结束了,还需要定义每个字段的状态、合法条件和提交门槛。本篇用 TextField、Checkbox、Switch 与 Slider 组成一个可运行表单,并把校验结果直接反馈到界面。
学习目标
- 掌握常用 Compose 输入组件的受控状态写法
- 为文本与必选项建立即时校验规则
- 根据整张表单的合法性控制提交按钮与结果展示
先定义字段和提交规则
本例包含四类输入:昵称使用 TextField,条款确认使用 Checkbox,通知偏好使用 Switch,满意度使用 Slider。真正决定能否提交的条件只有两个:昵称去除首尾空白后至少 2 个字符,并且已经勾选条款。
| 字段 | 组件 | 校验规则 |
|---|---|---|
| 昵称 | TextField |
trim() 后长度至少为 2 |
| 同意条款 | Checkbox |
必须为 true |
| 接收通知 | Switch |
可选,不影响合法性 |
| 满意度 | Slider |
取 1~5 的离散值 |
校验条件应从当前字段状态计算出来,而不是再维护一份“是否有效”的可变状态。这样字段变化后,按钮可用性和错误提示会在同一次重组中得到一致结果。
实现输入与即时校验
下面的代码可直接替换 Compose Activity 模板中的 MainActivity.kt。示例保留一个状态源,并让所有控件都通过 value/checked 与对应回调受控。
package com.example.formvalidation
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Checkbox
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Slider
import androidx.compose.material3.Switch
import androidx.compose.material3.Text
import androidx.compose.material3.TextField
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import kotlin.math.roundToInt
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme {
ProfileForm()
}
}
}
}
@Composable
fun ProfileForm() {
var name by rememberSaveable { mutableStateOf("") }
var acceptedTerms by rememberSaveable { mutableStateOf(false) }
var notificationsEnabled by rememberSaveable { mutableStateOf(false) }
var satisfaction by rememberSaveable { mutableStateOf(3f) }
var submitted by rememberSaveable { mutableStateOf(false) }
val normalizedName = name.trim()
val nameValid = normalizedName.length >= 2
val formValid = nameValid && acceptedTerms
Column(
modifier = Modifier
.fillMaxSize()
.padding(24.dp),
verticalArrangement = Arrangement.spacedBy(12.dp)
) {
TextField(
value = name,
onValueChange = {
name = it
submitted = false
},
modifier = Modifier.fillMaxWidth(),
label = { Text("昵称") },
isError = name.isNotEmpty() && !nameValid,
supportingText = {
if (name.isNotEmpty() && !nameValid) {
Text("昵称至少需要 2 个字符")
}
}
)
Row(verticalAlignment = Alignment.CenterVertically) {
Checkbox(
checked = acceptedTerms,
onCheckedChange = {
acceptedTerms = it
submitted = false
}
)
Text("我已阅读并同意条款")
}
Row(verticalAlignment = Alignment.CenterVertically) {
Switch(
checked = notificationsEnabled,
onCheckedChange = {
notificationsEnabled = it
submitted = false
}
)
Text("接收通知")
}
Text("满意度:${satisfaction.roundToInt()}")
Slider(
value = satisfaction,
onValueChange = {
satisfaction = it
submitted = false
},
valueRange = 1f..5f,
steps = 3,
modifier = Modifier.fillMaxWidth()
)
if (!acceptedTerms) {
Text("提交前必须同意条款")
}
Button(
onClick = { submitted = true },
enabled = formValid
) {
Text("提交")
}
if (submitted) {
val notificationText =
if (notificationsEnabled) "开启通知" else "关闭通知"
Text(
"提交成功:$normalizedName,$notificationText,满意度 ${satisfaction.roundToInt()}"
)
}
}
}预期结果如下。
初始状态:提交按钮不可用,并提示“提交前必须同意条款”
昵称输入 A:显示“昵称至少需要 2 个字符”
昵称输入 Alice 且勾选条款:提交按钮可用
开启通知、把满意度调到 4 后提交:
提交成功:Alice,开启通知,满意度 4Slider 的 valueRange = 1f..5f 配合 steps = 3 会形成 1、2、3、4、5 五个离散位置;最终显示时再用 roundToInt() 转成整数。实际拖动过程仍使用 Float,不要把滑块状态声明成 Int。
把校验保持为可推导结果
nameValid 和 formValid 都由当前输入直接推导,因此没有“字段已经改变,但合法标记忘记更新”的风险。对于更复杂的表单,可以把规则提取为纯函数,或者把整份表单状态提升到 ViewModel,但仍应尽量保持“原始输入是状态,校验结论是派生值”。
客户端校验只能改善交互体验,不能替代服务端校验。真正提交到接口时仍要在服务端重新验证长度、权限和业务约束;客户端则负责尽早告诉用户哪里不满足要求,并阻止明显无效的提交。
当输入值、错误提示和按钮启用条件都来自同一组状态时,表单的行为会更容易预测:控件只负责采集输入,校验规则负责判断合法性,提交动作只在整体合法时执行。