انتقل إلى المحتوى

نموذج إتمام الطلب بالعربية: لماذا يرفض الحقل الاسم والأرقام؟

لماذا يرفض نموذج الدفع الاسم العربي والأرقام العربية، وكيف تصلح الحقل.

في هذا المقال

يفتح عميل صفحة الدفع في متجرك، ويكتب اسمه «أحمد» ويضغط «متابعة»، فيظهر له أن القيمة لا تطابق التنسيق المطلوب. لا يقول المتصفح إن العربية هي المشكلة، فيجرب مرة ثانية وقد يغلق الصفحة. وأنت لا ترى شيئاً: الصفحة تبدو سليمة، والنموذج يعمل لمن يكتب بالحروف اللاتينية.

قد يكون السبب سمة صغيرة اسمها pattern، كُتبت في قالب منسوخ أو في مقتطف تحقق مأخوذ من شرح إنجليزي. وهذا المقال يمشي على الحقول التي تتعثر بها الصفحة العربية: الاسم، ثم الأرقام، ثم العنوان والهاتف، ثم الملء التلقائي والعناوين، وينتهي بطريقة تختبر بها نموذجك.

كيف يرفض الحقل ما كتبه العميل

السمة pattern تعبير نمطي يجب أن تطابقه القيمة كلها، وتنطبق على حقول text وtel وemail وurl وpassword وsearch، وفق توثيق MDN. ويقرأ المتصفح النمط بالعلَم v الذي يفهم خصائص يونيكود مثل \p{L}. فأي نمط يسمّي حروف اللغة اللاتينية وحدها يرفض العربية بلا استثناء.

وأخفى من ذلك النطاق الذي يبدو كأنه الأبجدية كلها:

html
<!-- يمرّ «محمد» ويُرفض «أحمد» و«إياد» -->
<input id="name" name="full_name" autocomplete="name" pattern="[ا-ي ]{3,40}" />

الألف في يونيكود تأتي بعد الحروف ء أ إ آ ؤ ئ، فتسقط هذه الحروف من النطاق. وفحص قاعدة حقل الاسم يجرّب النمط كما يجرّبه المتصفح على أسماء عربية وعلى أسماء لاتينية لها الطول وعدد الكلمات نفسهما، ويشتكي إذا رفض الأولى وقبل الثانية. والحل أن تسمح بكل الحروف وعلاماتها:

html
<input id="name" name="full_name" autocomplete="name" pattern="[\p{L}\p{M} '\-]{2,60}" />

\p{L} أي حرف، و\p{M} تُبقي الحركات مثل الشدة. أو احذف النمط واكتفِ بـminlength وmaxlength. وتوصي W3C في مقالها عن الأسماء الشخصية ألا تحصر الحقل في ASCII، وأن تسمح بالشرطة والفاصلة العليا والمسافة. وتسأل W3C في المقال نفسه هل تحتاج حقلين للاسم الأول والأخير أصلاً، فليس لكل شخص اسم عائلة، وقد يكتب الاسم بترتيب غير الذي تتوقعه. حقل واحد باسم name وautocomplete="name" يكفي في كثير من النماذج. وإن احتجت الاسم لاتينياً لجواز أو بطاقة، فاطلبه في حقل ثانٍ يقول ذلك في عنوانه. وتحقق من الاسم نفسه في الخادم أيضاً، فالمتصفح ليس كل ما يستقبل النموذج.

الأرقام: ما تكتبه لوحة المفاتيح العربية

قد تكتب لوحة المفاتيح العربية في الجوال الأرقام العربية المشرقية مثل ٠٥٠، والأرقام المنسوخة من نص عربي تحملها معها. أما \d و[0-9] في النمط فلا تطابقان إلا الأرقام الغربية. فيرفض حقل الجوال أو رمز التحقق أو الرمز البريدي رقماً صحيحاً. وقاعدة الأرقام تختبر النمط بأرقام غربية ثم بنظائرها العربية، وتشتكي إن قبل الأولى ورفض الثانية.

اقبل ما يكتبه الناس ثم وحّده قبل أن تخزّنه:

html
<input id="phone" name="phone" type="tel" autocomplete="tel" dir="ltr" pattern="[0-9٠-٩۰-۹]{8,15}" />
js
const EASTERN = '٠١٢٣٤٥٦٧٨٩'
const PERSIAN = '۰۱۲۳۴۵۶۷۸۹'

function toWestern(value) {
  return value.replace(/[٠-٩۰-۹]/g, (digit) => String((EASTERN + PERSIAN).indexOf(digit) % 10))
}

أو اكتب \p{Nd} لتقبل الأرقام العشرية من كل الكتابات. ولا تتوهم أن inputmode="numeric" يحمي الحقل: هو تلميح للوحة المفاتيح ولا يفرض صحة القيمة، كما يوضح MDN.

العنوان والهاتف

العنوان الخليجي عربي بطبعه: «حي الروضة»، «شارع الملك فهد». وقاعدة العنوان تجرّب نمط حقل الشارع والمدينة والحي على خمسة عناوين عربية ونظائرها اللاتينية. السبب المعتاد قالب منسوخ، أو شرط من شركة الشحن لعنوان لاتيني فرضه النموذج على الجميع. اترك الحقل العربي حراً، وإن احتاجت الشركة عنواناً لاتينياً فاطلبه في حقل ثانٍ باسمه.

وللعنوان وجه آخر خارج النموذج، هو بياناتك المنظّمة. يقرأ فاحص صيغة العنوان عناوين PostalAddress في JSON-LD ويطلب الدولة برمز ISO من حرفين مثل SA وOM، والرمز البريدي بأرقام 0 إلى 9 وبصورة بريد دولته. ولا يتحقق أن العنوان حقيقي.

أما الهاتف فمشكلته الاتجاه. في حقل يُعرض من اليمين إلى اليسار تتبدل مقاطع الرقم أماكنها، فيظهر ما كُتب +968 9123 4567 على هيئة 4567 9123 968+، فيظن العميل أنه أخطأ ويعدّل رقماً سليماً. وهذه حالة من النص ثنائي الاتجاه. وتعدّ W3C في مقالها عن الترميز ثنائي الاتجاه الأرقام المنسقة، كأرقام الهواتف، من المواضع التي تحتاج فيها الخوارزمية عوناً. وتذكر القاعدة أن حقل type="tel" يُعرض في Chromium وFirefox وWebKit من اليسار إلى اليمين في الصفحات العربية، وأن حقل type="text" ولو معه inputmode="tel" يأخذ اتجاه الصفحة. لا تعتمد على ذلك، وقل ما تريد صراحة:

html
<label for="phone">رقم الجوال</label>
<input id="phone" name="phone" type="tel" dir="ltr" autocomplete="tel" />
css
#phone {
  text-align: right;
}

text-align يُبقي الحقل محاذياً للصفحة العربية. وتجد التفاصيل في قاعدة اتجاه الهاتف. وتذكّر أن type="tel" قد يفتح لوحة الهاتف في الجوال لكنه لا يتحقق من صيغة الرقم، كما يوضح MDN، فالتحقق عليك.

الملء التلقائي والعناوين

كتابة عنوان بلوحة صغيرة هي أثقل خطوة في الدفع على الجوال، والملء التلقائي يغني عنها. قاعدة الملء التلقائي تبحث عن حقل واضح الغرض، كالبريد والهاتف والاسم والمدينة والشارع والرمز البريدي، ولا autocomplete فيه:

html
<input id="email" name="email" type="email" autocomplete="email" />
<input id="city" name="city" autocomplete="shipping address-level2" />
<input id="street" name="street" autocomplete="shipping street-address" />
<input id="zip" name="zip" autocomplete="shipping postal-code" />

وتطلب WCAG 2.2 أن يُحدَّد غرض الحقل الذي يجمع بيانات المستخدم نفسه برمجياً (المعيار 1.3.5 من المستوى AA)، كما يشرح W3C. ولا تفحص القاعدة أن الرمز صحيح، بل أنه موجود.

والعنوان الظاهر لا يقل أهمية. قاعدة عنوان الحقل تشغّل فحص label من axe-core. اربط <label for="email"> بـid الحقل، أو أعط الحقل الذي بلا نص ظاهر aria-label. والنص المؤقت يقبله axe اسماً، لكنه يختفي حين تبدأ الكتابة، فالعنوان الظاهر أفضل. وقواعد أنماط الاسم والعنوان والأرقام تفحص الصفحات العربية وحدها، أي التي لغتها في <html lang> عربية أو أغلب نصها عربي، فأعلن اللغة والاتجاه: <html lang="ar" dir="rtl">.

نموذج كامل بعد الإصلاح

هذا نموذج توصيل صغير جمع كل ما سبق. لاحظ أن لكل حقل label مربوطاً به، وأن الاسم بلا نمط والمدينة تقبل حروف أي كتابة، وأن الجوال يقبل الأرقام العربية، وأن الهاتف dir="ltr":

html
<label for="name">الاسم الكامل</label>
<input id="name" name="full_name" autocomplete="name" required />

<label for="city">المدينة</label>
<input id="city" name="city" autocomplete="shipping address-level2" pattern="[\p{L}\p{M} \-]{2,40}" />

<label for="phone">رقم الجوال</label>
<input id="phone" name="phone" type="tel" dir="ltr" autocomplete="tel" pattern="[0-9٠-٩۰-۹]{8,15}" title="أرقام فقط، يجوز كتابتها بالعربية" />

السمة title تظهر في المتصفحات عادةً كتلميح يشرح الشرط الذي يطلبه النمط، وهذا ما يوصي به MDN في الصفحة نفسها، فتعوّض شيئاً من رسالة المتصفح العامة. لكنها لا تغني عن رسالة خطأ تكتبها أنت بالعربية في صفحتك.

متاجر المنصات

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

كيف تتحقق

  1. شغّل اختبار النماذج بالعربي: يختبر نمط الاسم بأسماء عربية، ونمط الأرقام بأرقام عربية مشرقية، ويفحص عناوين الحقول.
  2. شغّل اختبار إتمام الطلب: يجمع الاسم والعنوان والجوال والملء التلقائي في فحص واحد.
  3. شغّل فحص حقول الهاتف: يعرض الصفحة في ثلاثة متصفحات ويقرأ اتجاه كل حقل هاتف.
  4. لا ترسل الأدوات النماذج ولا تكتب في حقولها. فاختبر أنت بنفسك على هاتفك بلوحة مفاتيح عربية: اسم فيه همزة، وحي، وجوال بأرقام عربية.

قائمة قبل أن تنشر

  • نمط الاسم والعنوان يقبل \p{L} أو لا نمط فيهما.
  • نمط الجوال والرمز يقبل الأرقام العربية المشرقية، والأرقام تُوحَّد قبل التخزين.
  • حقل الهاتف type="tel" وdir="ltr".
  • لكل حقل <label> مربوط به.
  • لكل حقل واضح الغرض رمز autocomplete من معيار HTML.
  • الخادم يقبل الأسماء والأرقام نفسها التي يقبلها المتصفح.
  • جربت الدفع بلوحة مفاتيح عربية، لا بلوحة مطوّر.