الفرق بين المراجعتين ل"Sass/set"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()set</code> في Sass}}</noinclude> الدالة <code>()set</code> مرجعًا إلى دالة من أجل استدع...') |
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
||
(7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: الدالة <code>() | + | <noinclude>{{DISPLAYTITLE: الدالة <code>()set_nth</code> في Sass}}</noinclude> |
− | الدالة <code>() | + | تعيد الدالة <code>()set_nth</code> قائمة جديدة، بناءً على القائمة المُمرَّرة، بعد تبديل القيمة المعطاة مكان قيمة العنصر ذي الترتيب <code>$n</code>. |
− | |||
− | |||
+ | لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | + | set_nth($list, $n, $value) | |
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
− | === <code>$ | + | === <code>$list</code> === |
− | + | القائمة التي ستُنسخ والتي ستُغيّر قيمة العنصر ذي الترتيب <code>$n</code> فيها. | |
− | === <code>$ | + | === <code>$n</code> === |
− | + | رقم ترتيب العنصر المراد تغييره. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة. | |
+ | |||
+ | === <code>$value </code> === | ||
+ | القيمة الجديدة للعنصر ذي الترتيب <code>$n</code>. | ||
== القيم المعادة == | == القيم المعادة == | ||
− | + | تُعاد القائمة <code>$list</code> بعد إجراء عمليَّة التبديل. | |
+ | |||
+ | == الأخطاء والاستثناءات == | ||
+ | سيُرمى الخطأ <code>ArgumentError</code> إن لم تكن قيمة المعامل <code>$n</code> عددًا صحيحًا واقعًا بين 1 وطول القائمة <code>$list</code>. | ||
== أمثلة == | == أمثلة == | ||
− | مثال عن استخدام | + | مثال عن استخدام الدالة <code>set_nth()</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>):<syntaxhighlight lang="sass"> |
− | + | .selector { | |
+ | padding: set-nth($list: 10px 20px 30px 30px, $n: 2, $value: 15px); // 10px 15px 30px 30px | ||
+ | } | ||
− | + | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة [[CSS]] الآتية:<syntaxhighlight lang="css"> | |
− | + | .selector { | |
+ | padding: 10px 15px 30px 30px; } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[Sass/ | + | * الدالة <code>[[Sass/nth|nth()]]</code>: تعيد قيمة عنصر ذي ترتيب محدَّد في القائمة. |
+ | * الدالة <code>[[Sass/index|index()]]</code>: تعيد رقم عنصر محدَّد في القائمة. | ||
== مصادر == | == مصادر == | ||
− | * [https://sass-lang.com/documentation/Sass/Script/Functions.html# | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#set_nth-instance_method قسم الدالة set في صفحة الدوال في توثيق Sass الرسمي]. |
− | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
− | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:01، 20 مايو 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()
: تعيد رقم عنصر محدَّد في القائمة.