شارك المقالة
شاشة PIN في Flutter مع التحقق غير المتزامن وحماية الإدخال

شاشة PIN في Flutter مع التحقق غير المتزامن وحماية الإدخال

بناء شاشة PIN في Flutter بمكون واضح للتحقق غير المتزامن، مع إخفاء الإدخال ومنع الطلبات المكررة وعدم طباعة الرمز أو…

بناء شاشة PIN في Flutter بمكون واضح للتحقق غير المتزامن، مع إخفاء الإدخال ومنع الطلبات المكررة وعدم طباعة الرمز أو اعتباره مصادقة بذاته.

واجهة إدخال وليست تفويضًا

رسم ست خانات أو إخفاء الأرقام لا يحمي بيانات الخادم تلقائيًا. يجب أن يحدد نظامك أين يتحقق الرمز وما العملية المسموح بها بعد النجاح. لا تحفظ رمزًا ثابتًا داخل Dart وتقارنه محليًا لتفويض إجراء حساس، ولا تطبع الإدخال كما فعل المثال السابق. المكون أدناه يستقبل verify callback من طبقة خدمتك ويبلغ الواجهة بالنتيجة، دون اختراع Backend أو تخزين اعتماد خاص داخل Widget.

فصل PIN الدائم عن OTP

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

طلب واحد ورسائل مفهومة

عند الإرسال يقفل المكون الزر حتى يكتمل Future، ويعالج فشل الخدمة دون كشف تفاصيل داخلية. لا تسمح بإطلاق طلبين بالنقر السريع، ولا تنفذ setState أو تنقلًا بعد إغلاق الشاشة. قيود المحاولات والمهل والتفويض يفرضها الخادم أو آلية القفل المناسبة، لأن تعطيل زر على الهاتف يمكن تجاوزه. امسح الرمز بعد نجاحه ولا تخزنه في Analytics أو crash logs.

مكون يمكن تشغيله دون حزمة مجهولة

النص القديم قدم API لحزمة Git دون إرفاق تحقق كاف من عقدها؛ المثال الجديد يستخدم TextField وTextInputFormatter القياسيين في Flutter، فلا يحتاج قارئه إلى class غير متاح. مرر verify وonVerified من الصفحة المستضيفة. إذا اخترت حزمة عرض أخرى لاحقًا فاحتفظ بنفس فصل المسؤوليات، واختبر دعم RTL وتكبير الخط والقارئ الصوتي بدل اختيار الحزمة على شكل الصور فقط.

اختبار الحالات الحدية

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

المثال البرمجي

ضع المكون داخل مشروع Flutter وصفحة مناسبة في MaterialApp. الكود التالي مثال مستقل للجزء المشروح، ولا يعتمد على ملفات تطبيق خارجي غير مرفقة. راجع المتطلبات المذكورة في النص، خاصة الخط والحزم في مثال PDF.

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class PinEntry extends StatefulWidget {
  const PinEntry({super.key, required this.verify, required this.onVerified});
  final Future<bool> Function(String pin) verify;
  final VoidCallback onVerified;
  @override
  State<PinEntry> createState() => _PinEntryState();
}
class _PinEntryState extends State<PinEntry> {
  final _controller = TextEditingController();
  bool _busy = false;
  String? _error;

  Future<void> _submit() async {
    if (_busy) return;
    final pin = _controller.text;
    if (!RegExp(r'^\d{6}$').hasMatch(pin)) {
      setState(() => _error = 'أدخل ستة أرقام');
      return;
    }
    setState(() { _busy = true; _error = null; });
    try {
      final accepted = await widget.verify(pin);
      if (!mounted) return;
      if (accepted) {
        _controller.clear();
        widget.onVerified();
      } else {
        setState(() => _error = 'تعذر التحقق من الرمز');
      }
    } catch (_) {
      if (mounted) setState(() => _error = 'تعذر الاتصال، حاول لاحقًا');
    } finally {
      if (mounted) setState(() => _busy = false);
    }
  }
  @override
  void dispose() { _controller.dispose(); super.dispose(); }
  @override
  Widget build(BuildContext context) => Column(mainAxisSize: MainAxisSize.min, children: [
    TextField(
      controller: _controller, enabled: !_busy, obscureText: true,
      autocorrect: false, enableSuggestions: false,
      keyboardType: TextInputType.number,
      inputFormatters: [FilteringTextInputFormatter.digitsOnly, LengthLimitingTextInputFormatter(6)],
      decoration: InputDecoration(labelText: 'رمز التحقق', errorText: _error),
      onSubmitted: (_) => _submit(),
    ),
    const SizedBox(height: 12),
    ElevatedButton(onPressed: _busy ? null : _submit,
      child: Text(_busy ? 'جارٍ التحقق' : 'تحقق')),
  ]);
}

المصدر ومراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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