الفرق بين المراجعتين ل"Sass/keywords"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق الصفحة.)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()keywords</code> في Sass}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>()keywords</code> في Sass}}</noinclude>
تعيد الدالة <code>keywords()‎</code> قاموسًا من الوسائط المسماة المُمرّرة إلى [[Sass/function directives|دالة]] أو [[Sass/mixins|مخلوط]] (mixin) والذي يأخذ قائمة متغيرةً من الوسائط. اسماء الوسائط هي سلاسل نصيةٌ، ولا تحتوي على البادئة <code>$</code>.
+
تعيد الدالة <code>keywords()‎</code> [[Sass/SassScript#.D8.A7.D9.84.D8.AE.D8.B1.D8.A7.D8.A6.D8.B7 .28Maps.29|خريطة]] (map) تحتوي على الوسائط المسماة المُمرّرة إلى [[Sass/function directives|دالة]] أو [[Sass/mixins|مخلوط]] (mixin)، والذي يتطلب تمرير قائمة متغيرةً من الوسائط. أسماء الوسائط هي سلاسل نصيةٌ ولا تحتوي على البادئة <code>$</code>.
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 13: سطر 13:
  
 
== القيم المعادة ==
 
== القيم المعادة ==
قائمة مكونةً من  الوسائط المسماة المُمرّرة إلى [[Sass/function directives|الدالة]] أو [[Sass/mixins|المخلوط]].
+
تُعاد خريطة تحتوي على الوسائط المسماة المُمرّرة إلى [[Sass/function directives|الدالة]] أو [[Sass/mixins|المخلوط]] آنذاك.
  
 
== الأخطاء والاستثناءات ==
 
== الأخطاء والاستثناءات ==
سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$args</code> قائمةً متغيرة من الوسائط.
+
سيُرمى الخطأ <code>ArgumentError</code> إن لم يكن المعامل <code>‎$args</code> قائمةً متغيرة من الوسائط.
  
 
== أمثلة ==
 
== أمثلة ==
مثال عن استخدام الدالة <code>keywords()‎</code> مع قاعدة ‎<code>[[Sass/@ rules#.E2.80.8E.40debug|@debug]]</code>:<syntaxhighlight lang="sass">
+
المثال 1: استخدام الدالة <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)
 
   @debug keywords($args); // (arg1: val, arg2: val)
سطر 27: سطر 27:
 
</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>‎: تُعيد خريطة تحتوي على قيم تلك الخريطة فقط.
  
 
== مصادر ==
 
== مصادر ==

مراجعة 11:40، 3 مايو 2018

تعيد الدالة keywords()‎ خريطة (map) تحتوي على الوسائط المسماة المُمرّرة إلى دالة أو مخلوط (mixin)، والذي يتطلب تمرير قائمة متغيرةً من الوسائط. أسماء الوسائط هي سلاسل نصيةٌ ولا تحتوي على البادئة $.

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

keywords($args)

المعاملات

‎$args

قائمة متغيرة من الوسائط.

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

تُعاد خريطة تحتوي على الوسائط المسماة المُمرّرة إلى الدالة أو المخلوط آنذاك.

الأخطاء والاستثناءات

سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$args قائمةً متغيرة من الوسائط.

أمثلة

المثال 1: استخدام الدالة keywords()‎ مع قاعدة ‎@debug.

@mixin foo($args...) {
  @debug keywords($args); // (arg1: val, arg2: val)
}

@include foo($arg1: val, $arg2: val);

انظر أيضًا

  • الدالة map_merge()‎: تدمج خريطتين في خريطة واحدة.
  • الدالة map_remove()‎: تعيد خريطة الممرَّرة بعد حذف مفاتيح معينة منها.
  • الدالة map_values()‎: تُعيد خريطة تحتوي على قيم تلك الخريطة فقط.

مصادر