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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()zip</code> في Sass}}</noinclude> تجمع الدالة <code>zip'''()‎'''</code> قائمتين في قائمة وا...'
 
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].'
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()zip</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()zip</code> في Sass}}</noinclude>
تجمع الدالة <code>zip'''()‎'''</code> قائمتين في قائمة واحدة.
تجمع الدالة <code>zip()‎</code> قائمتين في قائمة واحدة.


ما لم يُمرّر <code>‎$separator</code>، إن كانت إحدى القائمتين مفصولةً بفواصل والأخرى مفصولةً بمسافات، فسيُستخدم فاصل المعامل الأول في القائمة الناتجة. وإن كانت كلا القائمتين تحتويان على أقل من عنصرين ، فستُستخدم المسافات في القائمة الناتجة.
ما لم يُمرّر <code>‎$separator</code>، إن كانت إحدى القائمتين مفصولةً بفواصل والأخرى مفصولةً بمسافات، فسيُستخدم فاصل المعامل الأول في القائمة الناتجة. وإن كانت كلا القائمتين تحتويان على أقل من عنصرين ، فستُستخدم المسافات في القائمة الناتجة. ما لم يُمرر <code>‎$bracketed</code>، فستوضع القائمة الناتجة بين أقواس مربعة إن كان المعامل الأول كذلك.


ما لم يُمرر <code>‎$bracketed</code>، فستوضع القائمة الناتجة بين أقواس مربعة إن كان المعامل الأول كذلك.
مثل كل دوال القوائم، فإن <code>zip()‎</code> تُعيد قائمةً جديدةً بدلًا من تعديل الوسائط موضعيًا.
 
مثل كل دوال القوائم، فإن <code>zip'''()‎'''</code> تُعيد قائمةً جديدةً بدلًا من تعديل الوسائط موضعيًا.


== البنية العامة ==
== البنية العامة ==
سطر 29: سطر 27:
== القيم المعادة ==
== القيم المعادة ==
القائمة الناتجة عن تجميع القائمتين.
القائمة الناتجة عن تجميع القائمتين.
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <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>zip()‎</code>:<syntaxhighlight lang="sass">
.selector {
// 1px solid red, 1px dashed green, 3px solid blue
  padding: join(10px 20px, 30px 40px) // 10px 20px 30px 40px
zip(1px 1px 3px, solid dashed solid, red green blue);
  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>
</syntaxhighlight>
== انظر أيضًا ==
== انظر أيضًا ==
* الدالة <code>[[Sass/append|append'''()''']]</code>'''''': تُضيف عنصرًا إلى قائمة.
* الدالة <code>[[Sass/append|append()]]</code>‎: تُضيف عنصرًا إلى قائمة.
 
* الدالة <code>[[Sass/zip|zip()]]</code>‎: تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد.


== مصادر ==
== مصادر ==
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#join-instance_method قسم الدالة  في صفحة الدوال في توثيق Sass الرسمي.]
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#join-instance_method قسم الدالة zip في صفحة الدوال في توثيق Sass الرسمي].
[[تصنيف:Sass]]
[[تصنيف:Sass|{{SUBPAGENAME}}]]
[[تصنيف: Sass Function]]
[[تصنيف: Sass Function|{{SUBPAGENAME}}]]

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

تجمع الدالة zip()‎ قائمتين في قائمة واحدة.

ما لم يُمرّر ‎$separator، إن كانت إحدى القائمتين مفصولةً بفواصل والأخرى مفصولةً بمسافات، فسيُستخدم فاصل المعامل الأول في القائمة الناتجة. وإن كانت كلا القائمتين تحتويان على أقل من عنصرين ، فستُستخدم المسافات في القائمة الناتجة. ما لم يُمرر ‎$bracketed، فستوضع القائمة الناتجة بين أقواس مربعة إن كان المعامل الأول كذلك.

مثل كل دوال القوائم، فإن zip()‎ تُعيد قائمةً جديدةً بدلًا من تعديل الوسائط موضعيًا.

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

join($list1, $list2, $separator: auto, $bracketed: auto)

المعاملات

‎$list1

القائمة الأولى.

‎$list2

القائمة الثانية.

‎$separator

فاصل القائمة الذي سيُستخدم. سواءً كانت قيمته comma أو space، فسيُستخدم هذا الفاصل. وإن كانت قيمته auto (القيمة الافتراضية)، فسيُحدّد الفاصل كما هو موضح أعلاه.

‎$bracketed

يُحدد ما إذا كانت القائمة الناتجة ستوضع بين قوسين مربعين. إن كانت قيمته auto (القيمة الافتراضية)، فستُحدّد الأقواس كما هو موضح أعلاه.

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

القائمة الناتجة عن تجميع القائمتين.

أمثلة

مثال نموذجي عن استخدام الدالة zip()‎:

// 1px solid red, 1px dashed green, 3px solid blue
zip(1px 1px 3px, solid dashed solid, red green blue);

انظر أيضًا

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

مصادر