شارك المقالة
التحقق المبدئي من صيغة البريد الإلكتروني في Flutter

التحقق المبدئي من صيغة البريد الإلكتروني في Flutter

فحص مبدئي لصيغة البريد الإلكتروني في Flutter دون اشتراط .com، مع توضيح حدود regex والفرق بين شكل العنوان وإثبات ملكيته.

فحص مبدئي لصيغة البريد الإلكتروني في Flutter دون اشتراط .com، مع توضيح حدود regex والفرق بين شكل العنوان وإثبات ملكيته.

الصيغة ليست ملكية

نجاح فحص الشكل لا يثبت أن صندوق البريد موجود أو أن المستخدم يملك الوصول إليه. إذا احتاج المنتج إثبات الملكية فاستخدم رسالة تحقق أو تدفقًا معتمدًا على الخادم، مع صلاحية ومعدل محاولات مناسبين. لا تنشئ طلبًا إلى مزود البريد مباشرة من كل حرف يكتبه المستخدم. يمكن أن يفشل إرسال رسالة إلى عنوان صحيح مؤقتًا لأسباب تشغيلية، لذلك لا تخلط فشل التسليم مع قرار نهائي بأن الصيغة غير صالحة.

لا تشترط com

العناوين قد تنتهي بنطاقات مختلفة ولها نطاقات فرعية، لذلك البحث عن @ و.com وحدهما ليس تحققًا مناسبًا. وفي regex النقطة غير المهربة تعني محرفًا عامًا وليست نقطة حرفية، كما أن غياب حد نهاية قد يسمح بقبول بادئة من نص غير صالح. ابدأ من سياسة العناوين التي يدعمها منتجك، ثم اختر parser أو أداة موثوقة إذا احتجت تغطية أوسع. لا تدّع أن تعبيرًا مختصرًا يطبق جميع تفاصيل معايير البريد الدولية.

مثال فحص أولي محدود

المثال يمنع الفراغ وغياب الفاصل وبعض الأخطاء الشائعة، ويتحقق أن جزء النطاق يحتوي نقطة وفق سياسة تطبيق تجريبية. لا يحاول تغطية local-part المقتبس أو كل صيغ Unicode وIDN، وقد يقبل بعض القيم التي سيرفضها التحقق النهائي. نذكر هذا الحد حتى لا يتحول المثال إلى مرجع شامل خاطئ. إذا كان منتجك يدعم عناوين دولية أو قواعد أخرى فاختبر مكتبة تناسبها واعتمد عقد الخادم نفسه بدل استبعاد مستخدمين بتعبير مبسط.

التطبيع وحالة الأحرف

يمكن إزالة مسافات محيطة أدخلت بالخطأ عندما تنص سياسة الإدخال على ذلك، لكن لا تحذف مسافات داخلية أو تغيّر كل العنوان بلا فهم. اسم النطاق غير حساس للحالة عادة، بينما لا تفترض أن تطبيع الجزء المحلي كله قرار آمن لكل نظام. احفظ الشكل المطلوب حسب عقد الخدمة، وقارن بما يتفق مع آلية الحساب لا بما يبدو متشابهًا بصريًا فقط. تجنب تغيير النص في controller عند كل حرف لأن ذلك قد يحرك المؤشر ويزعج المستخدم.

تجربة الحقل

استخدم TextInputType.emailAddress كتلميح للوحة المفاتيح، وليس ضمانًا أن النص بريد. تعطيل autocorrect في هذا الحقل قد يمنع تعديلات غير مقصودة، وLTR يمكن أن يناسب عنوانًا تقنيًا داخل واجهة عربية مع إبقاء label والرسائل مترجمة. لا تسجل العنوان مع بيانات حساسة في Console أو analytics بلا حاجة. validator يعرض مشكلة شكل فقط، بينما رد الخادم قد يشير إلى حساب غير متاح أو تدفق تحقق؛ صمم تلك الرسائل بما يناسب خصوصية المنتج.

حالات المراجعة

اختبر عنوانًا بنطاق فرعي وplus tag ونهاية غير com، ثم غياب @ ووجود فراغ ونقطة مفقودة. جرّب عناوين دولية ضمن سياسة مشروعك بدل افتراض دعمها من نجاح تعبير بسيط. اختبر إعادة المحاولة في تدفق الرسالة والتحقق من انتهاء الرابط على الخادم، ولا تعرض نجاح فحص الشكل بوصفه Email verified. في المثال زر الفحص يعلن اجتياز الفحص المبدئي فقط ولا يرسل بريدًا ولا ينشئ حسابًا ولا يتحقق من DNS.

مثال مستقل للتجربة

شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.

import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
String? validateEmail(String? input) {
  final value = (input ?? '').trim();
  if (value.isEmpty) return 'Email is required';
  if (!RegExp(r'^[^\s@]+@[^\s@]+\.[^\s@]+$').hasMatch(value)) {
    return 'Check the email format';
  }
  final local = value.split('@').first;
  if (local.startsWith('.') || local.endsWith('.') || local.contains('..')) {
    return 'Check the email format';
  }
  return null; // Preliminary check only; not proof of ownership.
}
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
  final _key = GlobalKey<FormState>();
  final _email = TextEditingController();
  @override
  void dispose() { _email.dispose(); super.dispose(); }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Email format')),
    body: Form(key: _key, child: ListView(padding: const EdgeInsets.all(16), children: [
      TextFormField(controller: _email, validator: validateEmail,
        keyboardType: TextInputType.emailAddress, textDirection: TextDirection.ltr,
        autocorrect: false, decoration: const InputDecoration(labelText: 'Email')),
      ElevatedButton(onPressed: () {
        if (_key.currentState?.validate() ?? false) {
          ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text('Preliminary format check passed')));
        }
      }, child: const Text('Check format')),
    ])),
  );
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

How to check vail email or no in Flutter
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع