الفرق بين المراجعتين ل"Sass/set"

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

مصادر

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

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