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