الفرق بين المراجعتين لصفحة: «Sass/keywords»

من موسوعة حسوب
طلا ملخص تعديل
طلا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>()keywords</code> في Sass}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>()keywords</code> في Sass}}</noinclude>
تعيد الدالة <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>.
تعيد الدالة <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>.


== البنية العامة ==
== البنية العامة ==
سطر 19: سطر 19:


== أمثلة ==
== أمثلة ==
المثال 1: استخدام الدالة <code>keywords()‎</code> مع قاعدة ‎<code>[[Sass/@ rules#.E2.80.8E.40debug|@debug]]</code>.<syntaxhighlight lang="sass">
مثال عن استخدام الدالة <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)

مراجعة 14:37، 13 مايو 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()‎: تعيد خريطة تحتوي على قيم تلك الخريطة فقط.

مصادر