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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude> تُعيد الدالة <code>nth'''()‎'''</code> عدد حروف '''السلسلة...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude>
 
<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">
 
<syntaxhighlight lang="sass">
nth($string)
+
nth($list, $n)
 
</syntaxhighlight>
 
</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>‎: تُدرج سلسة نصية في أخرى.
 
* الدالة <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]]
 
[[تصنيف: Sass Function]]
 
[[تصنيف: Sass Function]]

مراجعة 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()‎: تُدرج سلسة نصية في أخرى.

مصادر