التحقق من الحقول: الأقنعة وregex والحدود

مبدأ التحقق

يستخدم tikento تحققاً على مستويين:

1. العميل (blur) — فحص عند مغادرة الحقل. تغذية راجعة فورية للمشارك.
2. الخادم (backend) — فحص متكرر عند إرسال النموذج. يضمن صحة البيانات.

يُعد Backend المصدر الوحيد للحقيقة. حتى إذا تم تجاوز تحقق العميل، سيرفض الخادم البيانات غير الصحيحة.

القواعد المدمجة حسب أنواع الحقول

لكل نوع من أنواع الحقول الـ 14 قواعد قياسية:

إعداد التحقق

إلزامية الحقل

مفتاح تبديل «حقل إلزامي» في إعدادات الحقل. إذا كان مفعلاً، لن يتمكن المشارك من إرسال النموذج دون ملء هذا الحقل.

نمط Regex

للحقول النصية يمكنك تحديد تعبير نظامي لفحص شكل الإدخال:

1. افتح إعدادات الحقل في منشئ النماذج.
2. ابحث عن قسم «التحقق».
3. في حقل «نمط Regex» أدخل التعبير النظامي.
4. في حقل «رسالة الخطأ» حدد النص الذي سيراه المشارك عند عدم التطابق.

أمثلة:

• رقم ضريبي (12 رقماً): ^\d{12}$
• سلسلة ورقم جواز السفر: ^\d{4}\s?\d{6}$
• أحرف عربية فقط: ^[\u0600-\u06FF\s-]+$

الحد الأدنى والأقصى

للحقول الرقمية حدد الحدود:

• min — القيمة الدنيا المسموحة
• max — القيمة القصوى المسموحة

للحقول النصية:

• minLength — الحد الأدنى لطول النص
• maxLength — الحد الأقصى لطول النص

تحقق Blur

يُفعّل التحقق عندما يغادر المشارك الحقل (يفقد التركيز). يعطي تغذية راجعة فورية:

• يُحدد الحقل بالأحمر
• تظهر رسالة خطأ تحت الحقل
• يمكن للمشارك تصحيح الإدخال فوراً

عند العودة إلى الحقل وتصحيح الخطأ يختفي التحديد والرسالة.

الرسائل المترجمة

جميع رسائل الخطأ القياسية مترجمة إلى اللغات المدعومة (ru، en، es، ar، it، de، fr). يرى المشارك الرسالة بلغة النموذج.

للرسائل المخصصة يمكنك تحديد الترجمة لكل لغة:

1. في إعدادات الحقل افتح قسم «التحقق».
2. اضغط على أيقونة الترجمة بجانب حقل «رسالة الخطأ».
3. أدخل النصوص للغات المطلوبة.

إذا لم تُحدد الترجمة، تُستخدم سلسلة fallback: اللغة المطلوبة، الروسية، الإنجليزية، مفتاح الخطأ.

التحقق عند التنقل بين الخطوات

في النماذج متعددة الخطوات يتم التحقق قبل الانتقال إلى الخطوة التالية. لن يتمكن المشارك من الانتقال للأمام حتى تُملأ جميع الحقول الإلزامية في الخطوة الحالية بشكل صحيح.