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