متى تستخدم هذه الدوال؟
تعيد دوال التحقق true عند صحة القيمة ورسالة تحقق محلية عند عدم صحتها. في سياقات تحقق الحقول تُمرر القيمة الحالية تلقائياً عند حذف وسيط القيمة من الدالة.طريقة الكتابة
استخدم الدالة بصيغةv.required($.field). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
v
تعيد true عند تحقق الشرط أو قيمة خطأ محلية عند فشله.
التوقيع: v(condition, error)
مثال:
v.atLeastXYearsOld
تتحقق من بلوغ عمر أدنى محسوب من تاريخ.
التوقيع: v.atLeastXYearsOld(value, years)
مثال:
v.contains
تتحقق من احتواء النص على جزء مطلوب.
التوقيع: v.contains(value, fragment)
مثال:
v.datePattern
تتحقق من أن القيمة تمثل تاريخاً صالحاً.
التوقيع: v.datePattern(value)
مثال:
v.endsWith
تتحقق من انتهاء النص باللاحقة المطلوبة.
التوقيع: v.endsWith(value, suffix)
مثال:
v.equal
تتحقق من مساواة صارمة بالقيمة المتوقعة.
التوقيع: v.equal(value, expected)
مثال:
v.greaterThan
تتحقق من أن قيمة رقمية أكبر من حد معين.
التوقيع: v.greaterThan(value, limit)
مثال:
v.greaterThanOrEqual
تتحقق من أن قيمة رقمية لا تقل عن حد معين.
التوقيع: v.greaterThanOrEqual(value, minimum)
مثال:
v.lessOrEqual
تتحقق من أن قيمة رقمية لا تتجاوز حداً معيناً.
التوقيع: v.lessOrEqual(value, maximum)
مثال:
v.lessThan
تتحقق من أن قيمة رقمية أصغر من حد معين.
التوقيع: v.lessThan(value, limit)
مثال:
v.matchRegex
تتحقق من مطابقة النص لتعبير نمطي.
التوقيع: v.matchRegex(value, pattern)
مثال:
v.maxLength
تتحقق من الحد الأقصى لطول نص أو قائمة.
التوقيع: v.maxLength(value, maximum)
مثال:
v.minLength
تتحقق من الحد الأدنى لطول نص أو قائمة.
التوقيع: v.minLength(value, minimum)
مثال:
v.notOneOf
تتحقق من أن القيمة ليست واحدة من الخيارات المعطاة.
التوقيع: v.notOneOf(value, options)
مثال:
v.oneOf
تتحقق من أن القيمة واحدة من الخيارات المعطاة.
التوقيع: v.oneOf(value, options)
مثال:
v.onlyAlphabets
تتحقق من احتواء القيمة على حروف ومسافات فقط.
التوقيع: v.onlyAlphabets(value)
مثال:
v.onlyAlphabetsOfLanguage
تتحقق من احتواء القيمة على حروف اللغة المختارة ومسافات فقط.
التوقيع: v.onlyAlphabetsOfLanguage(value, language)
مثال:
v.onlyDigits
تتحقق من احتواء القيمة على أرقام ASCII فقط.
التوقيع: v.onlyDigits(value)
مثال:
v.phoneNumber
تتحقق من رقم هاتف بصيغة دولية.
التوقيع: v.phoneNumber(value)
مثال:
v.required
تتحقق من وجود قيمة وأنها ليست فارغة أو مسافات فقط.
التوقيع: v.required(value)
مثال:
v.startsWith
تتحقق من بدء النص بالبادئة المطلوبة.
التوقيع: v.startsWith(value, prefix)
مثال:
v.validEmail
تتحقق من صحة عنوان بريد إلكتروني.
التوقيع: v.validEmail(value)
مثال:
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.


