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

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

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

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

set_nth($list, $n, $value)

المعاملات

‎$list

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

‎$n

رقم ترتيب العنصر المراد تغييره. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة. 

‎$value 

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

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

تُعاد القائمة ‎$list بعد إجراء عمليَّة التبديل.

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

سيُرمى الخطأ 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()‎: تعيد قيمة عنصر ذي ترتيب محدَّد في القائمة.
• الدالة index()‎: تعيد رقم عنصر محدَّد في القائمة.

مصادر

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