أنواع لوحة المفاتيح وإجراءات إدخال النص

class RegistrationForm extends StatefulWidget {
  const RegistrationForm({super.key});

  @override
  State<RegistrationForm> createState() => _RegistrationFormState();
}

class _RegistrationFormState extends State<RegistrationForm> {
  final _formKey = GlobalKey<FormState>();
  final _nameFocus    = FocusNode();
  final _emailFocus   = FocusNode();
  final _phoneFocus   = FocusNode();
  final _ageFocus     = FocusNode();

  @override
  void dispose() {
    _nameFocus.dispose();
    _emailFocus.dispose();
    _phoneFocus.dispose();
    _ageFocus.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        children: [
          // لوحة مفاتيح نصية افتراضية؛ الإجراء ينتقل إلى حقل البريد الإلكتروني
          TextFormField(
            focusNode: _nameFocus,
            keyboardType: TextInputType.text,
            textInputAction: TextInputAction.next,
            decoration: const InputDecoration(labelText: 'الاسم الكامل'),
            onFieldSubmitted: (_) =>
                FocusScope.of(context).requestFocus(_emailFocus),
          ),

          // لوحة بريد إلكتروني (@، . سهلة الوصول)؛ الإجراء ينتقل للهاتف
          TextFormField(
            focusNode: _emailFocus,
            keyboardType: TextInputType.emailAddress,
            textInputAction: TextInputAction.next,
            decoration: const InputDecoration(labelText: 'البريد الإلكتروني'),
            onFieldSubmitted: (_) =>
                FocusScope.of(context).requestFocus(_phoneFocus),
          ),

          // لوحة اتصال هاتفية (+، *، #)؛ الإجراء ينتقل لحقل العمر
          TextFormField(
            focusNode: _phoneFocus,
            keyboardType: TextInputType.phone,
            textInputAction: TextInputAction.next,
            decoration: const InputDecoration(labelText: 'رقم الهاتف'),
            onFieldSubmitted: (_) =>
                FocusScope.of(context).requestFocus(_ageFocus),
          ),

          // لوحة أرقام فقط؛ تم يُغلق لوحة المفاتيح
          TextFormField(
            focusNode: _ageFocus,
            keyboardType: TextInputType.number,
            textInputAction: TextInputAction.done,
            decoration: const InputDecoration(labelText: 'العمر'),
            onFieldSubmitted: (_) => _submitForm(),
          ),

          ElevatedButton(
            onPressed: _submitForm,
            child: const Text('تسجيل'),
          ),
        ],
      ),
    );
  }

  void _submitForm() {
    if (_formKey.currentState!.validate()) {
      _formKey.currentState!.save();
      // معالجة التسجيل…
    }
  }
}

// --- حقل البحث ---
// textInputAction.search يعرض أيقونة عدسة مكبّرة على زر الإجراء.
// اربط رد الاتصال لتشغيل منطق البحث فوراً.
TextField(
  keyboardType: TextInputType.text,
  textInputAction: TextInputAction.search,
  decoration: const InputDecoration(
    prefixIcon: Icon(Icons.search),
    hintText: 'ابحث عن منتجات…',
    border: OutlineInputBorder(),
  ),
  onSubmitted: (query) => _runSearch(query),
),

// --- حقل ملاحظات متعدد الأسطر ---
// keyboardType.multiline يجب اقترانه بـ maxLines != 1 حتى يتوسع الحقل.
// textInputAction.newline يبقي مفتاح Enter كسطر جديد حقيقي
// بدلاً من إغلاق لوحة المفاتيح.
TextField(
  keyboardType: TextInputType.multiline,
  textInputAction: TextInputAction.newline,
  maxLines: 5,
  decoration: const InputDecoration(
    labelText: 'ملاحظات',
    alignLabelWithHint: true,
    border: OutlineInputBorder(),
  ),
),

// --- حقل سعر عشري ---
// numberWithOptions(decimal: true) يعرض فاصل الأرقام العشرية
// على لوحة الأرقام، الذي يغيب عن TextInputType.number البسيط في بعض الأجهزة.
TextField(
  keyboardType: const TextInputType.numberWithOptions(decimal: true),
  textInputAction: TextInputAction.done,
  decoration: const InputDecoration(
    labelText: 'السعر',
    prefixText: 'ر.س ',
  ),
),