在用户输入时验证输入内容

您可以在用户于文本字段中输入内容（例如输入姓名、电子邮件地址、地址或其他联系信息）时验证输入。此验证可以减少错误并节省用户的时间。

结果

有效的文本输入 — **图 1.**一个文本输入字段，其中包含电子邮件验证器，用于显示有效电子邮件地址的错误消息。

包含错误的无效文本输入 — **图 2.**一个文本输入字段，用于在输入无效电子邮件地址时显示出错提示。

版本兼容性

此实现要求您的项目 minSDK 设置为 API 级别 21 或更高级别。

依赖项

在用户输入时验证输入

使用以下代码显示字段输入并在用户输入时验证文本。如果信息未通过验证，错误消息会帮助用户更正输入。

class EmailViewModel : ViewModel() {
    var email by mutableStateOf("")
        private set

    val emailHasErrors by derivedStateOf {
        if (email.isNotEmpty()) {
            // Email is considered erroneous until it completely matches EMAIL_ADDRESS.
            !android.util.Patterns.EMAIL_ADDRESS.matcher(email).matches()
        } else {
            false
        }
    }

    fun updateEmail(input: String) {
        email = input
    }
}

@Composable
fun ValidatingInputTextField(
    email: String,
    updateState: (String) -> Unit,
    validatorHasErrors: Boolean
) {
    OutlinedTextField(
        modifier = Modifier
            .fillMaxWidth()
            .padding(10.dp),
        value = email,
        onValueChange = updateState,
        label = { Text("Email") },
        isError = validatorHasErrors,
        supportingText = {
            if (validatorHasErrors) {
                Text("Incorrect email format.")
            }
        }
    )
}

@Preview
@Composable
fun ValidateInput() {
    val emailViewModel: EmailViewModel = viewModel<EmailViewModel>()
    ValidatingInputTextField(
        email = emailViewModel.email,
        updateState = { input -> emailViewModel.updateEmail(input) },
        validatorHasErrors = emailViewModel.emailHasErrors
    )
}TextSnippets.kt