الفرق بين المراجعتين ل"Sass/set"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة الصفحة وتدقيقها.) |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()set_nth</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()set_nth</code> في Sass}}</noinclude> | ||
| − | + | تعيد الدالة <code>()set_nth</code> قائمة جديدة، بناءً على القائمة المُمرَّرة، بعد تبديل القيمة المعطاة مكان قيمة العنصر ذي الترتيب <code>$n</code>. | |
| + | لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| سطر 10: | سطر 11: | ||
=== <code>$list</code> === | === <code>$list</code> === | ||
| − | القائمة التي | + | القائمة التي ستُنسخ والتي ستُغيّر قيمة العنصر ذي الترتيب <code>$n</code> فيها. |
=== <code>$n</code> === | === <code>$n</code> === | ||
| − | رقم العنصر | + | رقم ترتيب العنصر المراد تغييره. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة. |
=== <code>$value </code> === | === <code>$value </code> === | ||
| − | القيمة الجديدة للعنصر | + | القيمة الجديدة للعنصر ذي الترتيب <code>$n</code>. |
== القيم المعادة == | == القيم المعادة == | ||
| − | القائمة بعد | + | تُعاد القائمة <code>$list</code> بعد إجراء عمليَّة التبديل. |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن لم | + | سيُرمى الخطأ <code>ArgumentError</code> إن لم تكن قيمة المعامل <code>$n</code> عددًا صحيحًا واقعًا بين 1 وطول القائمة <code>$list</code>. |
== أمثلة == | == أمثلة == | ||
| سطر 37: | سطر 38: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * لدالة <code>[[Sass/nth|nth()]]</code>: تعيد | + | * لدالة <code>[[Sass/nth|nth()]]</code>: تعيد قيمة عنصر ذي ترتيب محدَّد في القائمة. |
| − | * الدالة <code>[[Sass/index|index()]]</code>: تعيد رقم عنصر في | + | * الدالة <code>[[Sass/index|index()]]</code>: تعيد رقم عنصر محدَّد في القائمة. |
== مصادر == | == مصادر == | ||
مراجعة 16:04، 12 مايو 2018
تعيد الدالة ()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(): تعيد رقم عنصر محدَّد في القائمة.