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

مراجعة 11:41، 21 أبريل 2018

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

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

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

index($list, $value)

المعاملات

`‎$list`

قائمة.

`‎$value`

قيمةٌ ما.

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

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

أمثلة

مثال عن استخدام الدالة index()‎:

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

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

.selector {
   padding: 10px 20px 30px 40px;
   font-family: "Times New Roman", Times, serif;
}

انظر أيضًا

الدالة append()‎: تُضيف عنصرًا إلى قائمة.

الدالة zip()‎: تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد.
الدالة list_separator()‎: تعيد فاصلة القائمة.

مصادر

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

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