الفرق بين المراجعتين ل"Sass/set"
< Sass
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>()set</code> في Sass}}</noinclude> الدالة <code>()set</code> مرجعًا إلى دالة من أجل استدع...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()set</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()set</code> في Sass}}</noinclude> | ||
− | الدالة <code>()set</code> | + | تعيد الدالة <code>()set</code> قائمة جديدة ، بناءً على القائمة المقدمة، ولكن مع استبدال العنصر رقم <code>$n</code> بالقيمة المعطاة. |
− | + | لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في <nowiki/>[[Sass]] هو <code>1</code>، والثاني رقمه <code>2</code>، وهكذا. | |
+ | |||
+ | تعالَج قيم الفهرس <code>$n</code> السالبة بترتيب عكسي، بدءًا من آخر عنصر في القائمة. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="sass"> | <syntaxhighlight lang="sass"> | ||
− | set($ | + | set($list, $n, $value) |
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
− | === <code>$ | + | === <code>$list</code> === |
− | + | القائمة التي ستُسخ، ويُغيّر العنصر فيها رقم <code>$n</code>. | |
+ | |||
+ | === <code>$n</code> === | ||
+ | رقم العنصر الذي سيُعيّن. إن كان سالبًا فسيُحسب من نهاية القائمة. | ||
− | === <code>$ | + | === <code>$value </code> === |
− | + | القيمة الجديدة للعنصر رقم <code>$n</code>. | |
== القيم المعادة == | == القيم المعادة == | ||
مرجع دالة. | مرجع دالة. | ||
+ | |||
+ | == الأخطاء والاستثناءات == | ||
+ | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن <code>$n</code> عددًا صحيحا بين <code>1</code> و طول القائمة <code>$list</code>. | ||
== أمثلة == | == أمثلة == | ||
− | مثال عن استخدام | + | مثال عن استخدام الدالة <code>set()</code> لضبط قيمة الحواشي (<code>[[CSS/padding|padding]]</code>):<syntaxhighlight lang="sass"> |
− | + | .selector { | |
− | + | padding: set-nth($list: 10px 20px 30px 30px, $n: 2, $value: 15px) // 10px 15px 30px 30px | |
− | + | } | |
− | + | </syntaxhighlight>سيُصرّف المثال السابق إلى شيفرة <code>[[CSS]]</code> الآتية:<syntaxhighlight lang="css"> | |
+ | .selector { | ||
+ | padding: 10px 15px 30px 30px; | ||
+ | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[Sass/ | + | * لدالة <code>[[Sass/nth|nth()]]</code>: تعيد العنصر رقم n في قائمة. |
+ | * الدالة <code>[[Sass/index|index()]]</code>: تعيد رقم عنصر في قائمة. | ||
== مصادر == | == مصادر == |
مراجعة 16:17، 22 أبريل 2018
تعيد الدالة ()set
قائمة جديدة ، بناءً على القائمة المقدمة، ولكن مع استبدال العنصر رقم $n
بالقيمة المعطاة.
لاحظ أنه على عكس بعض اللغات، فإنّ رقم الحرف الأول في Sass هو 1
، والثاني رقمه 2
، وهكذا.
تعالَج قيم الفهرس $n
السالبة بترتيب عكسي، بدءًا من آخر عنصر في القائمة.
البنية العامة
set($list, $n, $value)
المعاملات
$list
القائمة التي ستُسخ، ويُغيّر العنصر فيها رقم $n
.
$n
رقم العنصر الذي سيُعيّن. إن كان سالبًا فسيُحسب من نهاية القائمة.
$value
القيمة الجديدة للعنصر رقم $n
.
القيم المعادة
مرجع دالة.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError
إن لم يكن $n
عددًا صحيحا بين 1
و طول القائمة $list
.
أمثلة
مثال عن استخدام الدالة set()
لضبط قيمة الحواشي (padding
):
.selector {
padding: set-nth($list: 10px 20px 30px 30px, $n: 2, $value: 15px) // 10px 15px 30px 30px
}
سيُصرّف المثال السابق إلى شيفرة CSS
الآتية:
.selector {
padding: 10px 15px 30px 30px;
}