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

مراجعة 15:54، 3 مايو 2018

تُعيد الدالة nth()‎ العنصر ذا الموضع المحدَّد في القائمة الممرَّرة إليها.

انتبه إلى أنَّ ترتيب موضع العنصر الأول في قائمة Sass هو 1 والعنصر الثاني 2 وهكذا خلافًا لبعض اللغات.

يمكن لهذه الدالة أن تُعيد الزوج مفتاح/قيمة ذا الموضع المحدَّد في خريطة (map).

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

nth($list, $n)

المعاملات

`‎$list`

القائمة أو الخريطة المراد جلب عنصر أو زوج منها.

`‎$n`

قيمة عدديَّة تمثِّل موضع العنصر (أو الزوج مفتاح/قيمة) المراد الحصول عليه. إن كانت قيمة هذا المعامل سالبة، فيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة.

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

يُعاد العنصر ذو الموضع ‎$n من القائمة أو الخريطة ‎$list.

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

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

أمثلة

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

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

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

.selector {
  width: 10px;
}

انظر أيضًا

الدالة ()length: تعيد طول القائمة الممرَّرة إليها.
الدالة index()‎: تعيد رقم موضع العنصر المعطى في القائمة.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude>
-تُعيد الدالة <code>nth()‎</code> العنصر ذا الرقم n (عدد) في قائمة. لاحظ أنه على عكس بعض اللغات ، العنصر الأول في قوائم Sass يكون رقمه <code>1</code>، والعنصر الثاني <code>2</code>، وهكذا. يمكن لهذه الدالة أن تُعيد الزوج رقم n في قاموس. لاحظ أنَّ القيم السالبة تُحسب بترتيب عكسي ، بدءًا من آخر عنصر في القائمة.
+تُعيد الدالة <code>nth()‎</code> العنصر ذا الموضع المحدَّد في [[Sass/SassScript#.D8.A7.D9.84.D9.82.D9.88.D8.A7.D8.A6.D9.85|القائمة]] الممرَّرة إليها.
+انتبه إلى أنَّ ترتيب موضع العنصر الأول في قائمة Sass هو 1 والعنصر الثاني 2 وهكذا خلافًا لبعض اللغات.
+يمكن لهذه الدالة أن تُعيد الزوج مفتاح/قيمة ذا الموضع المحدَّد في [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|خريطة]] (map).
 == البنية العامة ==
@@ سطر 10: / سطر 14: @@
 === <code>‎$list</code> ===
-قائمة.
+القائمة أو الخريطة المراد جلب عنصر أو زوج منها.
 === <code>‎$n</code> ===
-مؤشر العنصر الذي نريد الحصول عليه. المؤشرات السلبية تُحسب من نهاية القائمة.
+قيمة عدديَّة تمثِّل موضع العنصر (أو الزوج مفتاح/قيمة) المراد الحصول عليه. إن كانت قيمة هذا المعامل سالبة، فيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة.
 == القيم المعادة ==
-عنصر من القائمة.
+يُعاد العنصر ذو الموضع <code>‎$n</code> من القائمة أو الخريطة <code>‎$list</code>.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$n</code> عددًا صحيحًا بين 1 و طول القائمة.
+سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$n</code> عددًا صحيحًا بين 1 وطول القائمة <code>‎$list</code>.
 == أمثلة ==
-مثال عن استخدام الدالة <code>nth()‎</code>  لضبط قيمة العرض (<code>[[CSS/width|width]]</code>):<syntaxhighlight lang="sass">
+المثال 1: استخدام الدالة <code>nth()‎</code>  لضبط قيمة العرض (<code>[[CSS/width|width]]</code>).<syntaxhighlight lang="sass">
 .selector {
    width: nth(10px 20px 30px, 1) // 10px
@@ سطر 33: / سطر 37: @@
 == انظر أيضًا ==
-* الدالة <code>[[Sass/str length|str_length()]]</code>‎: تُعيد الدالة عدد حروف سلسلة نصية.
+* الدالة <code>[[Sass/length|()length]]</code>: تعيد طول القائمة الممرَّرة إليها.
-* الدالة <code>[[Sass/str insert|str_insert()]]</code>‎: تُدرج سلسة نصية في أخرى.
+* الدالة <code>[[Sass/index|index()]]</code>‎: تعيد رقم موضع العنصر المعطى في القائمة.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#nth-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#nth-instance_method قسم الدالة nth في صفحة الدوال في توثيق Sass الرسمي.]
 [[تصنيف:Sass]]
 [[تصنيف: Sass Function]]