متى تستخدم هذه الدوال؟
استخدم هذه الدوال عندما يعيد الحقل أو التعبير قائمة. اعتبر القائمة الفارغة حالة طبيعية وحدد بوضوح ما ينبغي أن يراه المستخدم عند غياب السجلات المرتبطة.طريقة الكتابة
استخدم الدالة بصيغةsum($.fee_items). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
at
تعيد العنصر الموجود في الموضع المحدد من القائمة، أو قيمة فارغة إذا لم يوجد.
التوقيع: at(arr, index)
مثال:
value | at(...).
average
تعيد المتوسط الحسابي للعناصر الرقمية في القائمة.
التوقيع: average(...args)
مثال:
value | average(...).
chunk
تقسم القائمة إلى قوائم أصغر بالحجم المحدد.
التوقيع: chunk(arr, size)
مثال:
value | chunk(...).
compact
تزيل القيم الفارغة أو غير الصادقة من القائمة وفق تنفيذ الدالة.
التوقيع: compact(arr)
مثال:
value | compact(...).
concat
تضم قائمتين أو أكثر في قائمة واحدة.
التوقيع: concat(...arrays)
مثال:
value | concat(...).
countBy
تجمع عناصر القائمة بعددها وفق مفتاح أو دالة تجميع معطاة.
التوقيع: countBy(arr)
مثال:
value | countBy(...).
difference
تعيد العناصر الموجودة في القائمة الأولى وغير الموجودة في القوائم الأخرى.
التوقيع: difference(...arrays)
مثال:
value | difference(...).
every
تتحقق من أن كل عناصر القائمة تحقق الشرط أو الاختبار المعطى.
التوقيع: every(arr)
مثال:
value | every(...).
fill
تنشئ أو تعدل قائمة بملء نطاق منها بالقيمة المعطاة.
التوقيع: fill(value, length)
مثال:
value | fill(...).
first
تعيد أول عنصر من القائمة.
التوقيع: first(arr)
مثال:
value | first(...).
flatten
تسطح مستوى واحداً من قائمة متداخلة.
التوقيع: flatten(arr)
مثال:
value | flatten(...).
flattenDeep
تسطح كل مستويات القائمة المتداخلة.
التوقيع: flattenDeep(arr)
مثال:
value | flattenDeep(...).
getByPath
تقرأ قيمة متداخلة من كائن أو قائمة عبر مسار نصي آمن.
التوقيع: getByPath(value, path)
مثال:
value | getByPath(...).
intersection
تعيد العناصر المشتركة بين القوائم المعطاة.
التوقيع: intersection(...arrays)
مثال:
value | intersection(...).
join
تضم عناصر القائمة في نص واحد باستخدام فاصل.
التوقيع: join(arr, separator?)
مثال:
value | join(...).
last
تعيد آخر عنصر من القائمة.
التوقيع: last(arr)
مثال:
value | last(...).
max
تعيد أكبر قيمة من قائمة أو من قيم متغيرة العدد. هذه هي صيغة القائمة الفعالة في التسجيل النهائي.
التوقيع: max(values) or max(...values)
مثال:
value | max(...).
min
تعيد أصغر قيمة من قائمة أو من قيم متغيرة العدد. هذه هي صيغة القائمة الفعالة في التسجيل النهائي.
التوقيع: min(values) or min(...values)
مثال:
value | min(...).
none
تتحقق من عدم وجود أي عنصر يحقق الشرط أو الاختبار المعطى.
التوقيع: none(arr)
مثال:
value | none(...).
range
تنشئ قائمة أرقام ضمن نطاق البداية والنهاية والخطوة المعطاة.
التوقيع: range(start, end, step?)
مثال:
value | range(...).
sample
تعيد عنصراً عشوائياً واحداً من القائمة؛ لا تستخدمها في قرار أو قيمة يجب أن تثبت.
التوقيع: sample(arr)
مثال:
value | sample(...).
sampleSize
تعيد عينة عشوائية بالحجم المطلوب من القائمة؛ لا تستخدمها في قيمة عمل محفوظة.
التوقيع: sampleSize(arr, size)
مثال:
value | sampleSize(...).
shuffle
تعيد نسخة عشوائية الترتيب من القائمة؛ لا تستخدمها في رقم أو قرار يجب أن يثبت.
التوقيع: shuffle(arr)
مثال:
value | shuffle(...).
slice
تعيد جزءاً من القائمة بين موضعي البداية والنهاية.
التوقيع: slice(arr, start, end?)
مثال:
value | slice(...).
some
تتحقق من وجود عنصر واحد على الأقل يحقق الشرط أو الاختبار المعطى.
التوقيع: some(arr)
مثال:
value | some(...).
sortAsc
تعيد نسخة من القائمة مرتبة تصاعدياً.
التوقيع: sortAsc(arr)
مثال:
value | sortAsc(...).
sortBy
تعيد نسخة من قائمة الكائنات مرتبة حسب قيمة حقل محدد.
التوقيع: sortBy(arr, field?, direction?)
مثال:
value | sortBy(...).
sortDesc
تعيد نسخة من القائمة مرتبة تنازلياً.
التوقيع: sortDesc(arr)
مثال:
value | sortDesc(...).
sum
تجمع قيماً رقمية في قائمة أو في مدخلات متغيرة العدد. هذه هي صيغة القائمة الفعالة في التسجيل النهائي.
التوقيع: sum(values) or sum(...values)
مثال:
value | sum(...).
union
تضم القوائم المعطاة وتزيل التكرارات.
التوقيع: union(...arrays)
مثال:
value | union(...).
unique
تزيل العناصر المكررة من القائمة مع الاحتفاظ بالعناصر المميزة.
التوقيع: unique(arr)
مثال:
value | unique(...).
zip
تجمع العناصر المتناظرة من قوائم متعددة في قائمة من الصفوف.
التوقيع: zip(...arrays)
مثال:
value | zip(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.


