الكيلومتر والكيلوغرام واللتر بالعربية: Intl.NumberFormat للوحدات
باختصار: إن كان موقعك أو تطبيقك يعرض مسافات أو أوزاناً أو أحجاماً، كمسافة التوصيل أو وزن الشحنة أو سعة الخزان، فلا تكتب «كم» و«كغم» يدوياً بجانب الرقم. الدالة Intl.NumberFormat في جافاسكربت تدعم style: "unit" مع وحدة مثل kilometer أو kilogram أو liter، وتختار شكل الوحدة بالعربية وموضعها وصيغتها حسب العدد. وتوضح MDN أن unitDisplay يتحكم في الشكل: قصير أو ضيق أو طويل. انتبه إلى أمرين: الأرقام قد تظهر بالأرقام العربية الهندية افتراضياً، ويمكن تثبيت الأرقام الغربية بـ numberingSystem، وليست كل الوحدات مدعومة، فالمتر المربع مثلاً ليس في القائمة.
أين يظهر هذا في عمل يومي
شركة توصيل مياه وغاز في الزرقاء لديها تطبيق ويب يعرض للزبون: المسافة إلى السائق، وسعة الخزان أو الجالون باللتر، ووزن أسطوانة الغاز. المطور كتب في كل مكان سطراً مثل: الرقم ثم مسافة ثم «كم». بعد فترة ظهرت ملاحظات صغيرة:
- في الواجهة الإنجليزية ظهر «كم» بالعربية.
- «1 لترات» في مكان، و«11 لتر» في آخر، بلا اتساق.
- في بعض الشاشات انعكس ترتيب الرقم والوحدة مع نص من اليمين لليسار.
هذه تفاصيل، لكنها تجعل التطبيق يبدو غير مكتمل.
ما يقدمه style: "unit"
تشرح MDN في توثيق منشئ Intl.NumberFormat أن خيار style يقبل "unit" لتنسيق الوحدات، وأنه إن كان style هو "unit" فيجب تحديد خاصية unit، ولا قيمة افتراضية لها. وتذكر أن الوحدات البسيطة يمكن ربطها بـ "-per-" لصنع وحدة مركبة، مثل kilometer-per-hour.
وخيار unitDisplay، بحسب MDN، يقبل ثلاث قيم:
- "short": الافتراضي، شكل مختصر مع مسافة.
- "narrow": أضيق شكل ممكن.
- "long": الاسم الكامل للوحدة.
كيف تبدو بالعربية فعلاً
جرّبنا الدالة في بيئة Node.js حديثة، الإصدار 22 بمكتبة ICU 78.2، بلغة ar-JO وقيمتين: 2.5 و11. النتائج للأرقام الغربية:
- kilometer: المختصر «2.5 كم»، والطويل «2.5 كيلومتر» و«11 كيلومترًا».
- kilogram: المختصر «2.5 كغم»، والضيق «2.5 كغ»، والطويل «2.5 كيلوغرام».
- liter: المختصر والطويل «2.5 لتر»، والضيق «2.5 ل».
- meter: «2.5 متر» و«11 مترًا».
- kilometer-per-hour: المختصر «كم/س»، والطويل «كيلومتر في الساعة».
لاحظ أن الصيغة الطويلة تتغير مع العدد في بعض الوحدات، كما في «11 كيلومترًا»، وهذا ما لا يفعله نص ثابت تكتبه يدوياً. لكن النتائج قد تختلف قليلاً بين المتصفحات وإصداراتها، لأنها تعتمد على بيانات اللغة المضمّنة في كل منها. اختبر على المتصفحات التي يستخدمها زبائنك.
الأرقام: عربية هندية أم غربية؟
في التجربة نفسها، أعطت لغة ar-JO دون خيارات إضافية الأرقام بالشكل العربي الهندي. إن كان موقعك يستخدم الأرقام الغربية في كل مكان، كما تفعل أغلب المواقع والتطبيقات التجارية في الأردن، فستظهر الوحدات بأرقام مختلفة عن باقي الصفحة.
توضح MDN أن خيار numberingSystem يحدد نظام الترقيم، وأن مفتاح الامتداد nu في وسم اللغة يمكن استخدامه للغرض نفسه، وأنه إن حُدد الاثنان فالخيار في options هو الذي يُعتمد. لذلك:
const km = new Intl.NumberFormat('ar-JO', {
style: 'unit',
unit: 'kilometer',
unitDisplay: 'short',
numberingSystem: 'latn',
maximumFractionDigits: 1
});
km.format(2.46); // "2.5 كم"
أو بوسم اللغة ar-JO-u-nu-latn، وقد أعطى في تجربتنا النتيجة نفسها بالأرقام الغربية.
القرار ليس تقنياً فقط: اختر نظاماً واحداً للأرقام في كل الموقع، والتزم به في الأسعار والكميات والوحدات.
ليست كل الوحدات موجودة
في تجربتنا، أعادت الدالة Intl.supportedValuesOf("unit") قائمة من 45 وحدة، وأحدها ليس square-meter. هذا مهم لمكاتب العقار أو شركات البلاط والعزل التي تحسب بالمتر المربع: لن تجد وحدة جاهزة لذلك، وستحتاج إلى كتابة «م²» بنفسك مع تنسيق الرقم وحده بـ Intl.NumberFormat. وإن مررت وحدة غير مدعومة، تُرمى رسالة خطأ من نوع TypeError، فلا تمرر أسماء الوحدات من مدخلات المستخدم مباشرة.
مثال توضيحي لدالة واحدة للتطبيق كله
مثال توضيحي لجمع التنسيق في مكان واحد:
const fmtCache = {};
function fmtUnit(value, unit, lang = 'ar-JO', display = 'short') {
const key = lang + unit + display;
fmtCache[key] ??= new Intl.NumberFormat(lang, {
style: 'unit', unit, unitDisplay: display,
numberingSystem: 'latn', maximumFractionDigits: 1
});
return fmtCache[key].format(value);
}
fmtUnit(12, 'liter'); // للعربية
fmtUnit(12, 'liter', 'en'); // للإنجليزية
بهذا تتبع الوحدة لغة الواجهة تلقائياً، فلا تظهر «كم» في الصفحة الإنجليزية. والتخزين المؤقت للمنسّق في fmtCache يتجنب إنشاء كائن جديد في كل مرة، وهذا يفيد في قوائم طويلة مثل سجل الطلبات أو قائمة السائقين. وإن أضفت لاحقاً لغة ثالثة، فلا تحتاج إلى تعديل أي شاشة، بل تمرير رمز اللغة فقط. وأي وحدة جديدة تحتاجها، كالميل أو الغالون، تمر عبر الدالة نفسها بعد التأكد أنها في القائمة المدعومة.
نطاقات مثل «10 إلى 12 كغم»
توفر Intl.NumberFormat أيضاً الدالة formatRange لتنسيق نطاق بين قيمتين، وهي مفيدة لعبارات مثل «الوزن التقريبي للطلب» أو «مسافة التوصيل المتوقعة». لكن في تجربتنا على البيئة نفسها، أعطت formatRange لنطاق بالكيلوغرام النتيجة بالأرقام العربية الهندية رغم تحديد numberingSystem: "latn"، بينما احترمت format الخيار نفسه. لا نعرف إن كان هذا السلوك نفسه في كل متصفح، لكنه سبب كافٍ لاختبار كل دالة تستخدمها، لا افتراض أن خياراً يعمل في واحدة يعمل في الأخرى.
الصيغة حسب العدد ليست مثالية دائماً
في الصيغة الطويلة، أعطت التجربة «1 كيلومتر» و«3 كيلومترات» و«100 كيلومتر»، وهذا مقبول. لكنها أعطت «2 كيلومتر» لا «كيلومتران» كما يُكتب في العربية الفصحى. للنصوص المهمة، كإشعار يُقرأ بصوت عالٍ أو رسالة رسمية، راجع الحالات الشائعة عندك، كالواحد والاثنين، واكتب لها نصاً خاصاً إن لزم.
الاتجاه داخل النص العربي
حين تضع الرقم والوحدة داخل جملة عربية، قد يتغير ترتيب العرض إن جاورهما نص لاتيني أو رموز. ضع الناتج داخل عنصر span مستقل، وإن ظهر مقلوباً فجرّب الخاصية dir="auto" أو عنصر bdi حوله. والأهم: اختبر على شاشة حقيقية، لا في الكود فقط.
متى تختار كل شكل
- المختصر: للبطاقات والجداول وأي مكان ضيق، كمسافة السائق.
- الضيق: نادراً، لأيقونات صغيرة جداً.
- الطويل: للنصوص المقروءة والإشعارات الصوتية، مثل «السائق على بعد 3 كيلومترات».
أسئلة شائعة
لماذا تظهر الأرقام عربية هندية في الوحدات وغربية في باقي الصفحة؟
لأن لغة ar-JO قد تستخدم الأرقام العربية الهندية افتراضياً. حدد numberingSystem: "latn" لتوحيدها.
هل توجد وحدة للمتر المربع؟
لم تكن في قائمة الوحدات المدعومة في تجربتنا. نسّق الرقم وحده وأضف «م²» بنفسك.
هل النتيجة واحدة في كل المتصفحات؟
ليس بالضرورة؛ تعتمد على بيانات اللغة في كل متصفح. اختبر على أكثرها استخداماً عند زبائنك.
ما الفرق بين short وlong؟
الأول مختصر مثل «كم»، والثاني الاسم الكامل مثل «كيلومتر»، ويتغير مع العدد في بعض الوحدات.
إذا كانت أرقام موقعك ووحداته غير متسقة بين اللغات والشاشات، تواصل معنا لتوحيدها.