الدالة ()set_nth
في Sass
< 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()
: تعيد رقم عنصر محدَّد في القائمة.