الدالة ()append في Sass
< Sass
تُضيف الدالة append() قيمة محدَّدة إلى قائمةٍ ما.
ما لم يُمرَّر المعامل $separator، فستستعمل المسافة البيضاء لفصل عناصر القائمة التي ستُعيدها الدالة إن كانت القائمة أحاديةً.
تعيد الدالة ()append، مثل بقيَّة دوال القوائم، قائمة جديدةً بدلًا من تغييرها موضعيًا.
البنية العامة
append($list, $val, $separator: auto)
المعاملات
$list
القائمة التي ستُجرى عليها العمليَّة.
val$
القيمة التي ستُضاف إلى القائمة.
$separator
الفاصلة المُستخدمة لفصل عناصر القائمة. إن كانت فاصلةً أو مسافةً، فستُستخدم تلك القيمة الممرّرة. أما إن كانت قيمتها auto (القيمة الافتراضيَّة)، فسيُحدَّد الفاصل كما شرحنا سابقًا.
القيم المعادة
تُعاد القائمة $list بعد إضافة العنصر $val إليها.
أمثلة
مثال عن استخدام الدالة append() لضبط قيمة الحواشي (padding):
.selector {
padding: append((10px 20px), 30px); // 10px 20px 30px
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
padding: 10px 20px 30px; }