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

من موسوعة حسوب
طلا ملخص تعديل
ط مراجعة الصفحة وتدقيقها.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()index</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()index</code> في Sass}}</noinclude>
تعيد الدالة <code>index()‎</code> موضع عنصرٍ في القائمة. إن لم يكن العنصر موجودًا فستعيد القيمة المعدومة <code>null</code>. لاحظ أنه على عكس بعض اللغات ، يكون رقم العنصر الأول في قوائم Sass هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا.
تعيد الدالة <code>index()‎</code> موضع عنصرٍ في القائمة. إن لم يكن العنصر موجودًا فستعيد القيمة العدميَّة (null).
 
لاحظ أنَّ رقم موضع العنصر الأول في [[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>‎$list</code> ===
قائمة.
القائمة التي تحتوي على القيمة <code>‎$value</code>.


=== <code>‎$value</code> ===
=== <code>‎$value</code> ===
قيمةٌ ما.
القيمة المراد معرفة ترتيب موضعها.


== القيم المعادة ==
== القيم المعادة ==
عدد يمثل موضع القيمة <code>‎$value</code> في القائمة، أو <code>null</code> إن لم يكن موجودًا فيها.
يُعاد عدد يمثل موضع القيمة <code>‎$value</code> في القائمة <code>‎$list</code>، أو تُعاد القيمة <code>null</code> إن لم تكن تلك القيمة موجودة في القائمة.


== أمثلة ==
== أمثلة ==
مثال عن استخدام الدالة <code>index()‎</code>:<syntaxhighlight lang="sass">
المثال 1: استخدام الدالة <code>index()‎</code>.<syntaxhighlight lang="sass">
index(1px solid red, solid) // 2
index(1px solid red, solid) // 2
index(1px solid red, dashed) // null
index(1px solid red, dashed) // null
سطر 27: سطر 31:
* الدالة <code>[[Sass/append|append()]]</code>‎: تُضيف عنصرًا إلى قائمة.
* الدالة <code>[[Sass/append|append()]]</code>‎: تُضيف عنصرًا إلى قائمة.


* الدالة <code>[[Sass/zip|zip()]]</code>‎: تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد.
* الدالة <code>[[Sass/zip|zip()]]</code>‎: تُضم مجموعة من القوائم في قائمة واحدة متعدِّدة الأبعاد.
* الدالة <code>[[Sass/list separator|list_separator()]]</code>‎: تعيد فاصلة القائمة.
* الدالة <code>[[Sass/list separator|list_separator()]]</code>‎: تعيد الفاصلة المستعملة في القائمة.


== مصادر ==
== مصادر ==

مراجعة 07:23، 3 مايو 2018

تعيد الدالة index()‎ موضع عنصرٍ في القائمة. إن لم يكن العنصر موجودًا فستعيد القيمة العدميَّة (null).

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

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

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

index($list, $value)

المعاملات

‎$list

القائمة التي تحتوي على القيمة ‎$value.

‎$value

القيمة المراد معرفة ترتيب موضعها.

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

يُعاد عدد يمثل موضع القيمة ‎$value في القائمة ‎$list، أو تُعاد القيمة null إن لم تكن تلك القيمة موجودة في القائمة.

أمثلة

المثال 1: استخدام الدالة index()‎.

index(1px solid red, solid) // 2
index(1px solid red, dashed) // null
index((width: 10px, height: 20px), (height 20px)) // 2

انظر أيضًا

  • الدالة append()‎: تُضيف عنصرًا إلى قائمة.
  • الدالة zip()‎: تُضم مجموعة من القوائم في قائمة واحدة متعدِّدة الأبعاد.
  • الدالة list_separator()‎: تعيد الفاصلة المستعملة في القائمة.

مصادر