متى تستخدم هذه الدوال؟
استخدم التحويل بعد فهم قيمة المصدر. يمكن للتحويل أن يجعل التعبير مقروءاً، لكنه لا يصلح بيانات مفقودة أو ذات بنية خاطئة.طريقة الكتابة
استخدم الدالة بصيغةisEmpty($.optional_note). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
contains
تتحقق من احتواء النص أو القائمة على القيمة المعطاة.
التوقيع: contains(strOrArr, substring)
مثال:
value | contains(...).
indexOf
تعيد موضع أول ظهور للقيمة في نص أو قائمة، أو قيمة عدم العثور وفق تنفيذ الدالة.
التوقيع: indexOf(str, substring)
مثال:
value | indexOf(...).
isEmpty
تتحقق من قيمة غير صادقة أو قائمة فارغة أو نص فارغ بعد إزالة أطرافه. استخدم فحصاً صريحاً مع الكائنات غير النصية.
التوقيع: isEmpty(value)
مثال:
value | isEmpty(...).
isNotEmpty
تعكس سلوك isEmpty الفعال للقيم والنصوص والقوائم.
التوقيع: isNotEmpty(value)
مثال:
value | isNotEmpty(...).
lastIndexOf
تعيد موضع آخر ظهور للقيمة في نص أو قائمة.
التوقيع: lastIndexOf(str, substring)
مثال:
value | lastIndexOf(...).
length
تعيد طول نص أو قائمة أو قيمة تدعم خاصية طول.
التوقيع: length(strOrArr)
مثال:
value | length(...).
reverse
تعيد نسخة معكوسة من نص أو قائمة حيث يدعم السياق ذلك.
التوقيع: reverse(val)
مثال:
value | reverse(...).
toBoolean
تحول القيمة إلى قيمة منطقية وفق قواعد التحويل.
التوقيع: toBoolean(val)
مثال:
value | toBoolean(...).
toInt
تحول القيمة إلى عدد صحيح عند إمكان ذلك.
التوقيع: toInt(value, radix?)
مثال:
value | toInt(...).
toNumber
تحول القيمة إلى عدد عند إمكان ذلك.
التوقيع: toNumber(val)
مثال:
value | toNumber(...).
toStr
تحول القيمة إلى تمثيل نصي.
التوقيع: toStr(value)
مثال:
value | toStr(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
