الفرق بين المراجعتين لصفحة: «Sass/join»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()join</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()join</code> في Sass}}</noinclude> | ||
تجمع الدالة <code>join | تجمع الدالة <code>join()</code> قائمتين في قائمة واحدة. | ||
ما لم يُمرّر <code>$separator</code>، إن كانت إحدى القائمتين مفصولةً بفواصل والأخرى مفصولةً بمسافات، فسيُستخدم فاصل المعامل الأول في القائمة الناتجة. وإن كانت كلا القائمتين تحتويان على أقل من عنصرين ، فستُستخدم المسافات في القائمة الناتجة. | ما لم يُمرّر <code>$separator</code>، إن كانت إحدى القائمتين مفصولةً بفواصل والأخرى مفصولةً بمسافات، فسيُستخدم فاصل المعامل الأول في القائمة الناتجة. وإن كانت كلا القائمتين تحتويان على أقل من عنصرين ، فستُستخدم المسافات في القائمة الناتجة. وما لم يُمرر <code>$bracketed</code>، فستوضع القائمة الناتجة بين أقواس مربعة إن كان المعامل الأول كذلك. | ||
مثل كل دوال القوائم، فإن <code>join()</code> تُعيد قائمةً جديدةً بدلًا من تعديل الوسائط موضعيًا. | |||
مثل كل دوال القوائم، فإن <code>join | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 31: | سطر 29: | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>join()</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>) | مثال عن استخدام الدالة <code>join()</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>) والخطوط (<code>[[CSS/font-family|font-family]]</code>):<syntaxhighlight lang="sass"> | ||
.selector { | .selector { | ||
padding: join(10px 20px, 30px 40px) // 10px 20px 30px 40px | padding: join(10px 20px, 30px 40px); // 10px 20px 30px 40px | ||
font-family: join(("Times New Roman", Times), serif) // "Times New Roman", Times, serif; | font-family: join(("Times New Roman", Times), serif); // "Times New Roman", Times, serif; | ||
} | } | ||
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <nowiki/>[[CSS]] الآتية:<syntaxhighlight lang="css"> | ||
.selector { | .selector { | ||
| سطر 44: | سطر 43: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/append|append | * الدالة <code>[[Sass/append|append()]]</code>: تُضيف عنصرًا إلى قائمة. | ||
* الدالة <code>[[Sass/zip|zip()]]</code>: تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد. | * الدالة <code>[[Sass/zip|zip()]]</code>: تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد. | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#join-instance_method قسم الدالة | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#join-instance_method قسم الدالة join في صفحة الدوال في توثيق Sass الرسمي.] | ||
[[تصنيف:Sass]] | [[تصنيف:Sass]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function]] | ||
مراجعة 02:35، 22 أبريل 2018
تجمع الدالة join() قائمتين في قائمة واحدة.
ما لم يُمرّر $separator، إن كانت إحدى القائمتين مفصولةً بفواصل والأخرى مفصولةً بمسافات، فسيُستخدم فاصل المعامل الأول في القائمة الناتجة. وإن كانت كلا القائمتين تحتويان على أقل من عنصرين ، فستُستخدم المسافات في القائمة الناتجة. وما لم يُمرر $bracketed، فستوضع القائمة الناتجة بين أقواس مربعة إن كان المعامل الأول كذلك.
مثل كل دوال القوائم، فإن join() تُعيد قائمةً جديدةً بدلًا من تعديل الوسائط موضعيًا.
البنية العامة
join($list1, $list2, $separator: auto, $bracketed: auto)
المعاملات
$list1
القائمة الأولى.
$list2
القائمة الثانية.
$separator
فاصل القائمة الذي سيُستخدم. سواءً كانت قيمته comma أو space، فسيُستخدم هذا الفاصل. وإن كانت قيمته auto (القيمة الافتراضية)، فسيُحدّد الفاصل كما هو موضح أعلاه.
$bracketed
يُحدد ما إذا كانت القائمة الناتجة ستوضع بين قوسين مربعين. إن كانت قيمته auto (القيمة الافتراضية)، فستُحدّد الأقواس كما هو موضح أعلاه.
القيم المعادة
القائمة الناتجة عن تجميع القائمتين.
أمثلة
مثال عن استخدام الدالة join() لضبط قيمة الحواشي (padding) والخطوط (font-family):
.selector {
padding: join(10px 20px, 30px 40px); // 10px 20px 30px 40px
font-family: join(("Times New Roman", Times), serif); // "Times New Roman", Times, serif;
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
padding: 10px 20px 30px 40px;
font-family: "Times New Roman", Times, serif;
}
انظر أيضًا
- الدالة
append(): تُضيف عنصرًا إلى قائمة.
- الدالة
zip(): تُضم مجموعة من القوائم في قائمة واحدة متعددة الأبعاد.