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

المراجعة الحالية بتاريخ 06:59، 20 مايو 2018

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

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

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

index($list, $value)

المعاملات

`‎$list`

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

`‎$value`

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

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

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

أمثلة

أمثلة نموذجية عن استخدام الدالة 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()‎: تعيد الفاصلة المستعملة في القائمة.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>()index</code> في Sass}}</noinclude>
+تعيد الدالة <code>index()‎</code> موضع عنصرٍ في القائمة. إن لم يكن العنصر موجودًا فستعيد القيمة العدميَّة (null).
-تجمع الدالة <code>index'''()‎'''</code> قائمتين في قائمة واحدة.
-ما لم يُمرّر <code>‎$separator</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)]].
+==البنية العامة==
-ما لم يُمرر <code>‎$bracketed</code>، فستوضع القائمة الناتجة بين أقواس مربعة إن كان المعامل الأول كذلك.
-مثل كل دوال القوائم، فإن <code>index'''()‎'''</code> تُعيد قائمةً جديدةً بدلًا من تعديل الوسائط موضعيًا.
-== البنية العامة ==
 <syntaxhighlight lang="sass">
-join($list1, $list2, $separator: auto, $bracketed: auto)
+index($list, $value)
 </syntaxhighlight>
+==المعاملات==
-== المعاملات ==
+===<code>‎$list</code>===
+القائمة التي تحتوي على القيمة <code>‎$value</code>.
-=== <code>‎$list1</code> ===
+===<code>‎$value</code>===
-القائمة الأولى.
+القيمة المراد معرفة ترتيب موضعها.
+==القيم المعادة==
-=== <code>‎$list2</code> ===
+يُعاد عدد يمثل موضع القيمة <code>‎$value</code> في القائمة <code>‎$list</code>، أو تُعاد القيمة <code>null</code> إن لم تكن تلك القيمة موجودة في القائمة.
-القائمة الثانية.
+==أمثلة==
+أمثلة نموذجية عن استخدام الدالة <code>index()‎</code>:<syntaxhighlight lang="sass">
-=== <code>‎$separator</code> ===
+index(1px solid red, solid) // 2
-فاصل القائمة الذي سيُستخدم. سواءً كانت قيمته <code>comma</code> أو <code>space</code>، فسيُستخدم هذا الفاصل. وإن كانت قيمته <code>auto</code> (القيمة الافتراضية)، فسيُحدّد الفاصل كما هو موضح أعلاه.
+index(1px solid red, dashed) // null
+index((width: 10px, height: 20px), (height 20px)) // 2
-=== <code>‎$bracketed</code> ===
-يُحدد ما إذا كانت القائمة الناتجة ستوضع بين قوسين مربعين. إن كانت قيمته <code>auto</code> (القيمة الافتراضية)، فستُحدّد الأقواس كما هو موضح أعلاه.
-== القيم المعادة ==
-القائمة الناتجة عن تجميع القائمتين.
-== الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>‎$number</code> عددًا لا وحدة له.
-== أمثلة ==
-مثال عن استخدام الدالة <code>join()‎</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>) والهوامش (<code>[[CSS/font-family|font-family]]</code>):<syntaxhighlight lang="sass">
-.selector {
-   padding: join(10px 20px, 30px 40px) // 10px 20px 30px 40px
-   font-family: join(("Times New Roman", Times), serif) // "Times New Roman", Times, serif;
-}
-</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css">
-.selector {
-   padding: 10px 20px 30px 40px;
-   font-family: "Times New Roman", Times, serif;
-}
 </syntaxhighlight>
+==انظر أيضًا==
+*الدالة <code>[[Sass/append|append()]]</code>‎: تُضيف عنصرًا إلى قائمة.
-== انظر أيضًا ==
+*الدالة <code>[[Sass/zip|zip()]]</code>‎: تُضم مجموعة من القوائم في قائمة واحدة متعدِّدة الأبعاد.
-* الدالة <code>[[Sass/append|append'''()''']]</code>'''‎''': تُضيف عنصرًا إلى قائمة.
+*الدالة <code>[[Sass/list separator|list_separator()]]</code>‎: تعيد الفاصلة المستعملة في القائمة.
+==مصادر==
-* الدالة <code>[[Sass/zip|zip()]]</code>‎: تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد.
+*[https://sass-lang.com/documentation/Sass/Script/Functions.html#index-instance_method قسم الدالة index في صفحة الدوال في توثيق Sass الرسمي].<noinclude>{{DISPLAYTITLE: الدالة <code>()index</code> في Sass}}</noinclude>
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-== مصادر ==
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#join-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
-[[تصنيف:Sass]]
-[[تصنيف: Sass Function]]