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

المراجعة الحالية بتاريخ 07:01، 20 مايو 2018

تعيد الدالة ()get_function مرجعًا إلى دالة من أجل استدعائها لاحقًا باستخدام الدالة ()call.

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

get_function($name, $css: false)

المعاملات

`‎$name`

اسم الدالة المراد الحصول على مرجع لها.

`‎$css`

يحدِّد هذا المعامل ما إذا كانت ستُعاد دالة خاصة بلغة CSS. إن كانت قيمة هذا المعامل هي FALSE، فقد يُشير مرجع الدالة إلى دالةٍ معرّفة في ملف الأنماط أو مضمَّنة في بيئة المضيف؛ وإن كانت قيمته TRUE، فسيشير إلى دالة خاصة بلغة CSS.

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

يُعاد مرجعٌ للدالة ذات الاسم ‎$name.

أمثلة

مثال عن استخدام الدالة get_function()‎. للحصول على مرجعية لدالة معرّفة من قبل المستخدم وذلك تبعًا لقيمة متغيرٍ ما (باستخدام التعليمة ‎@if):

$length-type: "absolute"; // هل نريد طولًا مطلقًا أم نسبيًا؟


@function absolute($arg) { @return "#{$arg * 16}px"; } // إعادة طول مطلق
@function relative($arg) { @return "#{$arg}em"; } // إعادة طول نسبي

$length: none;
@if $length-type == "absolute" {
  $length: get_function("absolute"); // الحصول على مرجعية للدالة
} @else {
  $length: get_function("relative"); // الحصول على مرجعية للدالة
}

.selector {
  padding: call($length, 1.5); // 24px
}

ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:

.selector {
  padding: "24px"; }

انظر أيضًا

الدالة call()‎: تستدعي دالة بشكل ديناميكي.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()‎get_function</code> في Sass}}</noinclude>
-الدالة <code>()get_function</code> تستدعي دالة بشكل ديناميكي، سواء كانت الدالة مُعرّفة من قبل المستخدم أو كانت مُضمّنةً أو دالة [[CSS]]. ينبغي تمرير كل الوسائط، بما فيها الوسائط المُسمّاة (keyword arguments) للدالة المُستدعاة.
+تعيد الدالة <code>()get_function</code> مرجعًا إلى دالة من أجل استدعائها لاحقًا باستخدام الدالة <code>[[Sass/call|()call]]</code>.
 == البنية العامة ==
 <syntaxhighlight lang="sass">
-get_function($function, $args...)
+get_function($name, $css: false)
 </syntaxhighlight>
 == المعاملات ==
-=== <code>‎$function</code> ===
+=== <code>‎$name</code> ===
-الدالة التي ترغب في استدعائها.
+اسم الدالة المراد الحصول على مرجع لها.
-=== <code>‎$args</code> ===
+=== <code>‎$css</code> ===
-الوسائط التي ستُمرّر إلى الدالة المُستدعاة.
+يحدِّد هذا المعامل ما إذا كانت ستُعاد دالة خاصة بلغة [[CSS]]. إن كانت قيمة هذا المعامل هي <code>FALSE</code>، فقد يُشير مرجع الدالة إلى دالةٍ معرّفة في ملف الأنماط أو مضمَّنة في بيئة المضيف؛ وإن كانت قيمته <code>TRUE</code>، فسيشير إلى دالة خاصة بلغة [[CSS]].
+== القيم المعادة ==
+يُعاد مرجعٌ للدالة ذات الاسم <code>‎$name</code>.
 == أمثلة ==
-مثال عن استخدام الدالة <code>get_function()‎</code> لضبط قيمة اللون (<code>[[CSS/color|color]]</code>):<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>get_function()‎</code>. للحصول على مرجعية لدالة معرّفة من قبل المستخدم وذلك تبعًا لقيمة [[Sass/SassScript#.D8.A7.D9.84.D9.85.D8.AA.D8.BA.D9.8A.D8.B1.D8.A7.D8.AA: .24|متغيرٍ]] ما (باستخدام التعليمة <code>[[Sass/control directives#.E2.80.8E.40if|‎@if]]</code>):<syntaxhighlight lang="sass">
-.selector {
+$length-type: "absolute"; // هل نريد طولًا مطلقًا أم نسبيًا؟
-   color: call(rgb, 10, 100, 255); // #0a64ff
+@function absolute($arg) { @return "#{$arg * 16}px"; } // إعادة طول مطلق
+@function relative($arg) { @return "#{$arg}em"; } // إعادة طول نسبي
+$length: none;
+@if $length-type == "absolute" {
+  $length: get_function("absolute"); // الحصول على مرجعية للدالة
+} @else {
+  $length: get_function("relative"); // الحصول على مرجعية للدالة
 }
-</syntaxhighlight>
-سيُصرّف المثال السابق إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
 .selector {
-   color: #0a64ff;
+  padding: call($length, 1.5); // 24px
 }
+</syntaxhighlight>ستُصرّف الشيفرة السابقة إلى شيفرة CSS الآتية:<syntaxhighlight lang="css">
+.selector {
+  padding: "24px"; }
+</syntaxhighlight>
-</syntaxhighlight>
+== انظر أيضًا ==
+* الدالة <code>[[Sass/call|call()]]</code>‎: تستدعي دالة بشكل ديناميكي.
 == مصادر ==
-* [https://sass-lang.com/documentation/Sass/Script/Functions.html#get_function-instance_method قسم الدالة get_function في صفحة الدوال في توثيق Sass الرسمي.]
+* [https://sass-lang.com/documentation/Sass/Script/Functions.html#get_function-instance_method قسم الدالة get_function في صفحة الدوال في توثيق Sass الرسمي].
-[[تصنيف:Sass]]
+[[تصنيف:Sass|{{SUBPAGENAME}}]]
-[[تصنيف: Sass Function]]
+[[تصنيف: Sass Function|{{SUBPAGENAME}}]]