الدالة ()append‎ في Sass

تُضيف الدالة append()‎ قيمة محدَّدة إلى قائمةٍ ما.

ما لم يُمرَّر المعامل ‎$separator، فستستعمل المسافة البيضاء لفصل عناصر القائمة التي ستُعيدها الدالة إن كانت القائمة أحاديةً.

تعيد الدالة ()append، مثل بقيَّة دوال القوائم، قائمة جديدةً بدلًا من تغييرها موضعيًا.

البنية العامة

append($list, $val, $separator: auto)‎

المعاملات

‎$list

القائمة التي ستُجرى عليها العمليَّة.

val‎$

القيمة التي ستُضاف إلى القائمة.

‎$separator

الفاصلة المُستخدمة لفصل عناصر القائمة. إن كانت فاصلةً أو مسافةً، فستُستخدم تلك القيمة الممرّرة. أما إن كانت قيمتها auto (القيمة الافتراضيَّة)، فسيُحدَّد الفاصل كما شرحنا سابقًا.

القيم المعادة

تُعاد القائمة ‎$list بعد إضافة العنصر ‎$val إليها.

أمثلة

المثال 1: استخدام الدالة append()‎ لضبط قيمة الحواشي (padding):

.selector {
  padding: append((10px 20px), 30px); // 10px 20px 30px
}

سيُصرّف المثال السابق إلى شيفرة CSS الآتية:

.selector {
  padding: 10px 20px 30px;
}

مصادر

• قسم الدالة append في صفحة الدوال في توثيق Sass الرسمي.