يمكنك التحقّق من صحة البيانات التي يُدخلها المستخدم في حقل نصي، مثل إدخال اسم أو عنوان بريد إلكتروني أو عنوان أو معلومات اتصال أخرى. يقلّل هذا التحقّق من الأخطاء ويوفر وقت المستخدمين.
النتائج
التوافق مع الإصدارات
يتطلّب هذا التنفيذ ضبط minSDK لمشروعك على مستوى واجهة برمجة التطبيقات 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 ) }
نقاط أساسية حول الرمز البرمجي
- يحدّد هذا الرمز البرمجي دالة قابلة للإنشاء تعيد استخدام مكوّن
OutlinedTextField، مع إضافة المَعلمات المطلوبة لعرض رسائل الخطأ الخاصة بأداة التحقّق من صحة البيانات أثناء كتابة المستخدم. - يتم استخدام
EmailViewModelللحفاظ على الحالة وتوفير منطق التحقّق من صحة البريد الإلكتروني. - إذا كانت قيمة
isErrorهي "صحيح"، تقدّم واجهة المستخدم مؤشرًا مرئيًا لحالة خطأ في التحقّق من صحة البيانات. - سيعرض المكوّن الرسالة "تنسيق البريد الإلكتروني غير صحيح" إلى أن يتم إدخال عنوان بريد إلكتروني كامل وصحيح.
المجموعات التي تتضمّن هذا الدليل
هذا الدليل جزء من مجموعات "الدليل السريع" المنسّقة التي تغطي أهدافًا أوسع لتطوير تطبيقات Android:
النص الذي يظهر للمستخدم