الفرق بين المراجعتين لصفحة: «Sass/keywords»
< Sass
لا ملخص تعديل |
ط استبدال النص - 'توثيق Sass الرسمي.]' ب'توثيق Sass الرسمي].' |
||
| (7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>()keywords</code> في Sass}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>()keywords</code> في Sass}}</noinclude> | ||
تعيد الدالة <code>keywords()</code> | تعيد الدالة <code>keywords()</code> [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|خريطة]] (map) تحتوي على [[Sass/SassScript#.D8.A7.D9.84.D9.88.D8.B3.D8.A7.D8.A6.D8.B7 .D8.A7.D9.84.D9.85.D8.B3.D9.85.D9.91.D8.A7.D8.A9 .28Keyword Arguments.29|الوسائط المسماة]] المُمرّرة إلى [[Sass/function directives|دالة]] أو [[Sass/mixins|مخلوط]] (mixin)، والذي يتطلب تمرير قائمة متغيرةً من الوسائط. أسماء الوسائط هي سلاسل نصيةٌ ولا تحتوي على البادئة <code>$</code>. | ||
. | |||
== البنية العامة == | == البنية العامة == | ||
| سطر 15: | سطر 13: | ||
== القيم المعادة == | == القيم المعادة == | ||
تُعاد خريطة تحتوي على الوسائط المسماة المُمرّرة إلى [[Sass/function directives|الدالة]] أو [[Sass/mixins|المخلوط]] آنذاك. | |||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
سيُرمى الخطأ <code>ArgumentError</code> إن | سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>$args</code> قائمةً متغيرة من الوسائط. | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>keywords()</code>:<syntaxhighlight> | مثال عن استخدام الدالة <code>keywords()</code> مع قاعدة <code>[[Sass/@ rules#.E2.80.8E.40debug|@debug]]</code>:<syntaxhighlight lang="sass"> | ||
@mixin foo($args...) { | @mixin foo($args...) { | ||
@debug keywords($args); // (arg1: val, arg2: val) | |||
} | } | ||
@include foo($arg1: val, $arg2: val); | @include foo($arg1: val, $arg2: val); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة <code>[[Sass/map merge|map_merge()]]</code>: تدمج | * الدالة <code>[[Sass/map merge|map_merge()]]</code>: تدمج خريطتين في خريطة واحدة. | ||
* الدالة <code>[[Sass/map remove|map_remove()]]</code>: | * الدالة <code>[[Sass/map remove|map_remove()]]</code>: تعيد خريطة الممرَّرة بعد حذف مفاتيح معينة منها. | ||
* الدالة <code>[[Sass/map values|map_values()]]</code>: | * الدالة <code>[[Sass/map values|map_values()]]</code>: تعيد خريطة تحتوي على قيم تلك الخريطة فقط. | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#keywords-instance_method قسم الدالة keywords في صفحة الدوال في توثيق Sass الرسمي. | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#keywords-instance_method قسم الدالة keywords في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:01، 20 مايو 2018
تعيد الدالة keywords() خريطة (map) تحتوي على الوسائط المسماة المُمرّرة إلى دالة أو مخلوط (mixin)، والذي يتطلب تمرير قائمة متغيرةً من الوسائط. أسماء الوسائط هي سلاسل نصيةٌ ولا تحتوي على البادئة $.
البنية العامة
keywords($args)
المعاملات
$args
قائمة متغيرة من الوسائط.
القيم المعادة
تُعاد خريطة تحتوي على الوسائط المسماة المُمرّرة إلى الدالة أو المخلوط آنذاك.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن لم يكن المعامل $args قائمةً متغيرة من الوسائط.
أمثلة
مثال عن استخدام الدالة keywords() مع قاعدة @debug:
@mixin foo($args...) {
@debug keywords($args); // (arg1: val, arg2: val)
}
@include foo($arg1: val, $arg2: val);
انظر أيضًا
- الدالة
map_merge(): تدمج خريطتين في خريطة واحدة.
- الدالة
map_remove(): تعيد خريطة الممرَّرة بعد حذف مفاتيح معينة منها. - الدالة
map_values(): تعيد خريطة تحتوي على قيم تلك الخريطة فقط.