الفرق بين المراجعتين لصفحة: «Sass/set»

مراجعة 16:17، 22 أبريل 2018

تعيد الدالة ()set قائمة جديدة ، بناءً على القائمة المقدمة، ولكن مع استبدال العنصر رقم ‎$n بالقيمة المعطاة.

لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في Sass هو 1، والثاني رقمه 2، وهكذا.

تعالَج قيم الفهرس ‎$n السالبة بترتيب عكسي، بدءًا من آخر عنصر في القائمة.

البنية العامة

set($list, $n, $value)

المعاملات

`‎$list`

القائمة التي ستُسخ، ويُغيّر العنصر فيها رقم ‎$n.

`‎$n`

رقم العنصر الذي سيُعيّن. إن كان سالبًا فسيُحسب من نهاية القائمة.

`‎$value`

القيمة الجديدة للعنصر رقم ‎$n.

القيم المعادة

مرجع دالة.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن لم يكن ‎$n عددًا صحيحا بين 1 و طول القائمة ‎$list.

أمثلة

مثال عن استخدام الدالة set()‎ لضبط قيمة الحواشي (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()‎: تعيد العنصر رقم n في قائمة.
الدالة index()‎: تعيد رقم عنصر في قائمة.

مصادر

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

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