الدالة ()append‎ في 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;
}

مصادر