تحويل الأرقام في Dart بين اللاتينية والعربية والهندية الشرقية، مع حفظ الأصفار الأولى وفصل تطبيع الأرقام عن تنسيق اللغة وحماية النص الفارغ.
حدد نظام الأرقام الذي تقصده
الأرقام 0 إلى 9 والرموز ٠ إلى ٩ والرموز ۰ إلى ۹ مجموعات محارف مختلفة. تسمية كل تحويل عربي أو إنجليزي قد تخفي أي مجموعة تدعمها الدالة فعلًا. المثال يطبع المجموعتين العربية والهندية الشرقية إلى ASCII، ثم يتيح عرض أرقام عربية من النتيجة المطَبعة. لا يفترض أن اختيار اللغة العربية يعني نظام أرقام واحدًا لكل مستخدم أو سوق. سياسة المنتج وخدمة البيانات تحددان الشكل المطلوب، وليس locale.languageCode وحده في جميع الحالات.
احتفظ بالقيمة كنص عند الحاجة
رقم هاتف أو رمز بريدي أو معرف قد يحتوي أصفارًا أولى ذات معنى. تحويله إلى int ثم إرجاعه إلى String يزيلها، بينما استبدال محارف الأرقام يحافظ عليها. لا تستخدم هذا التطبيع لتغيير كلمة مرور أو توقيع أو قيمة تحتاج تطابقًا حرفيًا دون عقد واضح. كذلك علامة الناقص والفاصل العشري وفاصل الآلاف ليست أرقامًا، والدالة تتركها كما هي. بعد التطبيع قد تحتاج parser وقواعد مختلفة للحسابات، فلا تدّع أن النص أصبح عددًا صالحًا لمجرد تبديل محارفه.
تنفيذ واضح للمحارف
toAsciiDigits يمر على runes، ويستبدل نطاقي الأرقام المحددين ويحافظ على بقية المحارف بما فيها النص العربي والرموز. ثم toArabicDigits يحول أرقام ASCII في النص المطبع إلى المجموعة العربية المختارة. هذا لا يشكل مكتبة تنسيق أرقام دولية ولا يعالج جميع أنظمة Unicode الرقمية. إذا احتجت نسبًا مئوية وعملات وتجميع خانات وتنسيقًا حسب locale فاختر أدوات تنسيق مناسبة واختبر عقد العرض والإدخال بدل تكبير سلسلة replaceAll دون نهاية.
الأحرف الأولى نطاق منفصل
الكود القديم كان يصل إلى str[0] دون حماية النص الفارغ، ويعرض تكبير أول حرف كأنه صالح لكل لغة. المثال يوفر capitalizeLatinInitials فقط لحروف a-z بعد بداية النص أو مسافة، ويحافظ على بقية النص. العربية لا تملك مفهومي upper وlower بالطريقة نفسها، وUnicode قد يجمع محارف متعددة في وحدة مرئية. لا تستعمل substring على أول code unit لتدعي دعم كل أسماء البشر. إذا كان المنتج يحتاج title case دوليًا فحدد اللغات والقواعد واختبر مكتبة ملائمة.
لا تغير المؤشر مع كل حرف
تغيير controller.text داخل onChanged قد يحرك المؤشر أو يتعارض مع composing الخاص بلوحة المفاتيح. المثال ينفذ التحويل بزر ويعرض النتيجة منفصلة، فلا يمس مسودة المستخدم أثناء الإدخال. في منتج يتطلب تطبيعًا لحظيًا تحتاج TextInputFormatter أو تدفقًا يحترم selection وcomposing. لا تعدل الخط ليخفي الفرق بين محارف مختلفة عندما تحتاج الخدمة قيمًا محددة؛ تشابه الرسم لا يغير البيانات التي تُرسل أو تُنسخ إلى الحافظة.
خطة الفحص
اختبر النص الفارغ والمجموعات الثلاث مختلطة والأصفار الأولى والأسطر المتعددة والرموز، ثم تأكد أن المحارف غير الرقمية لم تتغير. اختبر طلب Latin initials مع مسافات متتابعة ونص عربي، ولا تتوقع تغييرًا في حروف ليست ضمن السياسة المعلنة. راجع ما الذي يُحفظ وما الذي يُعرض للمستخدم إذا اختلفت الصيغتان. هذا المثال لا يحدد لغة الواجهة أو اتجاهها ولا يترجم نصوص التطبيق؛ هو دوال نصية محدودة يمكن اختبارها مستقلة قبل ربطها بحقول وخدمات حقيقية.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
String toAsciiDigits(String input) => String.fromCharCodes(input.runes.map((r) {
if (r >= 0x0660 && r <= 0x0669) return 0x30 + r - 0x0660;
if (r >= 0x06F0 && r <= 0x06F9) return 0x30 + r - 0x06F0;
return r;
}));
String toArabicDigits(String input) => String.fromCharCodes(toAsciiDigits(input).runes.map((r) => r >= 0x30 && r <= 0x39 ? 0x0660 + r - 0x30 : r));
String capitalizeLatinInitials(String input) => input.replaceAllMapped(RegExp(r'(^|\s)([a-z])'), (m) => '${m[1]}${m[2]!.toUpperCase()}');
class DemoPage extends StatefulWidget {
const DemoPage({super.key});
@override
State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
final _input = TextEditingController(text: '٠١2 ۳ flutter dart');
String _result = '';
@override
void dispose() { _input.dispose(); super.dispose(); }
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Digit normalization')),
body: ListView(padding: const EdgeInsets.all(16), children: [
TextField(controller: _input, decoration: const InputDecoration(labelText: 'Source text')),
Wrap(spacing: 8, runSpacing: 8, children: [
TextButton(onPressed: () => setState(() { _result = toAsciiDigits(_input.text); }), child: const Text('ASCII digits')),
TextButton(onPressed: () => setState(() { _result = toArabicDigits(_input.text); }), child: const Text('Arabic digits')),
TextButton(onPressed: () => setState(() { _result = capitalizeLatinInitials(_input.text); }), child: const Text('Latin initials')),
]),
SelectableText(_result),
]),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.







