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

من موسوعة حسوب

تعيد الدالة ()set_nth قائمة جديدة، بناءً على القائمة المقدمة، ولكن مع استبدال العنصر رقم ‎$n بالقيمة المعطاة.

لاحظ أنه على عكس بعض اللغات، فإنّ رقم العنصر الأول في Sass هو 1، والثاني رقمه 2، وهكذا.

تعالََج قيم الفهرس ‎$n السالبة بترتيب عكسي، أي بدءًا من آخر عنصر في القائمة.

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

set_nth($list, $n, $value)

المعاملات

‎$list

القائمة التي ستُسخ، ويُغيّر العنصر رقم ‎$n فيها.

‎$n

رقم العنصر الذي سيُعيّن. إن كان سالبًا فسيُحسب من نهاية القائمة.

‎$value 

القيمة الجديدة للعنصر رقم ‎$n.

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

القائمة بعد استبدال العنصر.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن لم يكن ‎$n عددًا صحيحا بين 1 و طول القائمة ‎$list.

أمثلة

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

.selector {
  padding: set-nth($list: 10px 20px 30px 30px, $n: 2, $value: 15px) // 10px 15px 30px 30px
}

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

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

انظر أيضًا

  • لدالة nth()‎: تعيد العنصر رقم n في قائمة.
  • الدالة index()‎: تعيد رقم عنصر في قائمة.

مصادر