متى تستخدم هذه الدوال؟
استخدم الدالة المفضلة في أي إعداد جديد. تسجل هذه البدائل لفهم الإعدادات القائمة وترحيلها بوضوح. معظمها ليس جزءاً من بيئة تشغيل قالب المستند.طريقة الكتابة
استخدم الدالة بصيغةtoLowercase($.service_name). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
endWith
اسم توافق قديم لفحص نهاية النص بلاحقة محددة. استخدم endsWith(value, suffix) في الإعدادات الجديدة.
التوقيع: endWith(value, suffix)
مثال:
value | endWith(...).
flat
اسم توافق قديم يسطّح مستوى واحداً من قائمة متداخلة. استخدم flatten(list) في الإعدادات الجديدة.
التوقيع: flat(list)
مثال:
value | flat(...).
formatDate
اسم توافق قديم لتنسيق التاريخ. استخدم dateFormat(date, format) في الإعدادات الجديدة.
التوقيع: formatDate(date, format)
مثال:
value | formatDate(...).
get
اسم توافق قديم يقرأ قيمة متداخلة عبر مسار نصي. استخدم getByPath(value, path) في الإعدادات الجديدة.
التوقيع: get(value, path)
مثال:
value | get(...).
replaceFirst
اسم توافق قديم يستبدل أول ظهور مطابق فقط داخل النص. استخدم الدالة الحديثة المناسبة بعد اختبار قيمة البحث والاستبدال.
التوقيع: replaceFirst(value, search, replacement)
مثال:
value | replaceFirst(...).
sort
دالة توافق تنسخ القائمة وترتب قيمها رقمياً عندما يكون ذلك ممكناً. استخدم sortAsc أو sortDesc أو sortBy في الإعدادات الجديدة.
التوقيع: sort(list, direction = "asc")
مثال:
value | sort(...).
sortByField
اسم توافق قديم لترتيب قائمة حسب حقل. استخدم sortBy(list, field, direction) في الإعدادات الجديدة.
التوقيع: sortByField(list, field, direction = "asc")
مثال:
value | sortByField(...).
startWith
اسم توافق قديم لفحص بداية النص ببادئة محددة. استخدم startsWith(value, prefix) في الإعدادات الجديدة.
التوقيع: startWith(value, prefix)
مثال:
value | startWith(...).
toLowercase
اسم توافق قديم يحول النص إلى أحرف صغيرة. استخدم lower(value) في أي إعداد جديد.
التوقيع: toLowercase(value)
مثال:
value | toLowercase(...).
toUppercase
اسم توافق قديم يحول النص إلى أحرف كبيرة. استخدم upper(value) في أي إعداد جديد.
التوقيع: toUppercase(value)
مثال:
value | toUppercase(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
