حقل الكمية والأرقام في نماذج موقعك: متى لا تستخدم type=number
باختصار: حقل type="number" في HTML يبدو الخيار الطبيعي لكل ما فيه أرقام، لكنه مصمم للأعداد التي تزيد وتنقص فعلاً، مثل الكمية وعدد الأشخاص. توضح MDN أنه غير مناسب لقيم تتكون من أرقام لكنها ليست عدداً، مثل الرمز البريدي أو رقم البطاقة، وتقترح لهذه type="tel" أو حقلاً نصياً مع inputmode="numeric". وحتى في حقل الكمية، انتبه إلى الخطوة الافتراضية التي ترفض الكسور، وإلى الأرقام العربية الهندية من لوحة المفاتيح العربية، وإلى أن التحقق في المتصفح لا يغني عن التحقق في الخادم.
أين تظهر المشكلة في متجر صغير
محل قرطاسية في عمّان أضاف إلى موقعه نموذج «طلب جملة للمدارس»: اسم المدرسة، ورقم الهاتف، والكمية من كل صنف، ووزن الورق المطلوب. المطور جعل كل حقل فيه أرقام من نوع number. بعد أسبوعين وصلت شكاوى متفرقة:
- رقم هاتف يبدأ بصفر وصل ناقصاً، أو ظهر في الحقل بأسهم صغيرة غريبة.
- زبون أراد كتابة «2.5» كيلوغرام فرفض النموذج الإرسال دون رسالة واضحة.
- موظفة كتبت الكمية بالأرقام العربية الهندية من لوحة مفاتيح عربية، فظهر الحقل فارغاً عند الإرسال على جهاز، وقُبل على آخر.
لا شيء من هذا «عطل» في المتصفح. هذا سلوك الحقل كما صُمم، مستخدماً في غير مكانه.
متى تستخدم type="number" ومتى لا
القاعدة في MDN صريحة: نوع number يُستخدم فقط للأعداد التدريجية، خاصة حين يكون الزيادة والنقصان بالأسهم مفيداً للمستخدم. وليس مناسباً للقيم التي تتكون من أرقام فقط لكنها ليست عدداً بالمعنى الدقيق.
مناسب لـ: الكمية في السلة، وعدد الأشخاص في الحجز، وعدد الغرف، وعدد القطع في طلب الجملة.
غير مناسب لـ: رقم الهاتف، ورقم الطلب، ورمز الخصم، ورقم الهوية أو العضوية، ورقم لوحة السيارة، والرمز البريدي.
لماذا؟ لأن الرقم «0791234567» ليس عدداً تجمعه أو تطرحه. الصفر في أوله جزء من الرقم، والأسهم التي تزيده واحداً لا معنى لها. لهذه الحقول تقترح MDN استخدام type="tel" أو حقل نصي مع inputmode="numeric" وpattern، فيحصل الزبون على لوحة أرقام في الجوال دون سلوك العدد.
الخطوة الافتراضية ترفض الكسور
تشرح MDN أن خاصية step تحدد الدقة التي يجب أن تلتزم بها القيمة، وأن الخطوة الافتراضية لحقول number هي 1، أي أن الأعداد الصحيحة وحدها مقبولة، ما لم يكن أساس الخطوة نفسه غير صحيح. فإن أدخل الزبون 1.1 تُعد القيمة غير صالحة. وتذكر أن قيماً مثل 1.0 تُقبل لأنها تساوي عدداً صحيحاً.
الحل بحسب MDN: إن أردت كسوراً فاضبط step، مثل step="0.01" لمنزلتين عشريتين، أو step="any" لقبول أي قيمة عشرية.
في مثال المحل: حقل «عدد الرزم» يبقى بخطوة 1، أما «الوزن بالكيلوغرام» فيحتاج step="0.1" أو "any".
الحد الأدنى والأقصى
تذكر MDN أن min وmax تحددان أصغر وأكبر قيمة مقبولة، وأن القيمة خارجهما تفشل في التحقق، وأن المستخدم يستطيع كتابتها يدوياً لكنها تُعد غير صالحة. اضبطهما بما يناسب عملك فعلاً: لا تجعل الحد الأقصى للكمية 10 إن كانت المدارس تطلب مئات، ولا تترك الحد الأدنى بلا قيمة فيكتب أحدهم رقماً سالباً.
الأرقام العربية الهندية
هنا نقطة خاصة بالمواقع العربية. كثير من الزبائن يكتبون من لوحة مفاتيح عربية تُخرج الأرقام ٠١٢٣ بدل 0123، خاصة على الحاسوب. تحذر MDN بشكل عام من أن بعض المتصفحات تسمح بإدخال أحرف غير صالحة في حقل number وبعضها لا. ولم نجد في الصفحة ما يحدد سلوك كل متصفح مع الأرقام العربية الهندية، لذلك:
- اختبر الحقل على المتصفحات الأكثر استخداماً عند زبائنك بلوحة مفاتيح عربية.
- إن وجدت أن القيمة تضيع، ففكّر في حقل نصي مع inputmode="numeric"، ثم حوّل الأرقام العربية الهندية إلى غربية بالكود قبل التحقق والإرسال.
- اعرض رسالة واضحة بالعربية إن رُفضت القيمة، لا حقلاً يفرغ بصمت.
مثال توضيحي لتحويل الأرقام قبل الإرسال
إن اخترت حقلاً نصياً للكمية لتجنب مشكلات الأرقام العربية الهندية، فهذا مثال توضيحي لدالة تحولها إلى أرقام غربية ثم تفحص النتيجة:
function toWesternDigits(s) {
return s.replace(/[٠-٩]/g, d => '٠١٢٣٤٥٦٧٨٩'.indexOf(d));
}
const raw = document.querySelector('#qty').value.trim();
const qty = Number(toWesternDigits(raw));
if (!Number.isInteger(qty) || qty < 1) showError('اكتب الكمية رقماً صحيحاً، مثل 12');
اعرض الرقم بعد التحويل للزبون في ملخص الطلب، حتى يرى ما فهمه النظام من كتابته. وإن كانت لوحات المفاتيح الفارسية شائعة بين بعض زبائنك، فهي تستخدم أشكالاً مختلفة قليلاً للأرقام، فاختبرها أيضاً قبل الاعتماد على التحويل.
التحقق في المتصفح ليس حماية
تقول MDN بوضوح: المستخدم يستطيع العبث بكود HTML، لذلك يجب ألا يُستخدم التحقق في المتصفح لأغراض أمنية، ويجب التحقق في الخادم من أي عملية قد يكون للقيمة فيها أثر أمني. في متجر، هذا يعني أن الكمية والسعر والحدود تُفحص مرة أخرى في الخادم، مهما كانت إعدادات الحقل.
مثال توضيحي لنموذج طلب الجملة
مثال توضيحي لحقول النموذج بعد التصحيح:
<label for="qty">عدد الرزم</label>
<input id="qty" name="qty" type="number" min="1" max="5000" step="1" required>
<label for="weight">الوزن التقريبي بالكيلوغرام</label>
<input id="weight" name="weight" type="number" min="0" step="0.1">
<label for="phone">رقم الهاتف</label>
<input id="phone" name="phone" type="tel" inputmode="tel" autocomplete="tel">
<label for="order">رقم طلب سابق (اختياري)</label>
<input id="order" name="order" type="text" inputmode="numeric" pattern="[0-9]*">
لاحظ أن رقم الطلب السابق نصي رغم أنه أرقام، لأنه معرّف لا عدد.
تفاصيل صغيرة تحسن التجربة
- عرض الحقل: تذكر MDN أن حقول number لا تدعم خاصية size، وأن تغيير عرضها يكون بـ CSS. حقل كمية بعرض الصفحة كلها يبدو غريباً؛ اجعله بعرض يكفي أربعة أو خمسة أرقام.
- الأسهم الصغيرة: مفيدة على الحاسوب لتغيير الكمية بواحد، لكنها صغيرة على الجوال. إن كانت الكمية أهم حقل، فأضف زرين واضحين «+» و«−» بجانبه.
- عجلة الفأرة: في بعض المتصفحات قد يتغير الرقم إذا مرّر المستخدم العجلة والحقل مركّز عليه. إن لاحظت كميات غريبة في الطلبات، فهذا أحد الأسباب المحتملة، واختبره بنفسك.
- القيمة الفارغة: تذكر MDN أن الحقل يُعد صالحاً إن كان فارغاً، إلا إذا أضفت required. لا تفترض أن الكمية موجودة لمجرد أن الحقل من نوع number.
أسئلة شائعة
لماذا لا يقبل الحقل رقماً بفاصلة عشرية؟
لأن الخطوة الافتراضية 1. اضبط step على "0.01" أو "any" بحسب الدقة التي تحتاجها، كما توضح MDN.
هل أستخدم type="number" لرقم الهاتف؟
لا. MDN تذكر أنه غير مناسب لقيم مثل هذه، وتقترح type="tel" أو حقلاً نصياً مع inputmode.
الزبون كتب أرقاماً عربية هندية واختفت القيمة، لماذا؟
سلوك المتصفحات يختلف مع الأحرف غير المتوقعة. اختبر، وإن تكرر ذلك استخدم حقلاً نصياً وحوّل الأرقام بالكود قبل الإرسال.
هل يكفي min وmax لمنع الطلبات الخاطئة؟
لا. هي تساعد الزبون، لكن الحماية الحقيقية في الخادم، كما تؤكد MDN.
إذا كانت نماذج الطلب في موقعك تفقد أرقاماً أو ترفضها دون سبب واضح، تواصل معنا لمراجعة حقولها.