الفرق بين المراجعتين ل"Sass/nth"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude> تُعيد الدالة <code>nth'''()'''</code> عدد حروف '''السلسلة...') |
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
||
| (8 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()nth</code> في Sass}}</noinclude> | ||
| − | تُعيد الدالة <code>nth | + | تُعيد الدالة <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). | ||
| + | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
| − | nth($ | + | nth($list, $n) |
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
| − | === <code>$ | + | === <code>$list</code> === |
| − | + | القائمة أو الخريطة المراد جلب عنصر أو زوج منها. | |
| + | |||
| + | === <code>$n</code> === | ||
| + | قيمة عدديَّة تمثِّل موضع العنصر (أو الزوج مفتاح/قيمة) المراد الحصول عليه. إن كانت قيمة هذا المعامل سالبة، فيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة. | ||
== القيم المعادة == | == القيم المعادة == | ||
| − | + | يُعاد العنصر ذو الموضع <code>$n</code> من القائمة أو الخريطة <code>$list</code>. | |
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| − | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>$ | + | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>$n</code> عددًا صحيحًا بين 1 وطول القائمة <code>$list</code>. |
| + | |||
| + | == أمثلة == | ||
| + | مثال عن استخدام الدالة <code>nth()</code> لضبط قيمة العرض (<code>[[CSS/width|width]]</code>) والارتفاع (<code>[[CSS/height|height]]</code>) مع تمرير القيمة <code>1</code> التي ستختار القيمة الأولى من القائمة، والقيمة <code>-1</code> التي ستختار القيمة الأخيرة من القائمة. لاحظ أنَّ بالإمكان استخدام القيمة <code>2</code> أو <code>-2</code> للإشارة إلى القيمة التي في وسط القائمة في مثالنا هذا:<syntaxhighlight lang="sass"> | ||
| + | .selector { | ||
| + | width: nth(10px 20px 30px, 1); // 10px | ||
| + | height: nth(10px 20px 30px, -1); // 30px | ||
| + | } | ||
| + | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | ||
| + | .selector { | ||
| + | width: 10px; | ||
| + | height: 30px; } | ||
| + | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * | + | * الدالة <code>[[Sass/length|()length]]</code>: تعيد طول القائمة الممرَّرة إليها. |
| − | * | + | * الدالة <code>[[Sass/index|index()]]</code>: تعيد رقم موضع العنصر المعطى في القائمة. |
== مصادر == | == مصادر == | ||
| − | * [https://sass-lang.com/documentation/Sass/Script/Functions.html# | + | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#nth-instance_method قسم الدالة nth في صفحة الدوال في توثيق Sass الرسمي]. |
| − | [[تصنيف:Sass]] | + | [[تصنيف:Sass|{{SUBPAGENAME}}]] |
| − | [[تصنيف: Sass Function]] | + | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] |
المراجعة الحالية بتاريخ 07:02، 20 مايو 2018
تُعيد الدالة nth() العنصر ذا الموضع المحدَّد في القائمة الممرَّرة إليها.
انتبه إلى أنَّ ترتيب موضع العنصر الأول في قائمة Sass هو 1 والعنصر الثاني 2 وهكذا خلافًا لبعض اللغات. يمكن لهذه الدالة أن تُعيد الزوج مفتاح/قيمة ذا الموضع المحدَّد في خريطة (map).
البنية العامة
nth($list, $n)
المعاملات
$list
القائمة أو الخريطة المراد جلب عنصر أو زوج منها.
$n
قيمة عدديَّة تمثِّل موضع العنصر (أو الزوج مفتاح/قيمة) المراد الحصول عليه. إن كانت قيمة هذا المعامل سالبة، فيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر في القائمة.
القيم المعادة
يُعاد العنصر ذو الموضع $n من القائمة أو الخريطة $list.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن لم يكن المعامل $n عددًا صحيحًا بين 1 وطول القائمة $list.
أمثلة
مثال عن استخدام الدالة nth() لضبط قيمة العرض (width) والارتفاع (height) مع تمرير القيمة 1 التي ستختار القيمة الأولى من القائمة، والقيمة -1 التي ستختار القيمة الأخيرة من القائمة. لاحظ أنَّ بالإمكان استخدام القيمة 2 أو -2 للإشارة إلى القيمة التي في وسط القائمة في مثالنا هذا:
.selector {
width: nth(10px 20px 30px, 1); // 10px
height: nth(10px 20px 30px, -1); // 30px
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
width: 10px;
height: 30px; }
انظر أيضًا
- الدالة
()length: تعيد طول القائمة الممرَّرة إليها. - الدالة
index(): تعيد رقم موضع العنصر المعطى في القائمة.