الفرق بين المراجعتين لصفحة: «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>[[Sass/call|()call]]</code>.
+تعيد الدالة <code>()set_nth</code> قائمة جديدة، بناءً على القائمة المُمرَّرة، بعد تبديل القيمة المعطاة مكان قيمة العنصر ذي الترتيب <code>‎$n</code>.
-إن كانت قيمة <code>‎$args</code> تساوي <code>false</code>، فقد يُشير مرجع الدالة إلى دالةٍ معرّفة في ملف الأنماط أو مضمنة في بيئة المضيف. وإن كانت قيمتها <code>false</code> سيشير إلى دالة خاصة بلغة <code>[[CSS]]</code>.
+لاحظ أن رقم ترتيب العنصر الأول في <nowiki/>[[Sass]] هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-set($name, $css: false)
+set_nth($list, $n, $value)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$name</code> ===
+=== <code>‎$list</code> ===
-اسم الدالة التي سيُعاد مرجعها.
+القائمة التي ستُنسخ والتي ستُغيّر قيمة العنصر ذي الترتيب <code>‎$n</code> فيها.
-=== <code>‎$css</code> ===
+=== <code>‎$n</code> ===
-تحدد ما إذا كانت ستُعاد دالة للغة <code>[[CSS]]</code>.
+رقم ترتيب العنصر المراد تغييره. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة.
+=== <code>‎$value </code> ===
+القيمة الجديدة للعنصر ذي الترتيب <code>‎$n</code>.
 == القيم المعادة ==
-مرجع دالة.
+تُعاد القائمة <code>‎$list</code> بعد إجراء عمليَّة التبديل.
+== الأخطاء والاستثناءات ==
+سيُرمى الخطأ <code>ArgumentError</code> إن لم تكن قيمة المعامل <code>‎$n</code> عددًا صحيحًا واقعًا بين 1 وطول القائمة <code>‎$list</code>.
 == أمثلة ==
-مثال عن استخدام الدالة <code>set()‎</code>:<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>set_nth()‎</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>):<syntaxhighlight lang="sass">
-get-function("rgb")
+.selector {
+  padding: set-nth($list: 10px 20px 30px 30px, $n: 2, $value: 15px); // 10px 15px 30px 30px
+}
-@function myfunc { @return "something"; }
+</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة [[CSS]] الآتية:<syntaxhighlight lang="css">
-get-function("myfunc")
+.selector {
+  padding: 10px 15px 30px 30px; }
 </syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/call|call()]]</code>‎: تستدعي دالة بشكل ديناميكي..
+* الدالة <code>[[Sass/nth|nth()]]</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}}]]