الفرق بين المراجعتين لصفحة: «Sass/append»
< Sass
لا ملخص تعديل |
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].' |
||
| (6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()append</code> في Sass}}</noinclude> | |||
تُضيف الدالة <code>append()</code> قيمة محدَّدة إلى قائمةٍ ما. | |||
ما لم يُمرَّر المعامل <code>$separator</code>، فستستعمل المسافة البيضاء لفصل عناصر القائمة التي ستُعيدها الدالة إن كانت القائمة أحاديةً. | |||
تعيد الدالة <code>()append</code>، مثل بقيَّة دوال القوائم، قائمة جديدةً بدلًا من تغييرها موضعيًا. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 16: | سطر 14: | ||
=== <code>$list</code> === | === <code>$list</code> === | ||
القائمة التي | القائمة التي ستُجرى عليها العمليَّة. | ||
=== <code> | === <code>val$</code> === | ||
القيمة التي ستُضاف إلى القائمة. | القيمة التي ستُضاف إلى القائمة. | ||
=== <code>$separator</code> === | === <code>$separator</code> === | ||
الفاصلة المُستخدمة لفصل عناصر القائمة. إن كانت فاصلةً أو مسافةً، فستُستخدم تلك القيمة الممرّرة. أما إن كانت قيمتها <code>auto</code> (القيمة الافتراضيَّة)، فسيُحدَّد الفاصل كما شرحنا سابقًا. | |||
== القيم المعادة == | == القيم المعادة == | ||
القائمة | تُعاد القائمة <code>$list</code> بعد إضافة العنصر <code>$val</code> إليها. | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>append()</code> لضبط قيمة الحواشي ([[CSS/padding|padding]]):<syntaxhighlight lang="sass"> | مثال عن استخدام الدالة <code>append()</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>):<syntaxhighlight lang="sass"> | ||
.selector { | .selector { | ||
padding: append((10px 20px), 30px); // 10px 20px 30px | |||
} | } | ||
</syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة CSS الآتية:<syntaxhighlight lang="css"> | ||
.selector { | .selector { | ||
padding: 10px 20px 30px; } | |||
} | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#append-instance_method قسم الدالة append في صفحة الدوال في توثيق Sass الرسمي. | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#append-instance_method قسم الدالة append في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف:Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تُضيف الدالة append() قيمة محدَّدة إلى قائمةٍ ما.
ما لم يُمرَّر المعامل $separator، فستستعمل المسافة البيضاء لفصل عناصر القائمة التي ستُعيدها الدالة إن كانت القائمة أحاديةً.
تعيد الدالة ()append، مثل بقيَّة دوال القوائم، قائمة جديدةً بدلًا من تغييرها موضعيًا.
البنية العامة
append($list, $val, $separator: auto)
المعاملات
$list
القائمة التي ستُجرى عليها العمليَّة.
val$
القيمة التي ستُضاف إلى القائمة.
$separator
الفاصلة المُستخدمة لفصل عناصر القائمة. إن كانت فاصلةً أو مسافةً، فستُستخدم تلك القيمة الممرّرة. أما إن كانت قيمتها auto (القيمة الافتراضيَّة)، فسيُحدَّد الفاصل كما شرحنا سابقًا.
القيم المعادة
تُعاد القائمة $list بعد إضافة العنصر $val إليها.
أمثلة
مثال عن استخدام الدالة append() لضبط قيمة الحواشي (padding):
.selector {
padding: append((10px 20px), 30px); // 10px 20px 30px
}
سيُصرّف المثال السابق إلى شيفرة CSS الآتية:
.selector {
padding: 10px 20px 30px; }