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

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

مصادر

قسم الدالة keywords في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <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>.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-keywords($map)
+keywords($args)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$map</code> ===
+=== <code>‎$args</code> ===
-قاموس.
+قائمة متغيرة من الوسائط.
 == القيم المعادة ==
-قائمة مكونةً من مفاتيح القاموس، ومفصولةً بفواصل.
+تُعاد خريطة تحتوي على الوسائط المسماة المُمرّرة إلى [[Sass/function directives|الدالة]] أو [[Sass/mixins|المخلوط]] آنذاك.
 == الأخطاء والاستثناءات ==
-سيُرمى الخطأ <code>ArgumentError</code> إن كان لم يكن المعامل <code>‎$map</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">
-map-keys(("foo": 1, "bar": 2)) => "foo", "bar"
+@mixin foo($args...) {
+	@debug keywords($args); // (arg1: val, arg2: val)
+}
+@include foo($arg1: val, $arg2: val);
 </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}}]]