Skip to main content

متى تستخدم هذه الدوال؟

تعيد دوال التحقق 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 والقوائم الفارغة.
  • لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
  • راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
دوال التحقق في KayanOS