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

مراجعة 18:17، 20 أبريل 2018

تُعيد الدالة nth()‎ العنصر رقم n (عدد) في قائمة.

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

يمكن لهذه الدالة أن تُعيد الزوج رقم n في قاموس.

القيم السالبة تُحسب بترتيب عكسي ، بدءًا من آخر عنصر في القائمة.

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

nth($list, $n)

المعاملات

`‎$list`

قائمة.

`‎$n`

مؤشر العنصر الذي نريد الحصول عليه. المؤشرات السلبية تُحسب من نهاية القائمة.

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

عنصر من القائمة.

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

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

أمثلة

مثال عن استخدام الدالة nth()‎ لضبط قيمة العرض (width):

selector {
  width: nth(10px 20px 30px, 1) // 10px
}

سيُصرّف المثال السابق إلى شيفرة CSS الآتية:

selector {
  width: 10px;
}

انظر أيضًا

الدالة str_length()‎: تُعيد الدالة عدد حروف سلسلة نصية.
الدالة str_insert()‎: تُدرج سلسة نصية في أخرى.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude>
-تُعيد الدالة <code>nth'''()‎'''</code> عدد حروف '''السلسلة النصية.'''
+تُعيد الدالة <code>nth'''()‎'''</code> العنصر  رقم n (عدد) في قائمة.
+====== لاحظ أنه على عكس بعض اللغات ، العنصر الأول في قوائم Sass يكون رقمه <code>1</code>، والرقم الثاني <code>2</code>، وهكذا. ======
+يمكن لهذه الدالة أن تُعيد الزوج رقم n في قاموس.
+القيم السالبة تُحسب بترتيب عكسي ، بدءًا من آخر عنصر في القائمة.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-nth($string)
+nth($list, $n)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$string </code> ===
+=== <code>‎$list</code> ===
-سلسلة نصّية.
+قائمة.
+=== <code>‎$n</code> ===
+مؤشر العنصر الذي نريد الحصول عليه. المؤشرات السلبية تُحسب من نهاية القائمة.
 == القيم المعادة ==
-عدد أحرف السلسلة النصية.
+عنصر من القائمة.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$string</code> سلسةً نصّيةً.
+سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$n</code> عددًا صحيحًا بين 1 و طول القائمة.
+== أمثلة ==
+مثال عن استخدام الدالة <code>nth()‎</code>  لضبط قيمة العرض ([[CSS/width|width]]):<syntaxhighlight lang="sass">
+selector {
+  width: nth(10px 20px 30px, 1) // 10px
+}
+</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
+selector {
+  width: 10px;
+}
+</syntaxhighlight>
 == انظر أيضًا ==
-* الدالة <code>[[Sass/unquote|unquote()]]</code>‎: إزالة علامات الاقتباس من سلسلةنصية مُقتبسة.
+* الدالة <code>[[Sass/str length|str_length()]]</code>‎: تُعيد الدالة عدد حروف سلسلة نصية.
 * الدالة <code>[[Sass/str insert|'''str_insert'''()]]</code>‎: تُدرج سلسة نصية في أخرى.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#str_length-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#nth-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
 [[تصنيف:Sass]]
 [[تصنيف: Sass Function]]